Jaringan dan akses jarak jauh

Perintah curl

Kirim permintaan HTTP dan unduh data

Linux · Contoh Bash · perintah dijalankan pada server yang dipilih

Kapan menggunakan curl

Gunakan curl untuk memeriksa respons HTTP, mengunduh sumber daya, atau memanggil API dari server. Pisahkan keberhasilan transportasi dari keberhasilan aplikasi, tetapkan batas waktu yang masuk akal dan jauhkan token autentikasi dari contoh perintah yang disimpan.

Sintaks

curl [PARAMETERS] URL

Tanda kurung siku menandai argumen opsional; elipsis berarti pengulangan. Ganti contoh nama file, nama pengguna, dan alamat server dengan nilai Anda sendiri.

Pilihan dan argumen umum

-I
Minta header HTTP saja, menggunakan metode HEAD.
-f
Menampilkan kesalahan untuk kode status HTTP 400 ke atas.
-L
Ikuti pengalihan; -o menentukan file hasil.

Contoh penggunaan

Periksa header situs

curl -I https://example.com

Permintaan hanya header dibuat; beberapa layanan menangani hal ini secara berbeda dari permintaan konten normal.

Unduh file dengan pemrosesan kesalahan HTTP

curl --fail --location --output ./page.html https://example.com

Pengalihan diikuti dan badan respons menggantikan file lokal bernama; Status kesalahan HTTP menyebabkan kegagalan.

Minta JSON dengan batas waktu

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

Respons JSON diminta dengan durasi keseluruhan yang dibatasi; titik akhir harus benar-benar menyediakan API tersebut.

Catatan dan batasan

  • Dengan HTTPS sertifikat diverifikasi secara default; jangan nonaktifkan pengecekan melalui -k tanpa alasan tersendiri.
  • Jangan letakkan token atau kata sandi asli dalam riwayat perintah dan jangan jalankan skrip yang diunduh tanpa verifikasi.

Pertanyaan umum dan pemecahan masalah

Mengapa curl berhasil ketika server mengembalikan halaman kesalahan?

Tanpa opsi kegagalan, menerima respons kesalahan HTTP masih dapat dihitung sebagai transfer berhasil. Periksa status HTTP dan status keluar perintah.

Haruskah saya menonaktifkan verifikasi sertifikat untuk memperbaiki HTTPS?

Jangan mengabaikan kepercayaan sebagai perbaikan rutin. Periksa nama host, waktu sistem, rantai sertifikat server, dan konfigurasi CA tepercaya.

Bantuan lebih lanjut

Pilihan bervariasi berdasarkan versi dan distribusi. Periksa dokumentasi yang diinstal dengan perintah ini: man curl.