Cờ curlExplained

54 of 54 rows

Cờ↕	Công dụng↕	Ví dụ↕
Hình dạng yêu cầu
⤢-X, --request	Đặt phương thức HTTP.	curl -X POST https://api.test
⤢-H, --header	Thêm một header cho yêu cầu.	curl -H "Accept: application/json" URL
⤢-d, --data	Gửi body (tự đặt POST và content type mặc định).	curl -d "name=Ada" URL
⤢-G, --get	Nối các giá trị -d vào chuỗi truy vấn của một GET.	curl -G -d "q=hi" URL
⤢-F, --form	Gửi dữ liệu biểu mẫu multipart (tải tệp lên).	curl -F "file=@photo.png" URL
⤢--data-urlencode	Gửi dữ liệu biểu mẫu đã được mã hóa URL.	curl --data-urlencode "name=Ada Lovelace" URL
⤢-T, --upload-file	Tải tệp lên bằng PUT.	curl -T big.zip URL
⤢-a, --append	Nối nội dung tải lên vào tệp từ xa thay vì thay thế nó.	curl -a -T log.txt ftp://server.test/logs/log.txt
JSON và API
⤢-H + -d	Gửi JSON với content type đúng.	curl -H "Content-Type: application/json" -d '{"a":1}' URL
⤢-d @file	Gửi nội dung một tệp làm body.	curl -d @body.json URL
⤢--json	Gửi JSON không cần tự đặt header (curl 7.82+).	curl --json '{"a":1}' URL
Xác thực
⤢-u, --user	Xác thực HTTP Basic với tên người dùng và mật khẩu.	curl -u ada:s3cr3t URL
⤢--oauth2-bearer	Gửi token bearer OAuth.	curl --oauth2-bearer TOKEN URL
⤢-H Authorization	Tự tay gửi bất kỳ scheme token nào.	curl -H "Authorization: Bearer TOKEN" URL
⤢-E, --cert + --key	Trình bày chứng chỉ client và khóa của nó cho mutual TLS.	curl --cert client.pem --key key.pem URL
⤢--cacert	Xác minh máy chủ với một tệp bundle CA.	curl --cacert ca.pem URL
⤢--capath	Xác minh máy chủ với một thư mục chứa các CA.	curl --capath /etc/ssl/certs URL
⤢-x, --proxy	Gửi yêu cầu qua proxy.	curl -x http://proxy.test:8080 URL
⤢--proxy-insecure	Bỏ qua xác minh TLS chỉ cho chặng tới proxy.	curl -x https://proxy.test:8443 --proxy-insecure URL
⤢--tlsv1.3	Yêu cầu TLS 1.3 làm phiên bản tối thiểu.	curl --tlsv1.3 URL
Danh tính
⤢-A, --user-agent	Gửi chuỗi User-Agent tùy chỉnh.	curl -A "Mozilla/5.0" URL
⤢-e, --referer	Gửi header Referer.	curl -e https://example.com/page URL
⤢-b, --cookie	Gửi cookie cùng yêu cầu.	curl -b "session=abc123" URL
⤢-c, --cookie-jar	Lưu cookie của phản hồi vào tệp.	curl -c cookies.txt URL
Đầu ra
⤢-o, --output	Ghi body vào tệp.	curl -o page.html URL
⤢-O	Lưu body dùng tên tệp từ xa.	curl -O https://site/file.tgz
⤢-i, --include	In header phản hồi phía trên body.	curl -i URL
⤢-I, --head	Chỉ lấy header (gửi HEAD).	curl -I URL
⤢-s, --silent	Ẩn thanh tiến trình và thông báo lỗi.	curl -s URL
⤢-w, --write-out	In chuỗi định dạng sau body (thời gian, mã trạng thái).	curl -w "%{http_code}\n" -o /dev/null URL
⤢-f, --fail	Thoát khác 0 khi lỗi HTTP và bỏ qua body lỗi.	curl -f URL
⤢--fail-with-body	Thoát khác 0 khi lỗi HTTP nhưng vẫn in body.	curl --fail-with-body URL
⤢-J, --remote-header-name	Đặt tên tệp đã lưu theo header Content-Disposition.	curl -OJ URL
⤢-C, --continue-at	Tiếp tục truyền bị gián đoạn từ chỗ dừng.	curl -C - -O URL
⤢-#, --progress-bar	Hiện thanh tiến trình thay cho bộ đo mặc định.	curl -# -O URL
⤢-S, --show-error	In lỗi kể cả khi chạy im lặng.	curl -sS URL
⤢-D, --dump-header	Ghi header phản hồi vào tệp.	curl -D headers.txt URL
⤢--compressed	Yêu cầu phản hồi nén và tự giải mã.	curl --compressed URL
⤢--create-dirs	Tạo các thư mục còn thiếu trong đường dẫn -o.	curl -o cache/api/data.json --create-dirs URL
Redirect và kết nối
⤢-L, --location	Theo các redirect 3xx.	curl -L URL
⤢--connect-timeout	Số giây tối đa chờ kết nối TCP.	curl --connect-timeout 5 URL
⤢--max-time	Số giây tối đa cho toàn bộ yêu cầu.	curl --max-time 30 URL
⤢-k, --insecure	Bỏ qua xác minh chứng chỉ TLS.	curl -k https://self-signed.test
⤢--retry	Thử lại lỗi tạm thời tối đa N lần.	curl --retry 3 URL
⤢--retry-all-errors	Thử lại với mọi lỗi, không chỉ lỗi tạm thời.	curl --retry 3 --retry-all-errors URL
⤢-4 / -6	Ép kết nối qua IPv4 hoặc IPv6.	curl -4 URL
⤢--resolve	Ánh xạ host và cổng tới một địa chỉ, bỏ qua DNS.	curl --resolve api.test:443:127.0.0.1 https://api.test
⤢--interface	Gắn việc truyền vào một giao diện mạng hoặc địa chỉ.	curl --interface eth0 URL
⤢-Z, --parallel	Truyền nhiều URL cùng lúc.	curl -Z URL1 URL2
⤢--http2 / --http3	Dùng HTTP/2 hoặc HTTP/3 cho việc truyền.	curl --http3 URL
⤢-N, --no-buffer	In body theo từng phần khi đến thay vì đệm.	curl -N URL
⤢-K, --config	Đọc thêm cờ từ tệp cấu hình.	curl -K flags.cfg URL
Gỡ lỗi
⤢-v, --verbose	In toàn bộ quá trình trao đổi yêu cầu và phản hồi.	curl -v URL
⤢--trace	Hex-dump mọi thứ gửi và nhận.	curl --trace - URL