Rangkaian dan akses jauh

Perintah curl

Hantar permintaan HTTP dan muat turun data

Linux · contoh Bash · arahan dijalankan pada pelayan yang dipilih

Bila hendak menggunakan curl

Gunakan curl untuk memeriksa respons HTTP, memuat turun sumber atau memanggil API daripada pelayan. Asingkan kejayaan pengangkutan daripada kejayaan aplikasi, tetapkan tamat masa yang wajar dan simpan token pengesahan daripada contoh arahan yang disimpan.

Sintaks

curl [PARAMETERS] URL

Tanda kurung persegi menandakan hujah pilihan; elipsis bermaksud pengulangan. Gantikan nama fail contoh, nama pengguna dan alamat pelayan dengan nilai anda sendiri.

Pilihan dan hujah biasa

-I
Minta pengepala HTTP sahaja, menggunakan kaedah HEAD.
-f
Kembalikan ralat untuk kod status HTTP 400 dan ke atas.
-L
Ikuti ubah hala; -o menentukan fail hasil.

Contoh penggunaan

Semak pengepala tapak

curl -I https://example.com

Permintaan pengepala sahaja dibuat; sesetengah perkhidmatan mengendalikan ini secara berbeza daripada permintaan kandungan biasa.

Muat turun fail dengan pemprosesan ralat HTTP

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

Ubah hala diikuti dan badan respons menggantikan fail tempatan yang dinamakan; Status ralat HTTP menyebabkan kegagalan.

Minta JSON dengan had masa

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

Respons JSON diminta dengan tempoh keseluruhan yang terhad; titik akhir mesti benar-benar menyediakan API itu.

Nota dan batasan

  • Dengan HTTPS sijil disahkan secara lalai; jangan lumpuhkan pemeriksaan melalui -k tanpa sebab yang berasingan.
  • Jangan letakkan token atau kata laluan sebenar dalam sejarah arahan dan jangan jalankan skrip yang dimuat turun tanpa pengesahan.

Soalan biasa dan penyelesaian masalah

Mengapakah curl berjaya apabila pelayan mengembalikan halaman ralat?

Tanpa pilihan kegagalan, menerima respons ralat HTTP masih boleh dikira sebagai pemindahan yang berjaya. Periksa status HTTP dan status keluar perintah.

Perlukah saya melumpuhkan pengesahan sijil untuk membetulkan HTTPS?

Jangan memintas kepercayaan sebagai pembaikan rutin. Semak nama hos, masa sistem, rantaian sijil pelayan dan konfigurasi CA yang dipercayai.

Bantuan selanjutnya

Pilihan berbeza mengikut versi dan pengedaran. Semak dokumentasi yang dipasang dengan arahan ini: man curl.