Belajar Curl - Download & Upload Files

#Pendahuluan

Di episode 6 kalian sudah mahir mengirim dan membaca JSON dari REST API — data terstruktur dalam bentuk teks. Tapi dunia nyata juga penuh dengan file mentah: binary installer, arsip log, backup database, dokumen PDF. Mengunduh dan mengunggah file adalah salah satu kegunaan paling awal sekaligus paling sering dari curl — jauh sebelum ia menjadi alat testing API. Episode ini akan membahas perintah download dan upload yang benar, beserta dua fitur yang menyelamatkan banyak orang: resume dan progress bar.

Inti dari episode ini sederhana: download dan upload adalah dua arah dari transfer yang sama. Keduanya hanya mengarahkan data dari URL ke file (download) atau dari file ke URL (upload). Perbedaannya terletak pada arah aliran data dan opsi yang dipakai.

#Mengunduh File: `-o` vs `-O`

curl tidak menyimpan hasil download ke file secara otomatis — secara default body respons ditulis ke stdout (layar). Untuk menyimpannya sebagai file, kalian butuh opsi output. Ada dua pilihan yang sekilas mirip tapi berbeda makna: -o dan -O.

curl -o setup.deb https://example.com/downloads/package.deb

-o setup.deb menyimpan file dengan nama yang kalian tentukan sendiri — bebas mau dinamai apa pun. Sedangkan -O (huruf besar) menyimpan dengan nama asli dari server: curl mengambil bagian terakhir dari URL sebagai nama file. Yang pertama cocok saat kalian ingin mengorganisir file ke nama tertentu; yang kedua pas untuk mengunduh banyak file tanpa perlu mengetik nama satu per satu. Bedanya setipis huruf besar dan kecil, tapi salah pilih berarti nama file yang tidak sesuai harapan.

Tip

Satu-satunya perbedaan antara -o dan -O adalah cara menentukan nama file tujuan: -o butuh nama eksplisit dari kalian, -O menebaknya dari URL. Aturan praktisnya — gunakan -O saat nama file di server sudah benar, gunakan -o saat kalian ingin menggantinya atau menghindari nama yang bermasalah.

#Mengunduh Banyak File: `--remote-name-all`

Saat mengunduh beberapa URL sekaligus, menulis -o untuk tiap URL merepotkan. Flag --remote-name-all membuat curl menerapkan perilaku -O (pakai nama asli) ke semua URL sekaligus:

remote-name-all.sh

curl --remote-name-all \
  https://example.com/downloads/app-v1.tar.gz \
  https://example.com/downloads/app-v2.tar.gz

Dengan satu flag, semua file tersimpan dengan nama asli dari server masing-masing. Ini sangat praktis saat kalian mengunduh sekumpulan artefak release atau file log dari beberapa URL sekaligus.

#Resume Download: `-C -`

Download file besar sering terputus di tengah jalan — jaringan putus, laptop tidur, atau koneksi tidak stabil. Mengulang dari nol berarti membuang-buang bandwidth. Flag -C - (continue) memberitahu curl untuk melanjutkan dari byte terakhir yang sudah terunduh:

resume.sh

curl -C - -O https://example.com/downloads/backup-2026.db

Tanda - setelah -C berarti "tentukan sendiri titik lanjutnya" — curl memeriksa ukuran file lokal yang sudah ada, lalu meminta server mengirim sisa data mulai dari offset tersebut. Server yang mendukung HTTP Range akan menjawab dengan kode 206 Partial Content. Jika file lokal ternyata sudah lengkap, curl akan memberi tahu bahwa tidak ada yang perlu diunduh lagi. Fitur inilah yang membuat download file raksasa terasa jauh lebih aman.

#Upload File: `-T`

Upload adalah arah kebalikan dari download. Flag -T (upload) mengirim isi file ke URL tujuan. Untuk URL HTTP dan HTTPS, curl mengirimnya sebagai request PUT:

upload-put.sh

curl -T build/app.jar https://files.example.com/release/app.jar

Kombinasi -T build/app.jar dengan URL tujuan di atas sudah cukup — tidak perlu menulis -X PUT, karena -T otomatis memilih method PUT untuk URL HTTP. Pola ini banyak dipakai untuk deploy artefak ke object storage (misalnya S3 via presigned URL), artifact registry, atau server WebDAV. Untuk upload yang lebih aman, gunakan SFTP atau FTP dengan kredensial seperti di bawah.

#Mengakses FTP dan SFTP

curl bukan hanya klien HTTP — ia juga klien FTP dan SFTP bawaan. URL dengan skema ftp:// dan sftp:// didukung langsung, dan autentikasi cukup lewat -u dengan format user:pass:

ftp-upload.sh

curl -u budi:rahasia -T laporan.pdf \
  ftp://files.example.com/reports/laporan.pdf

sftp-download.sh

curl -u budi:rahasia -O \
  sftp://files.example.com/backup/arsip-2026.tgz

Perbedaan penting yang harus diingat: FTP mengirim kredensial dan data dalam bentuk teks biasa (tidak terenkripsi), sehingga hanya aman di jaringan tepercaya. SFTP, sebaliknya, berjalan di atas SSH dan mengenkripsi seluruh komunikasi — inilah pilihan yang benar untuk file sensitif. Perhatikan juga bahwa untuk SFTP, path di URL adalah path absolut di server tujuan.

Warning

Jangan pernah menaruh kredensial user:pass langsung di command history untuk server produksi. Untuk FTP atau SFTP yang sering dipakai, gunakan file konfigurasi curl (akan dibahas di episode 8), atau pindah ke SSH key untuk SFTP — lebih aman dan tidak bocor lewat log shell.

#Progress Bar

Secara default, curl menampilkan progress meter dalam bentuk persentase yang sering tampil berantakan di terminal ketika dipakai dalam pipeline atau log. Flag --progress-bar menyederhanakannya menjadi satu baris progress yang bersih:

progress-bar.sh

curl --progress-bar -O https://example.com/downloads/package.deb

Keluaran berupa baris tanda # yang tumbuh mengikuti kemajuan download, lengkap dengan kecepatan transfer dan perkiraan sisa waktu. Untuk script yang mengunduh banyak file dan ingin log yang ringkas, --progress-bar jauh lebih ramah daripada meter default yang multibaris.

#Streaming ke stdout dan Pipeline

Tidak semua file harus disimpan dulu di disk. Karena curl menulis body ke stdout secara default, kalian bisa menyalurkannya langsung ke program lain — pola klasiknya adalah mengunduh arsip dan mengekstraknya tanpa file perantara:

stream-tar.sh

curl -sL https://example.com/releases/app.tar.gz | tar -xzf -

Pipeline ini mengunduh arsip dan langsung mengekstraknya dalam satu langkah — tanpa menyisakan file .tar.gz di disk. Ini menghemat ruang dan membuat script lebih ringkas. Pola yang sama berlaku untuk data lain: curl -s URL | jq dari episode 6, atau curl -s URL | sha256sum untuk memverifikasi checksum.

Tip

Saat streaming ke pipeline, jangan lupa -s untuk menekan progress meter — jika tidak, bar progress akan bercampur dengan output program yang kalian salurkan dan merusak data yang diteruskan. -L juga penting untuk mengikuti redirect, misalnya dari URL shortlink atau CDN.

#Penutup

Episode 7 melengkapi kalian dengan kemampuan transfer file: -o untuk nama kustom dan -O untuk nama asli server, --remote-name-all untuk banyak URL sekaligus, -C - untuk resume download yang terputus, -T untuk upload via PUT, akses FTP dan SFTP dengan -u, serta --progress-bar untuk umpan balik yang bersih.

Inti yang perlu diingat: download dan upload adalah dua sisi dari transfer yang sama, dan curl menangani keduanya dengan URL skema yang sama. Pahami kapan memakai -o versus -O, dan selalu pilih SFTP di atas FTP untuk data yang sensitif.

Di episode 8 berikutnya, kita akan membahas konfigurasi — bagaimana menyimpan opsi favorit di file konfigurasi ~/.curlrc, memakai --config untuk proyek tertentu, dan bagaimana curl membaca environment variable seperti proxy. Sampai jumpa!