Curl - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

curl - chuyển một URL

SYNOPSIS

quăn lại [tùy chọn] [URL ...]

MÔ TẢ

quăn lại là một công cụ để truyền dữ liệu từ hoặc đến máy chủ, sử dụng một trong các giao thức được hỗ trợ
(DICT, TẬP TIN, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP,
RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET và TFTP). Lệnh được thiết kế để hoạt động
mà không có sự tương tác của người dùng.

curl cung cấp một loạt các thủ thuật hữu ích như hỗ trợ proxy, xác thực người dùng, FTP
tải lên, bài đăng HTTP, kết nối SSL, cookie, tiếp tục truyền tệp, Metalink, v.v. Như
bạn sẽ thấy bên dưới, số lượng tính năng sẽ khiến bạn quay cuồng!

curl được cung cấp bởi libcurl cho tất cả các tính năng liên quan đến truyền. Nhìn thấy thư viện(3) để biết thêm chi tiết.

URL

Cú pháp URL phụ thuộc vào giao thức. Bạn sẽ tìm thấy mô tả chi tiết trong RFC 3986.

Bạn có thể chỉ định nhiều URL hoặc các phần của URL bằng cách viết các bộ phần trong dấu ngoặc nhọn như trong:

http://site. {một, hai, ba} .com

hoặc bạn có thể lấy chuỗi các chuỗi chữ và số bằng cách sử dụng [] như trong:

ftp://ftp.numericals.com/file[1-100] .txt

ftp://ftp.numericals.com/file[001-100] .txt (với các số XNUMX ở đầu)

ftp://ftp.letters.com/file[az] .txt

Các chuỗi lồng nhau không được hỗ trợ, nhưng bạn có thể sử dụng một số chuỗi bên cạnh nhau:

http://any.org/archive[1996-1999] / vol [1-4] / phần {a, b, c} .html

Bạn có thể chỉ định bất kỳ số lượng URL nào trên dòng lệnh. Chúng sẽ được tìm nạp trong một
cách tuần tự theo thứ tự đã định.

Bạn có thể chỉ định bộ đếm bước cho các phạm vi để nhận mọi số hoặc chữ cái thứ N:

http://www.numericals.com/file[1-100: 10] .txt

http://www.letters.com/file[az: 2] .txt

Khi sử dụng chuỗi [] hoặc {} khi được gọi từ dấu nhắc dòng lệnh, bạn có thể có
để đặt URL đầy đủ trong dấu ngoặc kép để tránh shell can thiệp vào nó. Cái này
cũng áp dụng cho các ký tự khác được coi là đặc biệt, chẳng hạn như '&', '?' và '*'.

Cung cấp chỉ mục vùng IPv6 trong URL với ký hiệu phần trăm thoát và giao diện
Tên. Giống như trong

http://[fe80::3%25eth0]/

Nếu bạn chỉ định URL mà không có tiền tố giao thức: //, curl sẽ cố gắng đoán giao thức nào
bạn có thể muốn. Sau đó, nó sẽ mặc định thành HTTP nhưng hãy thử các giao thức khác dựa trên
tiền tố tên máy chủ. Ví dụ: đối với tên máy chủ bắt đầu bằng "ftp". curl sẽ giả sử bạn
muốn nói FTP.

curl sẽ cố gắng hết sức để sử dụng những gì bạn chuyển tới nó dưới dạng URL. Nó không cố gắng xác thực nó
là một URL chính xác về mặt cú pháp bằng bất kỳ phương tiện nào nhưng thay vào đó là rất phóng khoáng với những gì nó
chấp nhận.

curl sẽ cố gắng sử dụng lại các kết nối cho nhiều lần truyền tệp, để nhận được nhiều
các tệp từ cùng một máy chủ sẽ không thực hiện nhiều lần kết nối / bắt tay. Điều này được cải thiện
tốc độ, vận tốc. Tất nhiên điều này chỉ được thực hiện trên các tệp được chỉ định trên một dòng lệnh duy nhất và không thể
được sử dụng giữa các lần gọi xoăn riêng biệt.

TIẾN ĐỘ KIM LOẠI

curl thường hiển thị đồng hồ đo tiến trình trong quá trình hoạt động, cho biết số lượng
dữ liệu đã truyền, tốc độ truyền và thời gian còn lại ước tính, v.v.

curl hiển thị dữ liệu này đến thiết bị đầu cuối theo mặc định, vì vậy nếu bạn gọi curl để thực hiện
hoạt động và nó sắp ghi dữ liệu vào thiết bị đầu cuối, nó vô hiệu hóa đồng hồ đo tiến độ như
nếu không nó sẽ làm rối tung đồng hồ đo tiến độ trộn đầu ra và dữ liệu phản hồi.

Nếu bạn muốn một bộ đo tiến trình cho các yêu cầu HTTP POST hoặc PUT, bạn cần chuyển hướng
phản hồi đầu ra cho một tệp, sử dụng chuyển hướng shell (>), -o [tệp] hoặc tương tự.

Trường hợp tải lên FTP không giống như vậy vì thao tác đó không tạo ra bất kỳ phản hồi nào
dữ liệu đến thiết bị đầu cuối.

Nếu bạn thích một "thanh" tiến trình thay vì đồng hồ thông thường, -# là bạn của bạn.

LỰA CHỌN

Các tùy chọn bắt đầu bằng một hoặc hai dấu gạch ngang. Nhiều tùy chọn yêu cầu một giá trị bổ sung tiếp theo
đối với họ.

Dạng "một dấu gạch ngang" ngắn của các tùy chọn, ví dụ -d, có thể được sử dụng cùng với hoặc không có
khoảng cách giữa nó và giá trị của nó, mặc dù một khoảng trắng là dấu phân cách được khuyến nghị. Dài
biểu mẫu "dấu gạch ngang", chẳng hạn như --data, yêu cầu khoảng cách giữa nó và giá trị của nó.

Các tùy chọn phiên bản ngắn không cần thêm bất kỳ giá trị nào có thể được sử dụng ngay sau đó
với nhau, chẳng hạn như bạn có thể chỉ định tất cả các tùy chọn -O, -L và -v cùng một lúc như
-OLv.

Nói chung, tất cả các tùy chọn boolean đều được bật với -tùy chọn và lại bị vô hiệu hóa với
--không-Lựa chọn. Đó là, bạn sử dụng cùng một tên tùy chọn nhưng đặt tiền tố bằng "no-".
Tuy nhiên, trong danh sách này, chúng tôi chủ yếu chỉ liệt kê và hiển thị phiên bản --option của chúng. (Cái này
khái niệm với - không có tùy chọn đã được thêm vào 7.19.0. Trước đây hầu hết các tùy chọn đều được bật / tắt
khi sử dụng lặp lại cùng một tùy chọn dòng lệnh.)

-#, --thanh tiến trình
Thực hiện tiến trình hiển thị cuộn tròn dưới dạng thanh tiến trình đơn giản thay vì thanh tiêu chuẩn, hơn thế nữa
thông tin, đồng hồ đo.

-:, --Kế tiếp
Yêu cầu curl sử dụng một thao tác riêng biệt cho URL sau và được liên kết
tùy chọn. Điều này cho phép bạn gửi một số yêu cầu URL, mỗi yêu cầu đều có
các tùy chọn, ví dụ, chẳng hạn như các tên người dùng khác nhau hoặc các yêu cầu tùy chỉnh cho mỗi.
(Đã thêm vào 7.36.0)

-0, --http1.0
(HTTP) Yêu cầu curl sử dụng phiên bản HTTP 1.0 thay vì sử dụng nội bộ
ưu tiên: HTTP 1.1.

--http1.1
(HTTP) Yêu cầu curl sử dụng phiên bản HTTP 1.1. Đây là phiên bản mặc định nội bộ.
(Đã thêm vào 7.33.0)

--http2
(HTTP) Yêu cầu curl đưa ra các yêu cầu của nó bằng cách sử dụng HTTP 2. Điều này yêu cầu rằng
libcurl cơ bản được xây dựng để hỗ trợ nó. (Đã thêm vào 7.33.0)

--không-npn
Tắt tiện ích NPN TLS. NPN được bật theo mặc định nếu libcurl được xây dựng với
một thư viện SSL hỗ trợ NPN. NPN được sử dụng bởi một libcurl hỗ trợ HTTP 2 để
thương lượng hỗ trợ HTTP 2 với máy chủ trong các phiên https.

(Đã thêm vào 7.36.0)

--no-alpn
Tắt tiện ích ALPN TLS. ALPN được bật theo mặc định nếu libcurl được xây dựng
với thư viện SSL hỗ trợ ALPN. ALPN được sử dụng bởi một libcurl hỗ trợ
HTTP 2 để thương lượng hỗ trợ HTTP 2 với máy chủ trong các phiên https.

(Đã thêm vào 7.36.0)

-1, --tlsv1
(SSL) Buộc sử dụng TLS phiên bản 1.x khi thương lượng với máy chủ TLS từ xa.
Bạn có thể sử dụng các tùy chọn --tlsv1.0, --tlsv1.1và --tlsv1.2 để kiểm soát phiên bản TLS
chính xác hơn (nếu chương trình phụ trợ SSL đang được sử dụng hỗ trợ mức độ kiểm soát như vậy).

-2, --sslv2
(SSL) Buộc sử dụng SSL phiên bản 2 khi thương lượng với máy chủ SSL từ xa.
Đôi khi curl được xây dựng mà không hỗ trợ SSLv2. SSLv2 được nhiều người coi là không an toàn
(xem RFC 6176).

-3, --sslv3
(SSL) Buộc sử dụng SSL phiên bản 3 khi thương lượng với máy chủ SSL từ xa.
Đôi khi curl được xây dựng mà không hỗ trợ SSLv3. SSLv3 được nhiều người coi là không an toàn
(xem RFC 7568).

-4, --ipv4
Tùy chọn này yêu cầu curl chỉ phân giải tên thành địa chỉ IPv4 và không phải ví dụ
thử IPv6.

-6, --ipv6
Tùy chọn này yêu cầu curl chỉ phân giải tên thành địa chỉ IPv6 và không phải ví dụ
thử IPv4.

-a, - append
(FTP / SFTP) Khi được sử dụng trong quá trình tải lên, điều này làm cho cuộn tròn thêm vào tệp đích
thay vì ghi đè nó. Nếu tệp từ xa không tồn tại, nó sẽ được tạo.
Lưu ý rằng cờ này bị một số máy chủ SFTP (bao gồm cả OpenSSH) bỏ qua.

-A, - tác nhân người dùng
(HTTP) Chỉ định chuỗi Tác nhân người dùng để gửi đến máy chủ HTTP. Một số làm không tốt
CGI không thành công nếu trường này không được đặt thành "Mozilla / 4.0". Để mã hóa khoảng trống trong chuỗi,
bao quanh chuỗi bằng các dấu ngoặc kép. Điều này cũng có thể được thiết lập với -NS,
--tiêu đề tất nhiên.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--anyauth
(HTTP) Yêu cầu curl tự tìm ra phương pháp xác thực và sử dụng tối đa
bảo mật một trong những trang web từ xa tuyên bố sẽ hỗ trợ. Điều này được thực hiện bằng cách thực hiện một yêu cầu đầu tiên
và kiểm tra các tiêu đề phản hồi, do đó có thể tạo ra một vòng mạng bổ sung-
chuyến đi chơi. Điều này được sử dụng thay vì đặt một phương thức xác thực cụ thể, mà bạn
có thể làm với --căn bản, --tiêu, --ntlmvà --đàm phán.

Lưu ý rằng việc sử dụng --anyauth không được khuyến khích nếu bạn tải lên từ stdin, vì nó
có thể yêu cầu dữ liệu được gửi hai lần và sau đó máy khách phải có thể tua lại. Nếu như
nhu cầu phát sinh khi tải lên từ stdin, hoạt động tải lên sẽ không thành công.

-b, - tân binh
(HTTP) Truyền dữ liệu đến máy chủ HTTP dưới dạng cookie. Nó được cho là dữ liệu
trước đó đã nhận được từ máy chủ trong dòng "Set-Cookie:". Dữ liệu phải ở
định dạng "NAME1 = VALUE1; NAME2 = VALUE2".

Nếu không có ký hiệu '=' nào được sử dụng trong dòng, nó được coi là tên tệp để sử dụng để đọc
các dòng cookie đã được lưu trữ trước đó, sẽ được sử dụng trong phiên này nếu chúng
trận đấu. Sử dụng phương pháp này cũng kích hoạt công cụ cookie sẽ làm cong
cũng ghi lại các cookie đến, điều này có thể hữu ích nếu bạn đang sử dụng kết hợp
với -L, --vị trí Lựa chọn. Định dạng tệp của tệp để đọc cookie từ
phải là tiêu đề HTTP thuần túy hoặc định dạng tệp cookie Netscape / Mozilla.

Tệp được chỉ định với -NS, --bánh quy chỉ được sử dụng làm đầu vào. Sẽ không có cookie
được ghi vào tệp. Để lưu trữ cookie, hãy sử dụng -NS, --cookie-jar tùy chọn.

Hãy thận trọng nếu bạn đang sử dụng tùy chọn này và nhiều lần chuyển tiền có thể xảy ra. Nếu như
bạn sử dụng NAME1 = VALUE1; hoặc trong một tệp sử dụng định dạng Set-Cookie và không
chỉ định một miền, sau đó cookie được gửi cho bất kỳ miền nào (ngay cả sau khi chuyển hướng
theo sau) và không thể sửa đổi bằng cookie do máy chủ đặt. Nếu công cụ cookie là
được kích hoạt và một máy chủ đặt một cookie có cùng tên, sau đó cả hai sẽ được gửi trên một
chuyển trong tương lai đến máy chủ đó, có thể không phải những gì bạn dự định. Để giải quyết những
vấn đề đặt miền trong Set-Cookie (làm điều đó sẽ bao gồm các miền phụ) hoặc sử dụng
Định dạng Netscape.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-B, --use-ascii
(FTP / LDAP) Bật truyền ASCII. Đối với FTP, điều này cũng có thể được thực thi bằng cách sử dụng
URL kết thúc bằng "; type = A". Tùy chọn này làm cho dữ liệu được gửi đến stdout ở dạng văn bản
chế độ cho hệ thống win32.

--căn bản
(HTTP) Yêu cầu curl sử dụng xác thực HTTP cơ bản với máy chủ từ xa. Đây là
mặc định và tùy chọn này thường vô nghĩa, trừ khi bạn sử dụng nó để ghi đè
trước đó đã đặt tùy chọn đặt một phương thức xác thực khác (chẳng hạn như --ntlm,
--tiêu, hoặc là --đàm phán).

Được sử dụng cùng với -bạn, --người sử dụng và -NS, --Ủy quyền.

Xem thêm --proxy-cơ bản.

-c, --cookie-jar
(HTTP) Chỉ định tệp bạn muốn curl ghi tất cả cookie sau khi hoàn thành
hoạt động. Curl ghi tất cả cookie đã đọc trước đó từ một tệp được chỉ định cũng như
tất cả cookie nhận được từ (các) máy chủ từ xa. Nếu không có cookie nào được xác định, sẽ không có dữ liệu nào
được viết. Tệp sẽ được ghi bằng định dạng tệp cookie Netscape. nếu bạn
đặt tên tệp thành một dấu gạch ngang duy nhất, "-", cookie sẽ được ghi vào stdout.

Tùy chọn dòng lệnh này sẽ kích hoạt công cụ cookie tạo bản ghi curl và
sử dụng cookie. Một cách khác để kích hoạt nó là sử dụng -NS, --bánh quy tùy chọn.

Nếu không thể tạo hoặc ghi vào lọ cookie, thì toàn bộ thao tác cuộn tròn sẽ không
không thành công hoặc thậm chí thông báo lỗi một cách rõ ràng. Sử dụng -v sẽ nhận được một cảnh báo được hiển thị, nhưng
đó là phản hồi hiển thị duy nhất bạn nhận được về tình huống có thể gây chết người này.

Kể từ 7.43.0 cookie được nhập ở định dạng Set-Cookie mà không có miền
tên không được xuất theo tùy chọn này.

Nếu tùy chọn này được sử dụng nhiều lần, tên tệp được chỉ định cuối cùng sẽ được sử dụng.

-C, - tiếp tục-tại
Tiếp tục / Tiếp tục quá trình truyền tệp trước đó tại khoảng chênh lệch nhất định. Phần bù đã cho là
số byte chính xác sẽ bị bỏ qua, tính từ đầu
tập tin nguồn trước khi nó được chuyển đến đích. Nếu được sử dụng với video tải lên,
Lệnh máy chủ FTP SIZE sẽ không được sử dụng bởi curl.

Sử dụng "-C -" để cho curl biết để tự động tìm ra vị trí / cách tiếp tục chuyển.
Sau đó, nó sử dụng các tệp đầu ra / đầu vào nhất định để tìm ra điều đó.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

- môn sinh
(SSL) Chỉ định mật mã nào sẽ sử dụng trong kết nối. Danh sách mật mã phải
chỉ định mật mã hợp lệ. Đọc chi tiết danh sách mật mã SSL trên URL này:
https://www.openssl.org/docs/apps/ciphers.html

Mật mã NSS được thực hiện khác với OpenSSL và GnuTLS. Danh sách đầy đủ của NSS
mật mã nằm trong mục nhập NSSCipherSuite tại URL này:
https://git.fedorahosted.org/cgit/mod_nss.git/plain/docs/mod_nss.html#Directives

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

- nén
(HTTP) Yêu cầu phản hồi nén bằng cách sử dụng một trong các thuật toán hỗ trợ curl, và
lưu tài liệu không nén. Nếu tùy chọn này được sử dụng và máy chủ gửi
mã hóa không được hỗ trợ, curl sẽ báo lỗi.

- hết thời gian kết nối
Thời gian tối đa tính bằng giây mà bạn cho phép thực hiện kết nối của curl. Điều này chỉ giới hạn
giai đoạn kết nối, vì vậy nếu curl kết nối trong khoảng thời gian nhất định, nó sẽ tiếp tục
- nếu không nó sẽ thoát ra. Kể từ phiên bản 7.32.0, tùy chọn này chấp nhận các giá trị thập phân.

Xem thêm -NS, - thời gian tối đa tùy chọn.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--tạo-thư mục
Khi được sử dụng cùng với -o tùy chọn, curl sẽ tạo cục bộ cần thiết
phân cấp thư mục khi cần thiết. Tùy chọn này tạo ra các dirs được đề cập với -o
tùy chọn, không có gì khác. Nếu -o tên tập tin không sử dụng dir hoặc nếu nó đề cập đến dirs
đã tồn tại, sẽ không có dir nào được tạo.

Để tạo thư mục từ xa khi sử dụng FTP hoặc SFTP, hãy thử --ftp-tạo-dirs.

--crlf Chuyển đổi LF sang CRLF khi tải lên. Hữu ích cho MVS (OS / 390).

(SMTP được thêm vào 7.40.0)

--crlfile
(HTTPS / FTPS) Cung cấp tệp sử dụng định dạng PEM với Danh sách thu hồi chứng chỉ
có thể chỉ định các chứng chỉ ngang hàng sẽ được coi là bị thu hồi.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

(Đã thêm vào 7.19.7)

-d, --data
(HTTP) Gửi dữ liệu được chỉ định trong một yêu cầu POST đến máy chủ HTTP, trong cùng một
cách mà trình duyệt thực hiện khi người dùng điền vào biểu mẫu HTML và nhấn
nút gửi. Điều này sẽ làm cho curl chuyển dữ liệu đến máy chủ bằng cách sử dụng
ứng dụng loại nội dung / x-www-form-urlencoded. So với -NS, --mẫu đơn.

-NS, --dữ liệu giống như --data-ascii. --data-thô gần giống nhau nhưng không
có cách giải thích đặc biệt về ký tự @. Để đăng dữ liệu hoàn toàn là hệ nhị phân, bạn
thay vào đó nên sử dụng --data-nhị phân Lựa chọn. Để mã hóa URL giá trị của một biểu mẫu
lĩnh vực bạn có thể sử dụng --data-urlencode.

Nếu bất kỳ tùy chọn nào trong số này được sử dụng nhiều lần trên cùng một dòng lệnh, dữ liệu
các phần được chỉ định sẽ được hợp nhất với nhau bằng dấu & -symbol ngăn cách. Do đó, sử dụng
'-d name = daniel -d skill = lousy' sẽ tạo ra một đoạn bài đăng trông giống như
'name = daniel & skill = tệ hại'.

Nếu bạn bắt đầu dữ liệu bằng ký tự @, phần còn lại phải là tên tệp để đọc
dữ liệu từ, hoặc - nếu bạn muốn curl đọc dữ liệu từ stdin. Nhiều tệp có thể
cũng được chỉ định. Do đó, việc đăng dữ liệu từ tệp có tên 'foobar' sẽ được thực hiện với
--dữ liệu @foobar. Khi --data được yêu cầu đọc từ một tệp như vậy, ký tự xuống dòng sẽ trả về
và các dòng mới sẽ bị loại bỏ. Nếu bạn không muốn ký tự @ có
sử dụng giải thích đặc biệt --data-thô thay thế.

-D, --dump-header
Ghi tiêu đề giao thức vào tệp được chỉ định.

Tùy chọn này rất hữu ích để sử dụng khi bạn muốn lưu trữ các tiêu đề của một trang web HTTP
gửi cho bạn. Cookie từ các tiêu đề sau đó có thể được đọc trong cuộn thứ hai
lời kêu gọi bằng cách sử dụng -NS, --bánh quy Lựa chọn! Các -NS, --cookie-jar lựa chọn là một
cách tốt hơn để lưu trữ cookie.

Khi được sử dụng trong FTP, các dòng phản hồi của máy chủ FTP được coi là "tiêu đề" và
do đó được lưu ở đó.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--data-ascii
Xem -NS, --dữ liệu.

--data-binary
(HTTP) Điều này đăng dữ liệu chính xác như được chỉ định mà không cần xử lý thêm.

Nếu bạn bắt đầu dữ liệu bằng ký tự @, phần còn lại phải là tên tệp. Dữ liệu là
được đăng theo cách tương tự như --data-ascii không, ngoại trừ dòng mới và ký tự xuống dòng
lợi nhuận được giữ nguyên và chuyển đổi không bao giờ được thực hiện.

Nếu tùy chọn này được sử dụng nhiều lần, các tùy chọn sau tùy chọn đầu tiên sẽ nối thêm dữ liệu
như được mô tả trong -NS, --dữ liệu.

--data-raw
(HTTP) Điều này đăng dữ liệu tương tự như --dữ liệu nhưng không có cách giải thích đặc biệt
của ký tự @. Nhìn thấy -NS, --dữ liệu. (Đã thêm vào 7.43.0)

--data-urlencode
(HTTP) Điều này đăng dữ liệu, tương tự như các tùy chọn --data khác, ngoại trừ
điều này thực hiện mã hóa URL. (Đã thêm vào 7.18.0)

Để tuân thủ CGI, phần nên bắt đầu bằng tên Theo sau là một
dấu phân cách và một đặc tả nội dung. Các một phần có thể được chuyển sang cuộn tròn bằng cách sử dụng
một trong các cú pháp sau:

nội dung
Điều này sẽ làm cho URL cuộn tròn mã hóa nội dung và chuyển nội dung đó. Chỉ cần cẩn thận
để nội dung không chứa bất kỳ ký hiệu = hoặc @ nào, vì sau đó sẽ
làm cho cú pháp khớp với một trong các trường hợp khác bên dưới!

= nội dung
Điều này sẽ làm cho URL cuộn tròn mã hóa nội dung và chuyển nội dung đó. Phần trước =
biểu tượng không được bao gồm trong dữ liệu.

tên = nội dung
Điều này sẽ làm cho URL cuộn tròn mã hóa phần nội dung và chuyển phần đó. Lưu ý rằng
phần tên dự kiến ​​đã được mã hóa URL.

@tên tệp
Điều này sẽ làm cho dữ liệu tải cuộn tròn từ tệp đã cho (bao gồm bất kỳ dòng mới nào),
Mã hóa URL đó và chuyển dữ liệu đó trong BÀI ĐĂNG.

name @ filename
Điều này sẽ làm cho dữ liệu tải cuộn tròn từ tệp đã cho (bao gồm bất kỳ dòng mới nào),
Mã hóa URL đó và chuyển dữ liệu đó trong BÀI ĐĂNG. Phần tên nhận được một phần bằng nhau
ký kết nối, dẫn đến name = urlencoded-file-content. Lưu ý rằng tên
dự kiến ​​đã được mã hóa URL.

--cấp ủy quyền
Thiết lập LEVEL để cho máy chủ biết nó được phép ủy quyền những gì khi nói đến người dùng
thông tin đăng nhập. Được sử dụng với GSS / kerberos.

không Không cho phép bất kỳ ủy quyền nào.

chính sách ủy quyền nếu và chỉ khi cờ OK-AS-DELEGATE được đặt trong Kerberos
vé dịch vụ, đó là một vấn đề của chính sách cảnh giới.

luôn cho phép máy chủ ủy quyền một cách vô điều kiện.

--tiêu
(HTTP) Cho phép xác thực Thông báo HTTP. Đây là một chương trình xác thực
ngăn không cho mật khẩu được gửi qua dây ở dạng văn bản rõ ràng. Sử dụng cái này trong
kết hợp với bình thường -bạn, --người sử dụng tùy chọn để đặt tên người dùng và mật khẩu. Nhìn thấy
Ngoài ra --ntlm, --đàm phán và --anyauth cho các tùy chọn liên quan.

Nếu tùy chọn này được sử dụng nhiều lần, chỉ tùy chọn đầu tiên được sử dụng.

--disable-eprt
(FTP) Yêu cầu curl tắt việc sử dụng các lệnh EPRT và LPRT khi đang hoạt động
Chuyển khoản FTP. Curl thường sẽ luôn cố gắng sử dụng EPRT trước, sau đó là LPRT
trước khi sử dụng PORT, nhưng với tùy chọn này, nó sẽ sử dụng PORT ngay lập tức. EPRT và LPRT
là các phần mở rộng cho giao thức FTP ban đầu và có thể không hoạt động trên tất cả các máy chủ, nhưng
chúng kích hoạt nhiều chức năng hơn theo cách tốt hơn lệnh PORT truyền thống.

--eprt có thể được sử dụng để bật lại EPRT một cách rõ ràng và --no-eprt là một bí danh cho
--disable-eprt.

Vô hiệu hóa EPRT chỉ thay đổi hành vi đang hoạt động. Nếu bạn muốn chuyển sang bị động
chế độ bạn cần không sử dụng -P, --ftp-port hoặc buộc nó với --ftp-passv.

--disable-epsv
(FTP) Yêu cầu curl tắt việc sử dụng lệnh EPSV khi thực hiện FTP thụ động
chuyển nhượng. Curl thường sẽ luôn cố gắng sử dụng EPSV trước PASV, nhưng
với tùy chọn này, nó sẽ không thử sử dụng EPSV.

--epsv có thể được sử dụng để bật lại EPSV một cách rõ ràng và --no-epsv là một bí danh cho
--disable-epsv.

Vô hiệu hóa EPSV chỉ thay đổi hành vi thụ động. Nếu bạn muốn chuyển sang hoạt động
chế độ bạn cần sử dụng -P, --ftp-port.

--dns-interface
Yêu cầu curl gửi các yêu cầu DNS đi qua . Tùy chọn này là một
đối tác với --giao diện (không ảnh hưởng đến DNS). Chuỗi được cung cấp phải là
tên giao diện (không phải địa chỉ).

Tùy chọn này yêu cầu libcurl được xây dựng với phần phụ trợ của trình phân giải hỗ trợ
hoạt động này. Chương trình phụ trợ c-ares là chương trình duy nhất như vậy. (Đã thêm vào 7.33.0)

--dns-ipv4-addr
Yêu cầu curl liên kết với khi thực hiện các yêu cầu DNS IPv4, để DNS
yêu cầu bắt nguồn từ địa chỉ này. Đối số phải là một địa chỉ IPv4 duy nhất.

Tùy chọn này yêu cầu libcurl được xây dựng với phần phụ trợ của trình phân giải hỗ trợ
hoạt động này. Chương trình phụ trợ c-ares là chương trình duy nhất như vậy. (Đã thêm vào 7.33.0)

--dns-ipv6-addr
Yêu cầu curl liên kết với khi thực hiện các yêu cầu DNS IPv6, để DNS
yêu cầu bắt nguồn từ địa chỉ này. Đối số phải là một địa chỉ IPv6 duy nhất.

Tùy chọn này yêu cầu libcurl được xây dựng với phần phụ trợ của trình phân giải hỗ trợ
hoạt động này. Chương trình phụ trợ c-ares là chương trình duy nhất như vậy. (Đã thêm vào 7.33.0)

--dns-máy chủ
Đặt danh sách các máy chủ DNS sẽ được sử dụng thay vì mặc định của hệ thống. Danh sách của
Địa chỉ IP nên được phân tách bằng dấu phẩy. Số cổng cũng có thể là tùy chọn
đưa ra như : sau mỗi địa chỉ IP.

Tùy chọn này yêu cầu libcurl được xây dựng với phần phụ trợ của trình phân giải hỗ trợ
hoạt động này. Chương trình phụ trợ c-ares là chương trình duy nhất như vậy. (Đã thêm vào 7.33.0)

-e, - giới thiệu
(HTTP) Gửi thông tin "Trang liên kết giới thiệu" đến máy chủ HTTP. Điều này cũng có thể được
thiết lập với -NS, --tiêu đề cờ tất nhiên. Khi sử dụng với -L, --vị trí bạn có thể
nối "; auto" vào URL --referer để làm cho curl tự động đặt URL trước đó
khi nó theo sau tiêu đề Location:. Chuỗi "; auto" có thể được sử dụng một mình, ngay cả khi
bạn không đặt - giới thiệu ban đầu.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-E, --cert
(SSL) Cho curl sử dụng tệp chứng chỉ ứng dụng khách được chỉ định khi nhận tệp
với HTTPS, FTPS hoặc một giao thức dựa trên SSL khác. Chứng chỉ phải ở PKCS # 12
định dạng nếu sử dụng Truyền tải an toàn hoặc định dạng PEM nếu sử dụng bất kỳ công cụ nào khác. Nếu
mật khẩu tùy chọn không được chỉ định, nó sẽ được truy vấn trên thiết bị đầu cuối. Ghi chú
rằng tùy chọn này giả định một tệp "chứng chỉ" là khóa cá nhân và
chứng chỉ khách hàng được nối! Nhìn thấy --chứng chỉ và --Chìa khóa để chỉ định chúng
một cách độc lập.

Nếu curl được xây dựng dựa trên thư viện SSL NSS thì tùy chọn này có thể cho curl biết
biệt hiệu của chứng chỉ để sử dụng trong cơ sở dữ liệu NSS được xác định bởi
biến môi trường SSL_DIR (hoặc theo mặc định / etc / pki / nssdb). Nếu NSS PEM PKCS # 11
mô-đun (libnsspem.so) khả dụng thì các tệp PEM có thể được tải. Nếu bạn muốn sử dụng
một tệp từ thư mục hiện tại, vui lòng đặt trước nó bằng tiền tố "./", để
tránh nhầm lẫn với biệt hiệu. Nếu biệt hiệu chứa ":", nó cần phải là
đứng trước "\" để nó không được nhận dạng là dấu phân cách mật khẩu. Nếu
biệt hiệu có chứa "\", nó cần phải được thoát là "\\" để không được nhận dạng
như một nhân vật chạy trốn.

(Chỉ dành cho iOS và Mac OS X) Nếu curl được xây dựng dựa trên Truyền tải an toàn, thì
chuỗi chứng chỉ có thể là tên của chứng chỉ / khóa cá nhân trong
hệ thống hoặc chuỗi khóa người dùng hoặc đường dẫn đến chứng chỉ được mã hóa PKCS # 12 và riêng tư
Chìa khóa. Nếu bạn muốn sử dụng một tệp từ thư mục hiện tại, vui lòng đặt trước nó bằng
tiền tố "./", để tránh nhầm lẫn với biệt hiệu.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--động cơ
Chọn công cụ mã hóa OpenSSL để sử dụng cho các hoạt động mật mã. Sử dụng --động cơ đến
in danh sách các công cụ được hỗ trợ theo thời gian xây dựng. Lưu ý rằng không phải tất cả (hoặc không có)
động cơ có thể có sẵn tại thời điểm chạy.

--môi trường
(CHỈ OS RISC) Đặt một loạt các biến môi trường, sử dụng tên -w tùy chọn
hỗ trợ, để cho phép trích xuất thông tin hữu ích dễ dàng hơn sau khi chạy curl.

--egd-file
(SSL) Chỉ định tên đường dẫn đến ổ cắm Entropy Gathering Daemon. Ổ cắm là
được sử dụng để khởi tạo công cụ ngẫu nhiên cho các kết nối SSL. Xem thêm --tập tin ngẫu nhiên
tùy chọn.

--expect100-timeout
(HTTP) Thời gian tối đa tính bằng giây mà bạn cho phép cuộn tròn chờ 100 lần tiếp tục
phản hồi khi curl phát ra tiêu đề Expects: 100-continue trong yêu cầu của nó. Theo mặc định
curl sẽ đợi một giây. Tùy chọn này chấp nhận các giá trị thập phân! Khi cuộn tóc dừng lại
đang đợi, nó sẽ tiếp tục như thể đã nhận được phản hồi.

(Đã thêm vào 7.47.0)

--cert-type
(SSL) Cho biết loại chứng chỉ mà chứng chỉ được cung cấp nằm trong. PEM, DER và
ENG là các loại được công nhận. Nếu không được chỉ định, PEM được giả định.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--cacert
(SSL) Cho curl sử dụng tệp chứng chỉ đã chỉ định để xác minh ngang hàng. Tập tin
có thể chứa nhiều chứng chỉ CA. (Các) chứng chỉ phải ở định dạng PEM.
Thông thường, curl được xây dựng để sử dụng tệp mặc định cho việc này, vì vậy tùy chọn này thường là
được sử dụng để thay đổi tệp mặc định đó.

curl nhận dạng biến môi trường có tên 'CURL_CA_BUNDLE' nếu nó được đặt và
sử dụng đường dẫn đã cho làm đường dẫn đến gói chứng chỉ CA. Tùy chọn này ghi đè
biến.

Phiên bản windows của curl sẽ tự động tìm kiếm tệp chứng chỉ CA có tên
´curl-ca-pack.crt´, trong cùng thư mục với curl.exe hoặc trong Hiện tại
Thư mục làm việc hoặc trong bất kỳ thư mục nào dọc theo PATH của bạn.

Nếu curl được xây dựng dựa trên thư viện NSS SSL, thì mô-đun NSS PEM PKCS # 11
(libnsspem.so) cần có sẵn để tùy chọn này hoạt động bình thường.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

- đường ống
(SSL) Cho curl sử dụng thư mục chứng chỉ đã chỉ định để xác minh ngang hàng.
Nhiều đường dẫn có thể được cung cấp bằng cách tách chúng bằng ":" (ví dụ:
"path1: path2: path3"). Các chứng chỉ phải ở định dạng PEM và nếu được xây dựng
chống lại OpenSSL, thư mục phải được xử lý bằng tiện ích c_rehash
được cung cấp với OpenSSL. Sử dụng - đường ống có thể cho phép cuộn dây được cung cấp bởi OpenSSL để tạo SSL-
kết nối hiệu quả hơn nhiều so với việc sử dụng --cacert nếu --cacert tập tin chứa
nhiều chứng chỉ CA.

Nếu tùy chọn này được đặt, giá trị capath mặc định sẽ bị bỏ qua và nếu nó được sử dụng
vài lần, cái cuối cùng sẽ được sử dụng.

--pinnedpubkey
(SSL) Yêu cầu curl sử dụng tệp khóa công khai (hoặc mã băm) được chỉ định để xác minh
ngang nhau. Đây có thể là một đường dẫn đến một tệp chứa một khóa công khai duy nhất trong PEM hoặc DER
định dạng hoặc bất kỳ số lượng băm sha64 được mã hóa base256 nào đứng trước ´sha256 // ´ và
cách nhau bởi ´; ´

Khi thương lượng kết nối TLS hoặc SSL, máy chủ sẽ gửi một chứng chỉ cho biết
bản sắc của nó. Khóa công khai được trích xuất từ ​​chứng chỉ này và nếu nó không
khớp chính xác với khóa công khai được cung cấp cho tùy chọn này, curl sẽ hủy bỏ
kết nối trước khi gửi hoặc nhận bất kỳ dữ liệu nào.

Đã thêm vào 7.39.0 cho OpenSSL, GnuTLS và GSKit. Đã thêm vào 7.43.0 cho NSS và
sóiSSL / CyaSSL. Hỗ trợ sha256 được thêm vào 7.44.0 cho OpenSSL, GnuTLS, NSS và
sóiSSL / CyaSSL. Các phụ trợ SSL khác không được hỗ trợ.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--trạng thái chứng chỉ
(SSL) Cho biết curl để xác minh trạng thái của chứng chỉ máy chủ bằng cách sử dụng
Phần mở rộng TLS của Yêu cầu Trạng thái Chứng chỉ (hay còn gọi là ghim OCSP).

Nếu tùy chọn này được bật và máy chủ gửi phản hồi không hợp lệ (ví dụ: đã hết hạn),
nếu phản hồi cho thấy rằng chứng chỉ máy chủ đã bị thu hồi hoặc không
tất cả đều nhận được phản hồi, xác minh không thành công.

Điều này hiện chỉ được triển khai trong phần phụ trợ OpenSSL, GnuTLS và NSS. (Thêm
năm 7.41.0)

--Không thật thà

(SSL) Cho curl sử dụng bắt đầu sai trong quá trình bắt tay TLS. Bắt đầu sai là một chế độ
trong đó ứng dụng khách TLS sẽ bắt đầu gửi dữ liệu ứng dụng trước khi xác minh
thông báo Kết thúc của máy chủ, do đó tiết kiệm một chuyến đi khứ hồi khi thực hiện đầy đủ
bắt tay.

Điều này hiện chỉ được triển khai trong NSS và Truyền tải an toàn (trên iOS 7.0 hoặc
sau, hoặc OS X 10.9 trở lên). (Đã thêm vào 7.42.0)

-f, --thất bại
(HTTP) Không thành công (không có đầu ra nào cả) do lỗi máy chủ. Điều này chủ yếu được thực hiện để
kích hoạt tốt hơn các tập lệnh, v.v. để đối phó tốt hơn với các lần thử không thành công. Trong trường hợp bình thường khi
một máy chủ HTTP không gửi được tài liệu, nó sẽ trả về một tài liệu HTML cho biết như vậy
(thường cũng mô tả lý do tại sao và hơn thế nữa). Cờ này sẽ ngăn không cho cuộn
xuất ra và trả về lỗi 22.

Phương pháp này không an toàn và có những trường hợp phản hồi không thành công
mã sẽ trượt qua, đặc biệt là khi có liên quan đến xác thực (mã phản hồi
401 và 407).

-F, - biểu mẫu
(HTTP) Điều này cho phép curl mô phỏng một biểu mẫu đã điền trong đó người dùng đã nhấn
nút gửi. Điều này gây ra cuộn tròn đối với dữ liệu ĐĂNG bằng cách sử dụng đa phần / biểu mẫu Loại Nội dung-
dữ liệu theo RFC 2388. Điều này cho phép tải lên các tệp nhị phân, v.v. Để buộc
phần 'nội dung' là một tệp, đặt tiền tố tên tệp bằng dấu @. Để chỉ có được
phần nội dung từ tệp, đặt tiền tố tên tệp bằng ký hiệu <. Các
sự khác biệt giữa @ và <khi đó @ làm cho một tệp được đính kèm trong bài đăng dưới dạng
tải lên tệp, trong khi <tạo trường văn bản và chỉ lấy nội dung cho
trường văn bản từ một tệp.

Ví dụ, để gửi tệp mật khẩu của bạn đến máy chủ, trong đó 'mật khẩu' là tên của
trường biểu mẫu mà / etc / passwd sẽ là đầu vào:

quăn lại -F mật khẩu = @/ etc / passwd www.mypasswords.com

Để đọc nội dung từ stdin thay vì một tệp, hãy sử dụng - làm tên tệp. Điều này phù hợp với
cả @ và <cấu trúc. Rất tiếc, nó không hỗ trợ đọc tệp từ
đường ống được đặt tên hoặc tương tự, vì nó cần có kích thước đầy đủ trước khi quá trình chuyển bắt đầu.

Bạn cũng có thể cho curl biết Content-Type cần sử dụng bằng cách sử dụng 'type =', theo cách
tương tự như:

quăn lại -F"[email được bảo vệ];type=text/html" url.com

or

quăn lại -F "name = daniel; type = text / foo" url.com

Bạn cũng có thể thay đổi rõ ràng trường tên của phần tải lên tệp bằng cách cài đặt
filename =, như thế này:

quăn lại -F "file = @ localfile; filename = nameinpost" url.com

Nếu tên tệp / đường dẫn chứa ',' hoặc ';', nó phải được trích dẫn bằng dấu ngoặc kép như:

quăn lại -F "file = @ \" localfile \ "; filename = \" nameinpost \ "" url.com

or

quăn lại -F 'file = @ "localfile"; filename = "nameinpost"' url.com

Lưu ý rằng nếu tên tệp / đường dẫn được trích dẫn bằng dấu ngoặc kép, bất kỳ dấu ngoặc kép nào hoặc
dấu gạch chéo ngược trong tên tệp phải được thoát bằng dấu gạch chéo ngược.

Xem thêm các ví dụ và chi tiết trong HƯỚNG DẪN.

Tùy chọn này có thể được sử dụng nhiều lần.

--ftp-account [dữ liệu]
(FTP) Khi máy chủ FTP yêu cầu "dữ liệu tài khoản" sau khi tên người dùng và mật khẩu có
được cung cấp, dữ liệu này được gửi đi bằng lệnh ACCT. (Đã thêm vào 7.13.0)

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--ftp-thay thế-cho-người dùng
(FTP) Nếu xác thực bằng lệnh USER và PASS không thành công, hãy gửi lệnh này.
Khi kết nối với máy chủ Truyền tải an toàn của Tumbleweed qua FTPS bằng ứng dụng khách
chứng chỉ, sử dụng "SITE AUTH" sẽ yêu cầu máy chủ truy xuất tên người dùng từ
chứng chỉ. (Đã thêm vào 7.15.5)

--ftp-tạo-dirs
(FTP / SFTP) Khi một URL / thao tác FTP hoặc SFTP sử dụng một đường dẫn hiện không
tồn tại trên máy chủ, hành vi tiêu chuẩn của curl là không thành công. Sử dụng tùy chọn này,
thay vào đó, curl sẽ cố gắng tạo các thư mục bị thiếu.

--ftp-method [phương thức]
(FTP) Kiểm soát phương thức curl nên sử dụng để truy cập tệp trên máy chủ FTP (S). Các
đối số phương thức phải là một trong những lựa chọn thay thế sau:

đa dâm
curl thực hiện một thao tác CWD cho mỗi phần đường dẫn trong URL đã cho. Vì
phân cấp sâu điều này có nghĩa là rất nhiều lệnh. Đây là cách RFC 1738 nói điều đó
nên được thực hiện. Đây là hành vi mặc định nhưng chậm nhất.

Nocwd curl hoàn toàn không có TKT. curl sẽ làm SIZE, RETR, STOR, v.v. và cung cấp đầy đủ
đường dẫn đến máy chủ cho tất cả các lệnh này. Đây là hành vi nhanh nhất.

độc thân
curl thực hiện một CWD với thư mục đích đầy đủ và sau đó hoạt động trên
tệp "bình thường" (giống như trong trường hợp đa mã). Đây là một số tiêu chuẩn hơn
tuân thủ so với 'nocwd' nhưng không bị phạt đầy đủ đối với 'multiwd'.

(Đã thêm vào 7.15.1)

--ftp-passv
(FTP) Sử dụng chế độ thụ động cho kết nối dữ liệu. Bị động là mặc định nội bộ
nhưng việc sử dụng tùy chọn này có thể được sử dụng để ghi đè -P / -ftp-cổng
Lựa chọn. (Đã thêm vào 7.11.0)

Nếu tùy chọn này được sử dụng nhiều lần, chỉ tùy chọn đầu tiên được sử dụng. Hoàn tác một
thụ động thực thi thực sự không thể làm được nhưng thay vào đó bạn phải thực thi chính xác
-P, --ftp-port một lần nữa.

Chế độ thụ động có nghĩa là curl sẽ thử lệnh EPSV trước rồi đến PASV, trừ khi
--disable-epsv Được sử dụng.

--ftp-bỏ qua-pasv-ip
(FTP) Yêu cầu curl không sử dụng địa chỉ IP mà máy chủ đề xuất trong phản hồi của nó
Lệnh PASV của curl khi curl kết nối kết nối dữ liệu. Thay vào đó, cuộn tròn sẽ lại
sử dụng cùng một địa chỉ IP mà nó đã sử dụng cho kết nối điều khiển. (Đã thêm vào
7.14.2)

Tùy chọn này không có hiệu lực nếu PORT, EPRT hoặc EPSV được sử dụng thay vì PASV.

--ftp-trước
(FTP) Yêu cầu curl gửi lệnh PRET trước PASV (và EPSV). Một số máy chủ FTP,
chủ yếu là drftpd, yêu cầu lệnh không chuẩn này cho danh sách thư mục cũng như
tải lên và tải xuống ở chế độ PASV. (Đã thêm vào 7.20.x)

--ftp-ssl-ccc
(FTP) Sử dụng CCC (Xóa kênh lệnh) Tắt lớp SSL / TLS sau
xác thực. Phần còn lại của giao tiếp kênh điều khiển sẽ không được mã hóa.
Điều này cho phép các bộ định tuyến NAT theo dõi giao dịch FTP. Chế độ mặc định là bị động.
Xem --ftp-ssl-ccc-chế độ cho các chế độ khác. (Đã thêm vào 7.16.1)

--ftp-ssl-ccc-mode [chủ động / bị động]
(FTP) Sử dụng CCC (Xóa kênh lệnh) Đặt chế độ CCC. Chế độ thụ động sẽ không
bắt đầu tắt máy, nhưng thay vào đó hãy đợi máy chủ thực hiện và sẽ không trả lời
đến việc tắt máy từ máy chủ. Chế độ hoạt động bắt đầu tắt máy và chờ
để trả lời từ máy chủ. (Đã thêm vào 7.16.2)

--ftp-ssl-điều khiển
(FTP) Yêu cầu SSL / TLS cho đăng nhập FTP, xóa để chuyển. Cho phép an toàn
xác thực, nhưng truyền dữ liệu không được mã hóa để đạt hiệu quả. Không thành công
chuyển nếu máy chủ không hỗ trợ SSL / TLS. (Đã thêm vào 7.16.0) mà vẫn có thể
được sử dụng nhưng sẽ bị xóa trong một phiên bản trong tương lai.

--form-string
(HTTP) Tương tự với --mẫu đơn ngoại trừ chuỗi giá trị cho tham số được đặt tên là
được sử dụng theo nghĩa đen. Các ký tự '@' và '<' đứng đầu và chuỗi '; type =' trong
giá trị không có ý nghĩa đặc biệt. Sử dụng tùy chọn này để --mẫu đơn nếu có bất kỳ
khả năng giá trị chuỗi có thể vô tình kích hoạt các tính năng '@' hoặc '<'
of --mẫu đơn.

-g, --globoff
Tùy chọn này sẽ tắt "trình phân tích cú pháp URL globbing". Khi bạn đặt tùy chọn này, bạn
có thể chỉ định các URL chứa các chữ cái {} [] mà không cần
diễn giải bằng cách cuộn tròn chính nó. Lưu ý rằng những chữ cái này không phải là URL hợp pháp bình thường
nhưng chúng phải được mã hóa theo tiêu chuẩn URI.

-G, --lấy
Khi được sử dụng, tùy chọn này sẽ làm cho tất cả dữ liệu được chỉ định với -NS, --dữ liệu, --data-nhị phân
or --data-urlencode được sử dụng trong yêu cầu HTTP GET thay vì yêu cầu ĐĂNG
nếu không sẽ được sử dụng. Dữ liệu sẽ được thêm vào URL bằng dấu '?'
dải phân cách.

Nếu được sử dụng kết hợp với -I, thay vào đó, dữ liệu POST sẽ được thêm vào URL
với yêu cầu HEAD.

Nếu tùy chọn này được sử dụng nhiều lần, chỉ tùy chọn đầu tiên được sử dụng. Điều này là bởi vì
hoàn tác GET không có ý nghĩa, nhưng thay vào đó bạn nên thực thi
phương pháp thay thế bạn thích.

-H, - đầu
(HTTP) Tiêu đề bổ sung để đưa vào yêu cầu khi gửi HTTP đến máy chủ. Bạn
có thể chỉ định bất kỳ số lượng tiêu đề phụ nào. Lưu ý rằng nếu bạn nên thêm một tùy chỉnh
tiêu đề có cùng tên với một trong những tiêu đề nội bộ mà curl sẽ sử dụng,
tiêu đề thiết lập bên ngoài sẽ được sử dụng thay vì tiêu đề nội bộ. Điều này cho phép bạn
làm những thứ thậm chí còn phức tạp hơn so với cuộn tóc thông thường. Bạn không nên thay thế
đặt tiêu đề nội bộ mà không biết rõ bạn đang làm gì. Loại bỏ một
tiêu đề nội bộ bằng cách đưa ra một thay thế không có nội dung ở phía bên phải của
dấu hai chấm, như trong: -H "Host:". Nếu bạn gửi tiêu đề tùy chỉnh không có giá trị thì
tiêu đề phải được kết thúc bằng dấu chấm phẩy, chẳng hạn như -H "X-Custom-Header;" để gửi
"X-Custom-Header:".

curl sẽ đảm bảo rằng mỗi tiêu đề bạn thêm / thay thế được gửi bằng phần cuối thích hợp-
điểm đánh dấu dòng, do đó bạn nên không thêm nó như một phần của nội dung tiêu đề: do
không thêm dòng mới hoặc dấu xuống dòng, chúng sẽ chỉ làm rối tung mọi thứ cho bạn.

Xem thêm -MỘT, --đại lý người dùng và -e, - giới thiệu tùy chọn.

Bắt đầu từ 7.37.0, bạn cần - tiêu đề proxy để gửi các tiêu đề tùy chỉnh dành cho một
Ủy quyền.

Ví dụ:

# curl -H "X-First-Name: Joe" http://192.168.0.1/

CẢNH BÁO: tiêu đề được đặt với tùy chọn này sẽ được đặt trong tất cả các yêu cầu - ngay cả sau
chuyển hướng được theo sau, giống như khi được nói với -L, --vị trí. Điều này có thể dẫn đến
tiêu đề được gửi đến các máy chủ khác ngoài máy chủ ban đầu, vì vậy các tiêu đề nhạy cảm
nên được sử dụng một cách thận trọng kết hợp với các chuyển hướng sau.

Tùy chọn này có thể được sử dụng nhiều lần để thêm / thay thế / loại bỏ nhiều tiêu đề.

--hostpubmd5
(SCP / SFTP) Chuyển một chuỗi chứa 32 chữ số thập lục phân. Chuỗi phải là
Tổng kiểm tra 128 bit MD5 của khóa công khai của máy chủ từ xa, curl sẽ từ chối
kết nối với máy chủ trừ khi md5sums khớp. (Đã thêm vào 7.17.1)

--bỏ qua-độ dài nội dung
Đối với HTTP, hãy bỏ qua tiêu đề Độ dài nội dung. Điều này đặc biệt hữu ích cho các máy chủ
đang chạy Apache 1.x, sẽ báo cáo Độ dài Nội dung không chính xác cho các tệp lớn hơn
hơn 2 gigabyte.

Đối với FTP (kể từ 7.46.0), bỏ qua lệnh RETR để tìm ra kích thước trước
tải xuống một tệp.

-i, --bao gồm
(HTTP) Bao gồm tiêu đề HTTP trong đầu ra. Tiêu đề HTTP bao gồm những thứ như
tên máy chủ, ngày của tài liệu, phiên bản HTTP và hơn thế nữa ...

-Tôi, - đầu
(HTTP / FTP / FILE) Chỉ tìm nạp tiêu đề HTTP! Máy chủ HTTP có tính năng lệnh HEAD
mà điều này sử dụng để không nhận được gì ngoài tiêu đề của một tài liệu. Khi được sử dụng trên FTP hoặc
Tệp FILE, curl chỉ hiển thị kích thước tệp và thời gian sửa đổi cuối cùng.

--giao diện
Thực hiện một hoạt động bằng cách sử dụng một giao diện được chỉ định. Bạn có thể nhập tên giao diện, IP
địa chỉ hoặc tên máy chủ. Một ví dụ có thể giống như sau:

curl - giao diện eth0: 1 http://www.netscape.com/

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-j, --junk-session-cookie
(HTTP) Khi curl được yêu cầu đọc cookie từ một tệp nhất định, tùy chọn này sẽ thực hiện
nó loại bỏ tất cả "cookie phiên". Điều này về cơ bản sẽ có tác dụng tương tự như nếu
phiên mới được bắt đầu. Các trình duyệt điển hình luôn loại bỏ cookie phiên khi
họ đã đóng cửa.

-J, --remote-header-name
(HTTP) Tùy chọn này cho biết -Ồ, --tên từ xa tùy chọn sử dụng máy chủ do máy chủ chỉ định
Tên tệp Nội dung-Bố trí thay vì trích xuất tên tệp từ URL.

Không có nỗ lực nào để giải mã% -sequences (chưa) trong tên tệp được cung cấp, vì vậy điều này
tùy chọn có thể cung cấp cho bạn những tên tệp khá bất ngờ.

-k, - an toàn
(SSL) Tùy chọn này rõ ràng cho phép curl thực hiện các kết nối SSL "không an toàn" và
chuyển nhượng. Tất cả các kết nối SSL được cố gắng đảm bảo an toàn bằng cách sử dụng CA
gói chứng chỉ được cài đặt theo mặc định. Điều này làm cho tất cả các kết nối được coi là
"không an toàn" không thành công trừ khi -k, --không an toàn Được sử dụng.

Xem tài nguyên trực tuyến này để biết thêm chi tiết:
http://curl.haxx.se/docs/sslcerts.html

-K, --config
Chỉ định tệp cấu hình để đọc các đối số curl. Tệp cấu hình là một văn bản
tệp trong đó các đối số dòng lệnh có thể được viết, sau đó sẽ được sử dụng như thể
chúng được viết trên dòng lệnh thực tế.

Các tùy chọn và thông số của chúng phải được chỉ định trên cùng một dòng tệp cấu hình,
được phân tách bằng khoảng trắng, dấu hai chấm hoặc dấu bằng. Tên tùy chọn dài có thể
tùy chọn được cung cấp trong tệp cấu hình mà không có dấu gạch ngang kép đầu tiên và nếu có,
dấu hai chấm hoặc các ký tự bằng có thể được sử dụng làm dấu phân cách. Nếu tùy chọn là
được chỉ định bằng một hoặc hai dấu gạch ngang, không được có dấu hai chấm hoặc ký tự bằng giữa
tùy chọn và tham số của nó.

Nếu tham số chứa khoảng trắng, thì tham số phải được bao trong
dấu ngoặc kép. Trong dấu ngoặc kép, các chuỗi thoát sau có sẵn: \\, \ ",
\ t, \ n, \ r và \ v. Dấu gạch chéo ngược đứng trước bất kỳ chữ cái nào khác sẽ bị bỏ qua. Nếu người đầu tiên
cột của dòng cấu hình là ký tự '#', phần còn lại của dòng sẽ được coi là
một lời bình luận. Chỉ ghi một tùy chọn trên mỗi dòng vật lý trong tệp cấu hình.

Chỉ định tên tệp thành -K, --config là '-' để làm cho curl đọc tệp từ stdin.

Lưu ý rằng để có thể chỉ định một URL trong tệp cấu hình, bạn cần chỉ định nó
bằng cách sử dụng --url và không chỉ đơn giản là viết URL trên dòng của chính nó. Do đó, nó
có thể trông tương tự như thế này:

url = "http://curl.haxx.se/docs/"

Khi curl được gọi, nó luôn luôn (trừ khi -q được sử dụng) kiểm tra cấu hình mặc định
và sử dụng nó nếu được tìm thấy. Tệp cấu hình mặc định được kiểm tra như sau
đặt theo thứ tự này:

1) curl cố gắng tìm "home dir": Đầu tiên nó kiểm tra CURL_HOME và sau đó
các biến môi trường HOME. Không đạt được điều đó, nó sử dụng getpwuid () trên Unix-like
hệ thống (trả về dir chủ cho người dùng hiện tại trong hệ thống của bạn). Trên
Windows, sau đó nó sẽ kiểm tra biến APPDATA hoặc phương sách cuối cùng là
'% USERPROFILE% \ Dữ liệu ứng dụng'.

2) Trên windows, nếu không có tệp _curlrc trong dir gia đình, nó sẽ kiểm tra một tệp trong
cùng một tệp thực thi curl được đặt. Trên các hệ thống giống Unix, nó sẽ đơn giản
cố gắng tải .curlrc từ dir nhà được xác định.

# --- Tệp ví dụ ---
# đây là một nhận xét
url = "curl.haxx.se"
output = "curlhere.html"
user-agent = "superagent / 1.0"

# và cũng tìm nạp một URL khác
url = "curl.haxx.se/docs/manpage.html"
-O
giới thiệu = "http://nowhereatall.com/"
# --- Cuối tệp ví dụ ---

Tùy chọn này có thể được sử dụng nhiều lần để tải nhiều tệp cấu hình.

- thời gian lưu trữ
Tùy chọn này đặt thời gian kết nối cần duy trì ở chế độ chờ trước khi gửi
Các đầu dò lưu giữ và thời gian giữa các đầu dò lưu giữ riêng lẻ. Nó hiện đang
hiệu quả trên các hệ điều hành cung cấp cổng TCP_KEEPIDLE và TCP_KEEPINTVL
tùy chọn (có nghĩa là Linux, AIX gần đây, HP-UX và hơn thế nữa). Tùy chọn này không có hiệu lực nếu
- không lưu giữ Được sử dụng. (Đã thêm vào 7.18.0)

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng. Nếu không xác định,
tùy chọn mặc định là 60 giây.

--Chìa khóa
(SSL / SSH) Tên tệp khóa cá nhân. Cho phép bạn cung cấp khóa cá nhân của mình trong việc này
tệp riêng biệt. Đối với SSH, nếu không được chỉ định, curl sẽ thử các ứng viên sau trong
đặt hàng: '~ / .ssh / id_rsa''~ / .ssh / id_dsa',' ./id_rsa ',' ./id_dsa '.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--loại chính
(SSL) Loại tệp khóa cá nhân. Chỉ định loại của bạn --Chìa khóa cung cấp khóa riêng là.
DER, PEM và ENG được hỗ trợ. Nếu không được chỉ định, PEM được giả định.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--krb
(FTP) Bật xác thực và sử dụng Kerberos. Mức độ phải được nhập và nên
là một trong các loại 'rõ ràng', 'an toàn', 'bí mật' hoặc 'riêng tư'. Bạn có nên sử dụng một cấp độ
đó không phải là một trong những thứ này, thay vào đó, 'private' sẽ được sử dụng.

Tùy chọn này yêu cầu một thư viện được xây dựng với hỗ trợ kerberos4. Điều này không phải là rất
chung. Sử dụng -V, --phiên bản để xem liệu lọn tóc của bạn có hỗ trợ nó không.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-l, - chỉ trong danh sách
(FTP) Khi liệt kê một thư mục FTP, công tắc này buộc chế độ xem chỉ có tên. Đây là
đặc biệt hữu ích nếu người dùng muốn phân tích cú pháp máy nội dung của FTP
thư mục vì chế độ xem thư mục bình thường không sử dụng giao diện hoặc định dạng chuẩn.
Khi được sử dụng như vậy, tùy chọn sẽ khiến một lệnh NLST được gửi đến máy chủ
thay vì LIST.

Lưu ý: Một số máy chủ FTP chỉ liệt kê các tệp trong phản hồi của chúng với NLST; họ không
bao gồm các thư mục con và các liên kết tượng trưng.

(POP3) Khi truy xuất một email cụ thể từ POP3, công tắc này buộc một DANH SÁCH
lệnh được thực hiện thay vì RETR. Điều này đặc biệt hữu ích nếu người dùng
muốn xem liệu một id thư cụ thể có tồn tại trên máy chủ hay không và kích thước của nó.

Lưu ý: Khi kết hợp với -NS, --lời yêu cầu , tùy chọn này có thể được sử dụng để gửi
thay vào đó, một lệnh UIDL, vì vậy người dùng có thể sử dụng mã nhận dạng duy nhất của email thay vì
hơn là id tin nhắn để thực hiện yêu cầu. (Đã thêm vào 7.21.5)

-L, - vị trí
(HTTP / HTTPS) Nếu máy chủ báo cáo rằng trang được yêu cầu đã chuyển sang một trang khác
vị trí (được chỉ ra bằng Vị trí: tiêu đề và mã phản hồi 3XX), tùy chọn này
sẽ bắt curl làm lại theo yêu cầu trên địa điểm mới. Nếu được sử dụng cùng với -tôi,
--bao gồm or -TÔI, --cái đầu, tiêu đề từ tất cả các trang được yêu cầu sẽ được hiển thị. Khi nào
xác thực được sử dụng, curl chỉ gửi thông tin đăng nhập của nó đến máy chủ ban đầu. Nếu một
chuyển hướng đưa đến một máy chủ khác, nó sẽ không thể chặn
người dùng + mật khẩu. Xem thêm - vị trí đáng tin cậy về cách thay đổi điều này. Bạn có thể giới hạn
số lượng chuyển hướng cần theo dõi bằng cách sử dụng - max-redirs tùy chọn.

Khi curl theo sau một chuyển hướng và yêu cầu không phải là GET đơn giản (ví dụ: ĐĂNG
hoặc PUT), nó sẽ thực hiện yêu cầu sau với GET nếu phản hồi HTTP là 301,
302 hoặc 303. Nếu mã phản hồi là bất kỳ mã 3xx nào khác, curl sẽ gửi lại
theo yêu cầu bằng cách sử dụng cùng một phương pháp chưa được sửa đổi.

Bạn có thể yêu cầu curl không thay đổi phương thức yêu cầu không phải GET thành GET sau 30 lần
phản hồi bằng cách sử dụng các tùy chọn dành riêng cho điều đó: --post301, --post302 và
-bài303.

--libcurl
Nối tùy chọn này vào bất kỳ dòng lệnh curl thông thường nào, và bạn sẽ nhận được một libcurl-
sử dụng mã nguồn C được ghi vào tệp tương đương với những gì
hoạt động dòng lệnh không!

Nếu tùy chọn này được sử dụng nhiều lần, tên tệp đã cho cuối cùng sẽ được sử dụng. (Thêm
năm 7.16.1)

--limit-rate
Chỉ định tốc độ truyền tải tối đa bạn muốn curl sử dụng - cho cả tải xuống và
tải lên. Tính năng này rất hữu ích nếu bạn có một đường ống hạn chế và bạn muốn
chuyển không sử dụng toàn bộ băng thông của bạn. Để làm cho nó chậm hơn so với cách khác
sẽ là

Tốc độ đã cho được đo bằng byte / giây, trừ khi một hậu tố được thêm vào.
Thêm 'k' hoặc 'K' sẽ tính số dưới dạng kilobyte, 'm' hoặc M 'tạo thành nó
megabyte, trong khi 'g' hoặc 'G' là gigabyte. Ví dụ: 200K, 3m và 1G.

Tốc độ đã cho là tốc độ trung bình được tính trong toàn bộ quá trình truyền. Nó có nghĩa là
cuộn tròn đó có thể sử dụng tốc độ truyền cao hơn trong các đợt ngắn, nhưng theo thời gian, nó sử dụng
không nhiều hơn tỷ lệ nhất định.

Nếu bạn cũng sử dụng -Ừ, --tốc độ giới hạn tùy chọn, tùy chọn đó sẽ được ưu tiên và
có thể làm tê liệt giới hạn tốc độ một chút, để giúp duy trì logic giới hạn tốc độ
đang làm việc.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--local-port [-num]
Đặt số lượng ưu tiên hoặc dải số cổng cục bộ để sử dụng cho (các) kết nối.
Lưu ý rằng số lượng cổng về bản chất là một nguồn tài nguyên khan hiếm, đôi khi sẽ bận rộn
vì vậy việc đặt phạm vi này thành phạm vi nào đó quá hẹp có thể gây ra kết nối không cần thiết
thiết lập không thành công. (Đã thêm vào 7.15.2)

- vị trí đáng tin cậy
(HTTP / HTTPS) Thích -L, --vị trí, nhưng sẽ cho phép gửi tên + mật khẩu cho tất cả
máy chủ mà trang web có thể chuyển hướng đến. Điều này có thể có hoặc không giới thiệu một bảo mật
vi phạm nếu trang web chuyển hướng bạn đến một trang web mà bạn sẽ gửi xác thực của mình
thông tin (là bản rõ trong trường hợp xác thực HTTP cơ bản).

-m, - max-time
Thời gian tối đa tính bằng giây mà bạn cho phép thực hiện toàn bộ hoạt động. Cái này hữu ích
để ngăn chặn các công việc hàng loạt của bạn bị treo trong nhiều giờ do mạng hoặc liên kết chậm
đi xuống. Kể từ 7.32.0, tùy chọn này chấp nhận các giá trị thập phân, nhưng thực tế
thời gian chờ sẽ giảm độ chính xác khi thời gian chờ được chỉ định tăng lên ở dạng thập phân
độ chính xác. Xem thêm - hết thời gian kết nối tùy chọn.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--login-options
Chỉ định các tùy chọn đăng nhập để sử dụng trong quá trình xác thực máy chủ.

Bạn có thể sử dụng các tùy chọn đăng nhập để chỉ định các tùy chọn giao thức cụ thể có thể được sử dụng
trong quá trình xác thực. Hiện tại, chỉ có các tùy chọn đăng nhập hỗ trợ IMAP, POP3 và SMTP.
Để biết thêm thông tin về các tùy chọn đăng nhập, vui lòng xem RFC 2384, RFC 5092 và IETF
nháp nháp-earhart-url-smtp-00.txt (Đã thêm vào 7.34.0).

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--mail-auth
(SMTP) Chỉ định một địa chỉ. Điều này sẽ được sử dụng để chỉ định xác thực
địa chỉ (danh tính) của một thư đã gửi đang được chuyển tiếp đến một máy chủ khác.

(Đã thêm vào 7.25.0)

--thư đến từ
(SMTP) Chỉ định một địa chỉ duy nhất mà thư nhất định sẽ được gửi từ đó.

(Đã thêm vào 7.20.0)

--Kích thước tệp tối đa
Chỉ định kích thước tối đa (tính bằng byte) của tệp để tải xuống. Nếu tệp được yêu cầu là
lớn hơn giá trị này, quá trình chuyển sẽ không bắt đầu và cuộn tròn sẽ trở lại khi thoát
mã 63.

LƯU Ý: Kích thước tệp không phải lúc nào cũng được biết trước khi tải xuống và đối với những tệp như vậy, điều này
tùy chọn này không có hiệu lực ngay cả khi kết thúc quá trình truyền tệp lớn hơn mức đã cho
giới hạn. Điều này liên quan đến cả truyền FTP và HTTP.

--mail-rcpt
(SMTP) Chỉ định một địa chỉ, tên người dùng hoặc tên danh sách gửi thư.

Khi thực hiện chuyển thư, người nhận phải chỉ định một địa chỉ email hợp lệ
để gửi thư đến. (Đã thêm vào 7.20.0)

Khi thực hiện xác minh địa chỉ (lệnh VRFY), người nhận phải
được chỉ định là tên người dùng hoặc tên người dùng và miền (theo Phần 3.5 của RFC5321).
(Đã thêm vào 7.34.0)

Khi thực hiện mở rộng danh sách gửi thư (lệnh EXPN), người nhận phải
được chỉ định bằng cách sử dụng tên danh sách gửi thư, chẳng hạn như "Bạn bè" hoặc "Văn phòng Luân Đôn".
(Đã thêm vào 7.34.0)

--max-redirs
Đặt số lượng chuyển hướng tối đa cho phép. Nếu như -L, --vị trí Được sử dụng,
tùy chọn này có thể được sử dụng để ngăn không cho cuộn dây sau chuyển hướng "trong đường cong".
Theo mặc định, giới hạn được đặt thành 50 chuyển hướng. Đặt tùy chọn này thành -1 để làm cho nó
vô hạn.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--liên kết kim loại
Tùy chọn này có thể yêu cầu curl phân tích cú pháp và xử lý một URI nhất định dưới dạng tệp Metalink (cả hai
phiên bản 3 và 4 (RFC 5854) được hỗ trợ) và sử dụng các gương được liệt kê trong
để chuyển đổi dự phòng nếu có lỗi (chẳng hạn như tệp hoặc máy chủ không khả dụng).
Nó cũng sẽ xác minh hàm băm của tệp sau khi quá trình tải xuống hoàn tất. The Metalink
bản thân tệp được tải xuống và xử lý trong bộ nhớ và không được lưu trữ trong tệp cục bộ
hệ thống.

Ví dụ để sử dụng tệp Metalink từ xa:

quăn lại --liên kết kim loại http://www.example.com/example.metalink

Để sử dụng tệp Metalink trong hệ thống tệp cục bộ, hãy sử dụng giao thức FILE (tệp: //):

quăn lại --tệp liên kết: //example.metalink

Xin lưu ý rằng nếu giao thức FILE bị vô hiệu hóa, không có cách nào để sử dụng cục bộ
Tệp Metalink tại thời điểm viết bài này. Cũng lưu ý rằng nếu --liên kết kim loại và
--bao gồm được sử dụng cùng nhau, --bao gồm sẽ bị bỏ qua. Điều này là do bao gồm
các tiêu đề trong phản hồi sẽ phá vỡ trình phân tích cú pháp Metalink và nếu các tiêu đề được bao gồm
trong tệp được mô tả trong tệp Metalink, kiểm tra băm sẽ không thành công.

(Đã thêm vào 7.27.0, nếu được xây dựng dựa trên thư viện libmetalink.)

-n, --netrc
Làm cho cuộn tóc quét .netrc (_mạng trên Windows) tệp trong thư mục chính của người dùng
cho tên đăng nhập và mật khẩu. Điều này thường được sử dụng cho FTP trên Unix. Nếu được sử dụng với
HTTP, curl sẽ kích hoạt xác thực người dùng. Nhìn thấy mạng(5) ftp(1) để biết chi tiết về
định dạng tệp. Curl sẽ không phàn nàn nếu tệp đó không có quyền phù hợp
(không nên đọc cả thế giới hoặc theo nhóm). Biến môi trường "HOME"
được sử dụng để tìm thư mục chính.

Một ví dụ nhanh chóng và rất đơn giản về cách thiết lập .netrc để cho phép cuộn vào FTP để
máy host.domain.com với tên người dùng 'tôi' và mật khẩu 'bí mật' nên
trông tương tự như:

máy máy chủ.domain.com đăng nhập bản thân mình mật khẩu bí mật

-N, - không có bộ đệm
Tắt bộ đệm của luồng đầu ra. Trong các tình huống công việc bình thường, cuộn tròn sẽ
sử dụng luồng đầu ra có bộ đệm tiêu chuẩn sẽ có tác dụng là nó sẽ xuất ra
dữ liệu theo từng phần, không nhất thiết phải chính xác khi dữ liệu đến. Sử dụng cái này
tùy chọn sẽ vô hiệu hóa bộ đệm đó.

Lưu ý rằng đây là tên tùy chọn phủ định được ghi lại. Do đó, bạn có thể sử dụng --đệm đến
thực thi bộ đệm.

--netrc-tệp
Tùy chọn này tương tự như --netrc, ngoại trừ việc bạn cung cấp đường dẫn (tuyệt đối hoặc
tương đối) với tệp netrc mà Curl nên sử dụng. Bạn chỉ có thể chỉ định một netrc
tệp cho mỗi lần gọi. Nếu một số --netrc-tệp các tùy chọn được cung cấp, chỉ cuối cùng
một sẽ được sử dụng. (Đã thêm vào 7.21.5)

Tùy chọn này ghi đè bất kỳ việc sử dụng nào --netrc vì chúng loại trừ lẫn nhau. Nó sẽ
cũng tuân theo --netrc-tùy chọn nếu được chỉ định.

--netrc-tùy chọn
Rất giống với --netrc, nhưng tùy chọn này làm cho việc sử dụng .netrc không bắt buộc và không
bắt buộc như --netrc tùy chọn không.

--đàm phán
(HTTP) Cho phép xác thực Thương lượng (SPNEGO).

Nếu bạn muốn bật Thương lượng (SPNEGO) để xác thực proxy, hãy sử dụng
- thương lượng ủy quyền.

Tùy chọn này yêu cầu thư viện được xây dựng với hỗ trợ GSS-API hoặc SSPI. Sử dụng -V,
--phiên bản để xem liệu cuộn tóc của bạn có hỗ trợ GSS-API / SSPI và SPNEGO hay không.

Khi sử dụng tùy chọn này, bạn cũng phải cung cấp -bạn, --người sử dụng tùy chọn để kích hoạt
mã xác thực đúng cách. Gửi '-u:' là đủ làm tên người dùng và
mật khẩu từ -u tùy chọn không thực sự được sử dụng.

Nếu tùy chọn này được sử dụng nhiều lần, chỉ tùy chọn đầu tiên được sử dụng.

- không lưu giữ
Vô hiệu hóa việc sử dụng các tin nhắn lưu giữ trên kết nối TCP, theo mặc định là curl
cho phép họ.

Lưu ý rằng đây là tên tùy chọn phủ định được ghi lại. Do đó, bạn có thể sử dụng --cố sống đi
để thực thi keepalive.

--no-sessionid
(SSL) Vô hiệu hóa việc sử dụng bộ đệm SSL session-ID của curl. Theo mặc định, tất cả các lần chuyển là
được thực hiện bằng cách sử dụng bộ nhớ cache. Lưu ý rằng mặc dù không có gì có thể bị tổn thương bằng cách cố gắng
sử dụng lại các ID phiên SSL, dường như có những triển khai SSL bị hỏng trong tự nhiên
có thể yêu cầu bạn tắt tính năng này để thành công. (Đã thêm vào 7.16.0)

Lưu ý rằng đây là tên tùy chọn phủ định được ghi lại. Do đó, bạn có thể sử dụng --sessionid
để thực thi bộ nhớ đệm session-ID.

--không có proxy
Danh sách các máy chủ được phân tách bằng dấu phẩy không sử dụng proxy, nếu một máy chủ được chỉ định. Các
chỉ có ký tự đại diện là một ký tự * duy nhất, khớp với tất cả các máy chủ và hiệu quả
tắt proxy. Mỗi tên trong danh sách này được so khớp dưới dạng một miền
chứa tên máy chủ hoặc chính tên máy chủ. Ví dụ: local.com sẽ khớp với
local.com, local.com:80 và www.local.com, nhưng không phải www.notlocal.com. (Đã thêm vào
7.19.4).

--ntlm (HTTP) Cho phép xác thực NTLM. Phương thức xác thực NTLM được thiết kế bởi
Microsoft và được sử dụng bởi máy chủ web IIS. Nó là một giao thức độc quyền, ngược lại-
được thiết kế bởi những người thông minh và được thực hiện một cách hoàn chỉnh dựa trên nỗ lực của họ. Cái này
loại hành vi không nên được chứng thực, bạn nên khuyến khích tất cả những người sử dụng
NTLM để chuyển sang phương thức xác thực công khai và tài liệu thay thế, chẳng hạn như
Tiêu.

Nếu bạn muốn bật NTLM để xác thực proxy của mình, thì hãy sử dụng --proxy-ntlm.

Tùy chọn này yêu cầu một thư viện được xây dựng với hỗ trợ SSL. Sử dụng -V, --phiên bản để xem
lọn tóc của bạn hỗ trợ NTLM.

Nếu tùy chọn này được sử dụng nhiều lần, chỉ tùy chọn đầu tiên được sử dụng.

-o, - đầu ra
Ghi đầu ra vào thay vì stdout. Nếu bạn đang sử dụng {} hoặc [] để tìm nạp
nhiều tài liệu, bạn có thể sử dụng '#' theo sau là một số trong người chỉ định.
Biến đó sẽ được thay thế bằng chuỗi hiện tại cho URL đang được tìm nạp.
Giống như trong:

curl http: // {một, hai} .site.com -o "file_ # 1.txt"

hoặc sử dụng một số biến như:

curl http: // {site, host} .host [1-5] .com -o "# 1_ # 2"

Bạn có thể sử dụng tùy chọn này nhiều lần với số lượng URL bạn có.

Xem thêm --tạo-thư mục tùy chọn để tạo động các thư mục cục bộ.
Chỉ định đầu ra là '-' (một dấu gạch ngang) sẽ buộc đầu ra phải được thực hiện
tiêu chuẩn.

-O, - ghi nhớ tên
Ghi đầu ra vào một tệp cục bộ có tên giống như tệp từ xa mà chúng tôi nhận được. (Chỉ phần tập tin
của tệp từ xa được sử dụng, đường dẫn bị cắt.)

Tên tệp từ xa để sử dụng để lưu được trích xuất từ ​​URL đã cho, không có gì
khác

Do đó, tệp sẽ được lưu trong thư mục làm việc hiện tại. nếu bạn
muốn tệp được lưu trong một thư mục khác, hãy đảm bảo rằng bạn thay đổi cách làm việc hiện tại
thư mục trước khi bạn gọi curl với -Ồ, --tên từ xa lá cờ!

Không có giải mã URL nào được thực hiện trên tên tệp. Nếu nó có% 20 hoặc URL khác được mã hóa
các phần của tên, chúng sẽ kết thúc như tên tệp.

Bạn có thể sử dụng tùy chọn này nhiều lần với số lượng URL bạn có.

--oauth2-mang
(IMAP, POP3, SMTP) Chỉ định Mã thông báo mang để xác thực máy chủ OAUTH 2.0.
Bearer Token được sử dụng cùng với tên người dùng có thể được chỉ định
như là một phần của --url or -bạn, --người sử dụng tùy chọn.

Mã thông báo mang và tên người dùng được định dạng theo RFC 6750.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

- tiêu đề proxy
(HTTP) Tiêu đề bổ sung để đưa vào yêu cầu khi gửi HTTP tới proxy. Bạn có thể
chỉ định bất kỳ số lượng tiêu đề phụ nào. Đây là tùy chọn tương đương với -NS, --tiêu đề
nhưng chỉ dành cho giao tiếp proxy như trong các yêu cầu CONNECT khi bạn muốn
tiêu đề riêng biệt được gửi tới proxy đến những gì được gửi đến máy chủ từ xa thực tế.

curl sẽ đảm bảo rằng mỗi tiêu đề bạn thêm / thay thế được gửi bằng phần cuối thích hợp-
điểm đánh dấu dòng, do đó bạn nên không thêm nó như một phần của nội dung tiêu đề: do
không thêm dòng mới hoặc dấu xuống dòng, chúng sẽ chỉ làm rối tung mọi thứ cho bạn.

Các tiêu đề được chỉ định với tùy chọn này sẽ không được đưa vào các yêu cầu mà curl biết
sẽ không được gửi đến một proxy.

Tùy chọn này có thể được sử dụng nhiều lần để thêm / thay thế / loại bỏ nhiều tiêu đề.

(Đã thêm vào 7.37.0)

-p, --proxytunnel
Khi một proxy HTTP được sử dụng (-NS, --Ủy quyền), tùy chọn này sẽ gây ra các giao thức không phải HTTP
để cố gắng tạo đường hầm qua proxy thay vì chỉ sử dụng nó để thực hiện như HTTP
các hoạt động. Phương pháp tiếp cận đường hầm được thực hiện với yêu cầu CONNECT proxy HTTP và
yêu cầu proxy cho phép kết nối trực tiếp với số cổng từ xa mà bạn muốn
đến đường hầm tới.

-P, --ftp-port
(FTP) Đảo ngược vai trò trình khởi tạo / người nghe mặc định khi kết nối với FTP. Cái này
công tắc làm cho lọn tóc sử dụng chế độ hoạt động. Trong thực tế, curl sau đó yêu cầu máy chủ
kết nối lại với địa chỉ và cổng được chỉ định của khách hàng, trong khi chế độ thụ động yêu cầu
máy chủ để thiết lập địa chỉ IP và cổng để nó kết nối. Nên
là một trong số:

giao diện
tức là "eth0" để chỉ định địa chỉ IP của giao diện nào bạn muốn sử dụng (Unix
chỉ)

Địa chỉ IP
tức là "192.168.10.1" để chỉ định địa chỉ IP chính xác

tên máy chủ
tức là "my.host.domain" để chỉ định máy

- làm cho curl chọn cùng một địa chỉ IP đã được sử dụng cho điều khiển
liên quan

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng. Vô hiệu hóa việc sử dụng
CỔNG với --ftp-passv. Tắt nỗ lực sử dụng lệnh EPRT thay vì PORT
bằng cách sử dụng --disable-eprt. EPRT thực sự là PORT ++.

Bắt đầu từ 7.19.5, bạn có thể thêm ": [start] - [end]" vào bên phải địa chỉ, thành
cho curl biết phạm vi cổng TCP sẽ sử dụng. Điều đó có nghĩa là bạn chỉ định một phạm vi cổng, từ một
thấp hơn đến một số cao hơn. Một số duy nhất cũng hoạt động, nhưng lưu ý rằng nó
làm tăng nguy cơ hỏng hóc vì cảng có thể không khả dụng.

--đi qua
(SSL / SSH) Cụm mật khẩu cho khóa cá nhân

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--đường dẫn nguyên trạng
Yêu cầu curl không xử lý các chuỗi /../ or /. / trong đường dẫn URL đã cho. Thông thường
curl sẽ làm bí hoặc hợp nhất chúng theo tiêu chuẩn nhưng với tùy chọn này, bạn sẽ
bảo nó đừng làm thế.

(Đã thêm vào 7.42.0)

--post301
(HTTP) Yêu cầu curl tôn trọng RFC 7230 / 6.4.2 và không chuyển đổi yêu cầu POST thành GET
yêu cầu khi đi theo chuyển hướng 301. Hành vi không phải RFC phổ biến ở
trình duyệt web, do đó, curl thực hiện chuyển đổi theo mặc định để duy trì tính nhất quán.
Tuy nhiên, máy chủ có thể yêu cầu POST vẫn là POST sau khi chuyển hướng như vậy.
Tùy chọn này chỉ có ý nghĩa khi sử dụng -L, --vị trí (Đã thêm vào 7.17.1)

--post302
(HTTP) Yêu cầu curl tôn trọng RFC 7230 / 6.4.3 và không chuyển đổi yêu cầu POST thành GET
yêu cầu khi đi theo chuyển hướng 302. Hành vi không phải RFC phổ biến ở
trình duyệt web, do đó, curl thực hiện chuyển đổi theo mặc định để duy trì tính nhất quán.
Tuy nhiên, máy chủ có thể yêu cầu POST vẫn là POST sau khi chuyển hướng như vậy.
Tùy chọn này chỉ có ý nghĩa khi sử dụng -L, --vị trí (Đã thêm vào 7.19.1)

--post303
(HTTP) Yêu cầu curl tôn trọng RFC 7230 / 6.4.4 và không chuyển đổi yêu cầu POST thành GET
yêu cầu khi đi theo chuyển hướng 303. Hành vi không phải RFC phổ biến ở
trình duyệt web, do đó, curl thực hiện chuyển đổi theo mặc định để duy trì tính nhất quán.
Tuy nhiên, máy chủ có thể yêu cầu POST vẫn là POST sau khi chuyển hướng như vậy.
Tùy chọn này chỉ có ý nghĩa khi sử dụng -L, --vị trí (Đã thêm vào 7.26.0)

--proto
Yêu cầu curl sử dụng các giao thức được liệt kê để truy xuất ban đầu. Các giao thức là
được đánh giá từ trái sang phải, được phân tách bằng dấu phẩy và mỗi tên giao thức hoặc
'tất cả', có tiền tố tùy chọn bằng XNUMX hoặc nhiều bổ ngữ. Các công cụ sửa đổi có sẵn là:

+ Cho phép giao thức này ngoài các giao thức đã được cho phép (đây là
mặc định nếu không có sửa đổi nào được sử dụng).

- Từ chối giao thức này, xóa nó khỏi danh sách các giao thức đã được cho phép.

= Chỉ cho phép giao thức này (bỏ qua danh sách đã được cho phép), mặc dù chủ đề
để sửa đổi sau bằng các mục tiếp theo trong danh sách được phân tách bằng dấu phẩy.

Ví dụ:

--proto -ftps sử dụng các giao thức mặc định, nhưng vô hiệu hóa ftps

--proto -tất cả, https, + http
chỉ bật http và https

--proto = http, https
cũng chỉ bật http và https

Các giao thức không xác định tạo ra một cảnh báo. Điều này cho phép các tập lệnh an toàn dựa vào
có thể vô hiệu hóa các giao thức nguy hiểm tiềm ẩn mà không cần dựa vào sự hỗ trợ
giao thức đó đang được tích hợp vào curl để tránh lỗi.

Tùy chọn này có thể được sử dụng nhiều lần, trong trường hợp đó, hiệu quả giống như
nối các giao thức vào một phiên bản của tùy chọn.

(Đã thêm vào 7.20.2)

--proto-default
Cho curl sử dụng giao thức cho bất kỳ URL nào thiếu tên lược đồ.

Ví dụ:

--proto-mặc định https ftp.mozilla.org
https://ftp.mozilla.org

Giao thức không xác định hoặc không được hỗ trợ gây ra lỗi CURLE_UNSUPPORTED_PROTOCOL.

Tùy chọn này không thay đổi giao thức proxy mặc định (http).

Nếu không có tùy chọn này, curl sẽ đưa ra phỏng đoán dựa trên máy chủ, hãy xem --url để biết thêm chi tiết.

(Đã thêm vào 7.45.0)

--proto-redir
Yêu cầu curl sử dụng các giao thức được liệt kê khi chuyển hướng. Xem --proto để biết cách giao thức
Được đại diện.

Ví dụ:

--proto-redir -all, http, https
Chỉ cho phép HTTP và HTTPS khi chuyển hướng.

Theo mặc định, curl sẽ cho phép tất cả các giao thức chuyển hướng ngoại trừ một số giao thức bị vô hiệu hóa để bảo mật
lý do: Vì 7.19.4 FILE và SCP bị vô hiệu hóa, và vì 7.40.0 SMB và SMBS cũng bị
Vô hiệu hóa. Xác định tất cả các or + tất cả cho phép tất cả các giao thức trên chuyển hướng, bao gồm cả những
bị vô hiệu hóa để bảo mật.

(Đã thêm vào 7.20.2)

--proxy-anyauth
Yêu cầu curl chọn một phương pháp xác thực phù hợp khi giao tiếp với
proxy đã cho. Điều này có thể gây ra thêm một yêu cầu / phản hồi khứ hồi. (Đã thêm vào
7.13.2)

--proxy-cơ bản
Yêu cầu curl sử dụng xác thực HTTP cơ bản khi giao tiếp với
Ủy quyền. Sử dụng --căn bản để bật HTTP Basic với máy chủ từ xa. Cơ bản là mặc định
phương pháp xác thực curl sử dụng với proxy.

--proxy-thông báo
Yêu cầu curl sử dụng xác thực Thông báo HTTP khi giao tiếp với
Ủy quyền. Sử dụng --tiêu để bật Thông báo HTTP với máy chủ từ xa.

- thương lượng ủy quyền
Yêu cầu curl sử dụng xác thực Thương lượng HTTP (SPNEGO) khi giao tiếp với
proxy đã cho. Sử dụng --đàm phán để bật Thương lượng HTTP (SPNEGO) bằng điều khiển từ xa
tổ chức. (Đã thêm vào 7.17.1)

--proxy-ntlm
Yêu cầu curl sử dụng xác thực NTLM HTTP khi giao tiếp với proxy đã cho.
Sử dụng --ntlm để bật NTLM với máy chủ từ xa.

- proxy-service-name
Tùy chọn này cho phép bạn thay đổi tên dịch vụ để thương lượng proxy.

Ví dụ: - proxy-thương lượng proxy-tên - proxy-service-name sockd sẽ sử dụng
sockd / proxy-name. (Đã thêm vào 7.43.0).

--proxy1.0
Sử dụng proxy HTTP 1.0 được chỉ định. Nếu số cổng không được chỉ định, nó là
giả định ở cổng 1080.

Sự khác biệt duy nhất giữa tùy chọn này và tùy chọn proxy HTTP (-NS, --Ủy quyền), đó là
cố gắng sử dụng CONNECT thông qua proxy sẽ chỉ định giao thức HTTP 1.0 thay thế
của HTTP 1.1 mặc định.

--pubkey
(SSH) Tên tệp khóa công khai. Cho phép bạn cung cấp khóa công khai của mình trong phần riêng biệt này
tập tin.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

(Kể từ 7.39.0, curl cố gắng tự động trích xuất khóa công khai từ
tệp khóa cá nhân, vì vậy việc chuyển tùy chọn này thường không bắt buộc. Lưu ý rằng điều này
trích xuất khóa công khai yêu cầu libcurl phải được liên kết với một bản sao của libssh2 1.2.8
hoặc cao hơn được liên kết với OpenSSL.)

-q Nếu được sử dụng làm tham số đầu tiên trên dòng lệnh, cuộn tròn tập tin cấu hình sẽ không
được đọc và sử dụng. Xem -K, --config để biết chi tiết về tệp cấu hình mặc định
đường dẫn tìm kiếm.

-Q, - trích dẫn
(FTP / SFTP) Gửi một lệnh tùy ý đến máy chủ FTP hoặc SFTP từ xa. Trích dẫn
các lệnh được gửi TRƯỚC khi quá trình chuyển diễn ra (ngay sau khi PWD ban đầu
chính xác là trong quá trình chuyển FTP). Để thực hiện các lệnh diễn ra sau một
chuyển khoản thành công, hãy đặt trước chúng bằng dấu gạch ngang '-'. Để thực hiện các lệnh được gửi sau
curl đã thay đổi thư mục làm việc, ngay trước (các) lệnh chuyển, tiền tố
lệnh có dấu '+' (điều này chỉ được hỗ trợ cho FTP). Bạn có thể chỉ định bất kỳ số nào
của các lệnh. Nếu máy chủ trả về lỗi cho một trong các lệnh, toàn bộ
hoạt động sẽ bị hủy bỏ. Bạn phải gửi các lệnh FTP chính xác về mặt cú pháp dưới dạng RFC
959 định nghĩa cho máy chủ FTP hoặc một trong các lệnh được liệt kê bên dưới đối với máy chủ SFTP.
Tùy chọn này có thể được sử dụng nhiều lần. Khi nói chuyện với máy chủ FTP, hãy đặt tiền tố
lệnh có dấu hoa thị (*) để tiếp tục cuộn ngay cả khi lệnh không thành công
curl mặc định sẽ dừng lại ở lần thất bại đầu tiên.

SFTP là một giao thức nhị phân. Không giống như FTP, curl diễn giải các lệnh trích dẫn SFTP
chính nó trước khi gửi chúng đến máy chủ. Tên tệp có thể được trích dẫn kiểu shell thành
nhúng dấu cách hoặc ký tự đặc biệt. Sau đây là danh sách tất cả SFTP được hỗ trợ
câu lệnh trích dẫn:

tệp nhóm chgrp
Lệnh chgrp đặt ID nhóm của tệp được đặt tên bởi toán hạng tệp thành
ID nhóm được chỉ định bởi toán hạng nhóm. Toán hạng của nhóm là một số thập phân
ID nhóm số nguyên.

tệp chế độ chmod
Lệnh chmod sửa đổi các bit chế độ tệp của tệp được chỉ định. Các
toán hạng chế độ là một số chế độ số nguyên bát phân.

tệp người dùng băm nhỏ
Lệnh chown đặt chủ sở hữu của tệp được đặt tên bởi toán hạng tệp thành
ID người dùng được chỉ định bởi toán hạng người dùng. Toán hạng người dùng là một số thập phân
ID người dùng số nguyên.

Trong source_file target_file
Lệnh ln và liên kết biểu tượng tạo một liên kết tượng trưng tại target_file
vị trí trỏ đến vị trí source_file.

mkdir tên_thư_mục
Lệnh mkdir tạo thư mục được đặt tên bởi toán hạng directory_name.

pwd Lệnh pwd trả về tên đường dẫn tuyệt đối của hoạt động hiện tại
thư mục.

đổi tên mục tiêu nguồn
Lệnh đổi tên đổi tên tệp hoặc thư mục được đặt tên bởi toán hạng nguồn
đến đường dẫn đích được đặt tên bởi toán hạng đích.

tập tin rm
Lệnh rm loại bỏ tệp được chỉ định bởi toán hạng tệp.

thư mục rmdir
Lệnh rmdir loại bỏ mục nhập thư mục được chỉ định bởi thư mục
toán hạng, miễn là nó trống.

liên kết mã nguồn_tệp target_file
Xem ln.

-r, --range
(HTTP / FTP / SFTP / FILE) Lấy một dải byte (tức là một phần tài liệu) từ một
Máy chủ HTTP / 1.1, FTP hoặc SFTP hoặc một FILE cục bộ. Phạm vi có thể được chỉ định bằng một số
các cách.

0-499 chỉ định 500 byte đầu tiên

500-999 chỉ định 500 byte thứ hai

-500 chỉ định 500 byte cuối cùng

9500- chỉ định các byte từ độ lệch 9500 và chuyển tiếp

0-0, -1 chỉ định byte đầu tiên và chỉ byte cuối cùng (*) (HTTP)

100-199,500-599
chỉ định hai phạm vi 100 byte riêng biệt (*) (HTTP)

(*) = LƯU Ý rằng điều này sẽ khiến máy chủ trả lời bằng phản hồi nhiều phần!

Chỉ các ký tự chữ số (0-9) mới hợp lệ trong trường 'bắt đầu' và 'dừng' của
cú pháp phạm vi 'start-stop'. Nếu một ký tự không phải chữ số được đưa ra trong phạm vi, thì
phản hồi của máy chủ sẽ không xác định, tùy thuộc vào cấu hình của máy chủ.

Bạn cũng nên biết rằng nhiều máy chủ HTTP / 1.1 không có tính năng này
được bật, để khi bạn cố gắng lấy một phạm vi, thay vào đó bạn sẽ nhận được toàn bộ
tài liệu.

Tải xuống phạm vi FTP và SFTP chỉ hỗ trợ cú pháp 'start-stop' đơn giản
(tùy chọn với một trong các số bị bỏ qua). Việc sử dụng FTP phụ thuộc vào FTP mở rộng
lệnh SIZE.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-R, - ghi nhớ thời gian
Khi được sử dụng, điều này sẽ làm cho curl cố gắng tìm ra dấu thời gian của điều khiển từ xa
và nếu có sẵn, hãy làm cho tệp cục bộ có cùng dấu thời gian đó.

--random-file
(SSL) Chỉ định tên đường dẫn đến tệp chứa những gì sẽ được coi là ngẫu nhiên
dữ liệu. Dữ liệu được sử dụng để khởi tạo công cụ ngẫu nhiên cho các kết nối SSL. Xem thêm
--egd-tệp tùy chọn.

--raw (HTTP) Khi được sử dụng, nó sẽ tắt tất cả giải mã HTTP nội bộ của nội dung hoặc truyền
các mã hóa và thay vào đó làm cho chúng được chuyển sang dạng thô, không thay đổi. (Đã thêm vào 7.16.2)

--remote-name-all
Tùy chọn này thay đổi hành động mặc định cho tất cả các URL nhất định được xử lý như thể
-Ồ, --tên từ xa đã được sử dụng cho mỗi cái. Vì vậy, nếu bạn muốn tắt điều đó cho một
URL cụ thể sau --remote-name-all đã được sử dụng, bạn phải sử dụng "-o -" hoặc --không-
tên từ xa. (Đã thêm vào 7.19.0)

--giải quyết
Cung cấp địa chỉ tùy chỉnh cho một cặp máy chủ và cổng cụ thể. Sử dụng cái này, bạn có thể
thực hiện (các) yêu cầu curl sử dụng một địa chỉ được chỉ định và ngăn chặn
địa chỉ thường được giải quyết để được sử dụng. Hãy coi nó là một loại / Etc / hosts thay thế
được cung cấp trên dòng lệnh. Số cổng phải là số được sử dụng cho
giao thức cụ thể mà máy chủ sẽ được sử dụng. Nó có nghĩa là bạn cần một số mục nhập nếu
bạn muốn cung cấp địa chỉ cho cùng một máy chủ lưu trữ nhưng các cổng khác nhau.

Tùy chọn này có thể được sử dụng nhiều lần để thêm nhiều tên máy chủ để phân giải.

(Đã thêm vào 7.21.3)

--thử lại
Nếu lỗi tạm thời được trả lại khi curl cố gắng thực hiện chuyển, nó sẽ
thử lại số lần này trước khi bỏ cuộc. Đặt số thành 0 làm cho cuộn tròn
không thử lại (là mặc định). Lỗi tạm thời có nghĩa là: hết thời gian chờ, FTP
Mã phản hồi 4xx hoặc mã phản hồi HTTP 5xx.

Khi curl chuẩn bị thử chuyển lại, trước tiên nó sẽ đợi một giây, sau đó cho
tất cả các lần thử lại sắp tới sẽ tăng gấp đôi thời gian chờ cho đến khi đạt 10 phút
sau đó sẽ là độ trễ giữa các lần thử lại còn lại. Bằng cách sử dụng --thử lại-
chậm trễ bạn vô hiệu hóa thuật toán dự phòng theo cấp số nhân này. Xem thêm --thử lại-thời gian tối đa đến
giới hạn tổng thời gian cho phép để thử lại. (Đã thêm vào 7.12.3)

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--retry-delay
Đặt curl sleep trong khoảng thời gian này trước mỗi lần thử lại khi chuyển không thành công
với một lỗi thoáng qua (nó thay đổi thuật toán thời gian chờ mặc định giữa
thử lại). Tùy chọn này chỉ thú vị nếu --thử lại cũng được sử dụng. Đặt cái này
trễ về 7.12.3 sẽ làm cho curl sử dụng thời gian chờ mặc định. (Đã thêm vào XNUMX)

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--retry-max-time
Bộ hẹn giờ thử lại được đặt lại trước lần thử chuyển đầu tiên. Thử lại sẽ được thực hiện như
bình thường (xem --thử lại) miễn là bộ hẹn giờ chưa đạt đến giới hạn đã cho này. Lưu ý
rằng nếu bộ hẹn giờ chưa đạt đến giới hạn, yêu cầu sẽ được thực hiện và trong khi
thực hiện, có thể mất nhiều thời gian hơn khoảng thời gian nhất định này. Để hạn chế một
yêu cầu thời gian tối đa, sử dụng -NS, - thời gian tối đa. Đặt tùy chọn này thành XNUMX để không hết thời gian chờ
thử lại. (Đã thêm vào 7.12.3)

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-s, --im lặng
Chế độ im lặng hoặc không ồn. Không hiển thị đồng hồ đo tiến trình hoặc thông báo lỗi. Làm xoăn
người câm. Nó vẫn sẽ xuất ra dữ liệu bạn yêu cầu, thậm chí có thể cho
terminal / stdout trừ khi bạn chuyển hướng nó.

--sasl-ir
Bật phản hồi ban đầu trong xác thực SASL. (Đã thêm vào 7.31.0)

--Tên dịch vụ
Tùy chọn này cho phép bạn thay đổi tên dịch vụ cho SPNEGO.

Ví dụ: - thương lượng --Tên dịch vụ sockd sẽ sử dụng sockd / server-name. (Đã thêm vào
7.43.0).

-S, --show-lỗi
Khi sử dụng với -s nó làm cho curl hiển thị một thông báo lỗi nếu nó không thành công.

--ssl (FTP, POP3, IMAP, SMTP) Cố gắng sử dụng SSL / TLS cho kết nối. Hoàn nguyên thành không
kết nối an toàn nếu máy chủ không hỗ trợ SSL / TLS. Xem thêm --ftp-ssl-
điều khiển và --ssl-reqd cho các cấp độ mã hóa khác nhau được yêu cầu. (Đã thêm vào
7.20.0)

Tùy chọn này trước đây được gọi là --ftp-ssl (Đã thêm vào 7.11.0). Tên tùy chọn đó có thể
vẫn được sử dụng nhưng sẽ bị xóa trong một phiên bản trong tương lai.

--ssl-reqd
(FTP, POP3, IMAP, SMTP) Yêu cầu SSL / TLS cho kết nối. Chấm dứt
kết nối nếu máy chủ không hỗ trợ SSL / TLS. (Đã thêm vào 7.20.0)

Tùy chọn này trước đây được gọi là --ftp-ssl-reqd (được bổ sung trong 7.15.5). Tùy chọn đó
tên vẫn có thể được sử dụng nhưng sẽ bị xóa trong một phiên bản trong tương lai.

--ssl-allow-Beast
(SSL) Tùy chọn này yêu cầu curl không hoạt động xung quanh một lỗ hổng bảo mật trong SSL3 và
Giao thức TLS1.0 được gọi là BEAST. Nếu tùy chọn này không được sử dụng, lớp SSL có thể sử dụng
các giải pháp thay thế được biết là gây ra sự cố về khả năng tương tác với một số SSL cũ hơn
triển khai. CẢNH BÁO: tùy chọn này nới lỏng bảo mật SSL và bằng cách sử dụng
cờ bạn yêu cầu chính xác điều đó. (Đã thêm vào 7.25.0)

--ssl-không-thu hồi
(WinSSL) Tùy chọn này yêu cầu curl tắt kiểm tra việc thu hồi chứng chỉ. CẢNH BÁO:
tùy chọn này nới lỏng bảo mật SSL và bằng cách sử dụng cờ này, bạn yêu cầu chính xác
điều đó. (Đã thêm vào 7.44.0)

- tất 4
Sử dụng proxy SOCKS4 được chỉ định. Nếu số cổng không được chỉ định, nó được giả định là
tại cổng 1080. (Đã thêm vào 7.15.2)

Tùy chọn này ghi đè bất kỳ việc sử dụng nào trước đây của -NS, --Ủy quyền, vì chúng là của nhau
độc quyền.

Kể từ 7.21.7, tùy chọn này là không cần thiết vì bạn có thể chỉ định proxy vớ4 với
-NS, --Ủy quyền sử dụng tiền tố giao thức vớ4: //.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--socks4a
Sử dụng proxy SOCKS4a được chỉ định. Nếu số cổng không được chỉ định, nó được giả định là
tại cổng 1080. (Đã thêm vào 7.18.0)

Tùy chọn này ghi đè bất kỳ việc sử dụng nào trước đây của -NS, --Ủy quyền, vì chúng là của nhau
độc quyền.

Kể từ 7.21.7, tùy chọn này là không cần thiết vì bạn có thể chỉ định proxy vớ4a với
-NS, --Ủy quyền sử dụng tiền tố giao thức vớ4a: //.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--socks5-tên máy chủ
Sử dụng proxy SOCKS5 được chỉ định (và để proxy phân giải tên máy chủ). Nếu
số cổng không được chỉ định, nó được giả định là ở cổng 1080. (Đã thêm vào 7.18.0)

Tùy chọn này ghi đè bất kỳ việc sử dụng nào trước đây của -NS, --Ủy quyền, vì chúng là của nhau
độc quyền.

Kể từ 7.21.7, tùy chọn này là thừa vì bạn có thể chỉ định tên máy chủ vớ5
proxy với -NS, --Ủy quyền sử dụng tiền tố giao thức vớ5h: //.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng. (Tùy chọn này là
trước đó đã được lập thành tài liệu sai và được sử dụng làm - tất mà không có số được thêm vào.)

- tất 5
Sử dụng proxy SOCKS5 được chỉ định - nhưng phân giải cục bộ tên máy chủ. Nếu cảng
số không được chỉ định, nó được giả định là ở cổng 1080.

Tùy chọn này ghi đè bất kỳ việc sử dụng nào trước đây của -NS, --Ủy quyền, vì chúng là của nhau
độc quyền.

Kể từ 7.21.7, tùy chọn này là không cần thiết vì bạn có thể chỉ định proxy vớ5 với
-NS, --Ủy quyền sử dụng tiền tố giao thức vớ5: //.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng. (Tùy chọn này là
trước đó đã được lập thành tài liệu sai và được sử dụng làm - tất mà không có số được thêm vào.)

Tùy chọn này (cũng như - tất 4) không hoạt động với IPV6, FTPS hoặc LDAP.

--socks5-gssapi-service
Tên dịch vụ mặc định cho máy chủ vớ là rcmd / server-fqdn. Tùy chọn này cho phép
bạn để thay đổi nó.

Ví dụ: --socks5 proxy-name --socks5-gssapi-service sockd sẽ sử dụng sockd / proxy-
tên --socks5 proxy-name --socks5-gssapi-service sockd / tên thật sẽ sử dụng
sockd / real-name cho các trường hợp tên proxy không khớp với tên chính.
(Đã thêm vào 7.19.4).

--socks5-gssapi-ne
Là một phần của thương lượng GSS-API, một chế độ bảo vệ được thương lượng. RFC 1961 nói
trong phần 4.3 / 4.4 nó cần được bảo vệ, nhưng việc triển khai tài liệu tham khảo NEC
không làm. Các tùy chọn --socks5-gssapi-ne cho phép trao đổi không được bảo vệ của
đàm phán chế độ bảo vệ. (Đã thêm vào 7.19.4).

--stderr
Thay vào đó, hãy chuyển hướng tất cả ghi vào stderr đến tệp được chỉ định. Nếu tên tệp là
trơn '-', thay vào đó nó được viết thành stdout.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-t, --telnet-option
Chuyển các tùy chọn cho giao thức telnet. Các tùy chọn được hỗ trợ là:

TTYPE = Đặt loại thiết bị đầu cuối.

XDISPLOC = Đặt vị trí hiển thị X.

NEW_ENV = Đặt một biến môi trường.

-T, - tải lên-tệp
Thao tác này chuyển tệp cục bộ được chỉ định sang URL từ xa. Nếu không có phần tệp
trong URL được chỉ định, Curl sẽ nối tên tệp cục bộ. LƯU Ý rằng bạn phải sử dụng
dấu / trên thư mục cuối cùng để thực sự chứng minh với Curl rằng không có tệp
name or curl sẽ nghĩ rằng tên thư mục cuối cùng của bạn là tên tệp từ xa
sử dụng. Điều đó rất có thể sẽ khiến hoạt động tải lên không thành công. Nếu điều này được sử dụng trên
máy chủ HTTP (S), lệnh PUT sẽ được sử dụng.

Sử dụng tên tệp "-" (một dấu gạch ngang) để sử dụng stdin thay vì một tệp nhất định.
Ngoài ra, tên tệp "." (một dấu chấm) có thể được chỉ định thay vì "-" thành
sử dụng stdin ở chế độ không chặn để cho phép đọc đầu ra của máy chủ trong khi stdin đang được
tải lên.

Bạn có thể chỉ định một -T cho mỗi URL trên dòng lệnh. Mỗi cặp URL -T +
chỉ định những gì sẽ tải lên và ở đâu. curl cũng hỗ trợ "Globbing" của -T
đối số, nghĩa là bạn có thể tải nhiều tệp lên một URL duy nhất bằng cách sử dụng
cùng một kiểu hiển thị URL được hỗ trợ trong URL, như thế này:

curl -T "{file1, file2}" http://www.uploadtothissite.com

hoặc thậm chí

curl -T "img [1-1000] .png" loading = "lazy" ftp://ftp.picturemania.com/upload/

--tcp-gật gù
Bật tùy chọn TCP_NODELAY. Xem Curl_easy_setopt(3) trang người đàn ông để biết chi tiết
về tùy chọn này. (Đã thêm vào 7.11.2)

--tftp-blksize
(TFTP) Đặt tùy chọn TFTP BLKSIZE (phải> 512). Đây là kích thước khối cuộn tròn
sẽ cố gắng sử dụng khi truyền dữ liệu đến hoặc từ máy chủ TFTP. Theo mặc định 512
byte sẽ được sử dụng.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

(Đã thêm vào 7.20.0)

--tlsauthtype
Đặt loại xác thực TLS. Hiện tại, tùy chọn được hỗ trợ duy nhất là "SRP", dành cho
TLS-SRP (RFC 5054). Nếu như --tlsuser và --tlsmật khẩu được chỉ định nhưng --tlsauthtype
không, thì tùy chọn này mặc định là "SRP". (Đã thêm vào 7.21.4)

--tlspassword
Đặt mật khẩu để sử dụng với phương thức xác thực TLS được chỉ định với
--tlsauthtype. Yêu cầu điều đó --tlsuser cũng được thiết lập. (Đã thêm vào 7.21.4)

--tlsuser
Đặt tên người dùng để sử dụng với phương thức xác thực TLS được chỉ định với
--tlsauthtype. Yêu cầu điều đó --tlsmật khẩu cũng được thiết lập. (Đã thêm vào 7.21.4)

--tlsv1.0
(SSL) Buộc sử dụng TLS phiên bản 1.0 khi thương lượng với máy chủ TLS từ xa.
(Đã thêm vào 7.34.0)

--tlsv1.1
(SSL) Buộc sử dụng TLS phiên bản 1.1 khi thương lượng với máy chủ TLS từ xa.
(Đã thêm vào 7.34.0)

--tlsv1.2
(SSL) Buộc sử dụng TLS phiên bản 1.2 khi thương lượng với máy chủ TLS từ xa.
(Đã thêm vào 7.34.0)

- mã hóatr
(HTTP) Yêu cầu phản hồi Mã hóa chuyển được nén bằng cách sử dụng một trong các thuật toán
curl hỗ trợ và giải nén dữ liệu trong khi nhận nó.

(Đã thêm vào 7.21.6)

--dấu vết
Cho phép kết xuất theo dõi đầy đủ tất cả dữ liệu đến và đi, bao gồm cả mô tả
thông tin đến tệp đầu ra đã cho. Sử dụng "-" làm tên tệp để gửi kết quả đầu ra
sang stdout.

Tùy chọn này ghi đè các lần sử dụng trước đây của -v, --dài dòng or --trace-ascii.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--trace-ascii
Cho phép kết xuất theo dõi đầy đủ tất cả dữ liệu đến và đi, bao gồm cả mô tả
thông tin đến tệp đầu ra đã cho. Sử dụng "-" làm tên tệp để gửi kết quả đầu ra
sang stdout.

Điều này rất giống với --dấu vết, nhưng bỏ đi phần hex và chỉ hiển thị
ASCII một phần của bãi chứa. Nó tạo ra đầu ra nhỏ hơn có thể dễ đọc hơn
con người chưa qua đào tạo.

Tùy chọn này ghi đè các lần sử dụng trước đây của -v, --dài dòng or --dấu vết.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

- thời gian
Thêm dấu thời gian vào từng dấu vết hoặc dòng dài ngoằn ngoèo hiển thị. (Đã thêm vào
7.14.0)

- ổ cắm đơn vị
(HTTP) Kết nối thông qua ổ cắm miền Unix này, thay vì sử dụng mạng.
(Đã thêm vào 7.40.0)

-u, - người dùng
Chỉ định tên người dùng và mật khẩu để sử dụng cho xác thực máy chủ. Ghi đè -N,
--netrc và --netrc-tùy chọn.

Nếu bạn chỉ cần chỉ định tên người dùng, curl sẽ nhắc nhập mật khẩu.

Tên người dùng và mật khẩu được phân tách trên dấu hai chấm đầu tiên, điều này làm cho nó
Không thể sử dụng dấu hai chấm trong tên người dùng với tùy chọn này. Mật khẩu có thể,
vẫn.

Khi sử dụng Kerberos V5 với máy chủ dựa trên Windows, bạn nên bao gồm Windows
tên miền trong tên người dùng, để máy chủ lấy được thành công
Vé Kerberos. Nếu bạn không làm vậy thì quá trình bắt tay xác thực ban đầu có thể không thành công.

Khi sử dụng NTLM, tên người dùng có thể được chỉ định đơn giản là tên người dùng, không có
miền, ví dụ: nếu có một miền và khu rừng trong thiết lập của bạn.

Để chỉ định tên miền, hãy sử dụng Tên đăng nhập cấp thấp hoặc UPN (Người dùng chính
Tên) các định dạng. Ví dụ: EXAMPLE \ user và [email được bảo vệ] tương ứng.

Nếu bạn sử dụng tệp nhị phân curl có hỗ trợ SSPI của Windows và thực hiện Kerberos V5, Negotiate,
Xác thực NTLM hoặc Digest sau đó bạn có thể yêu cầu curl chọn tên người dùng và
mật khẩu từ môi trường của bạn bằng cách chỉ định một dấu hai chấm với tùy chọn này: "-u
: ".

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-U, - người dùng proxy
Chỉ định tên người dùng và mật khẩu để sử dụng cho xác thực proxy.

Nếu bạn sử dụng tệp nhị phân curl hỗ trợ SSPI của Windows và thực hiện Thương lượng hoặc NTLM
xác thực thì bạn có thể yêu cầu curl chọn tên người dùng và mật khẩu từ
môi trường của bạn bằng cách chỉ định một dấu hai chấm với tùy chọn này: "-U:".

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--url
Chỉ định một URL để tìm nạp. Tùy chọn này chủ yếu hữu ích khi bạn muốn chỉ định (các) URL
trong một tệp cấu hình.

Nếu URL đã cho thiếu tên lược đồ (chẳng hạn như "http: //" hoặc "ftp: //", v.v.) thì
curl sẽ đưa ra phỏng đoán dựa trên người dẫn chương trình. Nếu tên miền phụ ngoài cùng trùng khớp
DICT, FTP, IMAP, LDAP, POP3 hoặc SMTP thì giao thức đó sẽ được sử dụng, nếu không thì HTTP
sẽ được sử dụng. Vì đoán 7.45.0 có thể bị vô hiệu hóa bằng cách đặt giao thức mặc định,
xem --proto-mặc định để biết thêm chi tiết.

Tùy chọn này có thể được sử dụng bất kỳ số lần nào. Để kiểm soát nơi URL này được viết,
sử dụng -ồ, - đầu ra hoặc là -Ồ, --tên từ xa tùy chọn.

-v, --verbose
Nói dài dòng / nói nhiều hơn trong quá trình hoạt động. Hữu ích để gỡ lỗi và xem
những gì đang xảy ra "dưới mui xe". Một dòng bắt đầu bằng '>' có nghĩa là "dữ liệu tiêu đề" đã được gửi
by curl, '<' có nghĩa là "dữ liệu tiêu đề" nhận được bởi curl bị ẩn trong các trường hợp bình thường,
và một dòng bắt đầu bằng '*' có nghĩa là thông tin bổ sung được cung cấp bởi curl.

Lưu ý rằng nếu bạn chỉ muốn tiêu đề HTTP trong đầu ra, -tôi, --bao gồm có thể là
tùy chọn bạn đang tìm kiếm.

Nếu bạn cho rằng tùy chọn này vẫn không cung cấp cho bạn đủ thông tin chi tiết, hãy cân nhắc sử dụng
--dấu vết or --trace-ascii thay thế.

Tùy chọn này ghi đè các lần sử dụng trước đây của --trace-ascii or --dấu vết.

Sử dụng -S, --im lặng để làm cho cuộn tóc yên tĩnh.

-w, --write-out
Tạo thông tin hiển thị cuộn tròn trên stdout sau khi chuyển xong. Định dạng là một
chuỗi có thể chứa văn bản thuần túy trộn với bất kỳ số lượng biến nào. Định dạng
có thể được chỉ định dưới dạng "chuỗi" theo nghĩa đen hoặc bạn có thể yêu cầu curl đọc định dạng từ
tệp có "@filename" và để yêu cầu curl đọc định dạng từ stdin bạn viết
"@ -".

Các biến có trong định dạng đầu ra sẽ được thay thế bằng giá trị hoặc văn bản
lọn tóc đó cho rằng phù hợp, như được mô tả bên dưới. Tất cả các biến được chỉ định là
% {variable_name} và để xuất ra một% bình thường, bạn chỉ cần viết chúng là %%. Bạn có thể xuất
một dòng mới bằng cách sử dụng \ n, một dấu xuống dòng với \ r và một dấu cách tab bằng \ t.

LƯU Ý: % -Symbol là một biểu tượng đặc biệt trong môi trường win32, nơi tất cả
số lần xuất hiện% phải được nhân đôi khi sử dụng tùy chọn này.

Các biến có sẵn là:

nội dung_type Loại-Nội dung của tài liệu được yêu cầu, nếu có.

tên tệp_hiệu quả
Tên tệp cuối cùng mà curl ghi ra. Đây chỉ là
có ý nghĩa nếu curl được yêu cầu ghi vào một tệp với --tên từ xa
or - đầu ra Lựa chọn. Nó hữu ích nhất khi kết hợp với
--tên-tiêu đề từ xa Lựa chọn. (Đã thêm vào 7.25.1)

ftp_entry_path Đường dẫn ban đầu đã kết thúc khi đăng nhập vào FTP từ xa
người phục vụ. (Đã thêm vào 7.15.4)

http_code Mã phản hồi số được tìm thấy trong lần truy xuất cuối cùng
Truyền HTTP (S) hoặc FTP (các). Trong 7.18.2, bí danh mã phản hồi là
được thêm vào để hiển thị cùng một thông tin.

http_connect Mã số được tìm thấy trong phản hồi cuối cùng (từ một
proxy) cho một yêu cầu KẾT NỐI cuộn tròn. (Đã thêm vào 7.12.4)

local_ip Địa chỉ IP của đầu cục bộ của kết nối được thực hiện gần đây nhất
- có thể là IPv4 hoặc IPv6 (Đã thêm vào 7.29.0)

local_port Số cổng cục bộ của kết nối được thực hiện gần đây nhất (Đã thêm vào
7.29.0)

số_kết nối Số lượng kết nối mới được thực hiện trong lần chuyển giao gần đây. (Đã thêm vào
7.12.3)

num_redirect Số lần chuyển hướng được theo sau trong yêu cầu. (Đã thêm vào
7.12.3)

chuyển hướng URL Khi một yêu cầu HTTP được thực hiện mà không có L để theo dõi chuyển hướng, điều này
biến sẽ hiển thị URL thực sự là một chuyển hướng sẽ đưa bạn tới.
(Đã thêm vào 7.18.2)

remote_ip Địa chỉ IP từ xa của kết nối được thực hiện gần đây nhất - có thể là
IPv4 hoặc IPv6 (Đã thêm vào 7.29.0)

cổng_từ xa Số cổng từ xa của kết nối được thực hiện gần đây nhất (Đã thêm
năm 7.29.0)

kích thước_tải xuống Tổng số byte đã được tải xuống.

kích thước_header Tổng số byte của các tiêu đề đã tải xuống.

kích thước_request Tổng số byte đã được gửi trong yêu cầu HTTP.

kích thước_tải lên Tổng số byte đã được tải lên.

tốc_tải Tốc độ tải xuống trung bình được đo cho toàn bộ
Tải xuống. Byte trên giây.

tốc_tải Tốc độ tải lên trung bình được đo cho toàn bộ nội dung tải lên.
Byte trên giây.

ssl_verify_result
Kết quả của xác minh chứng chỉ ngang hàng SSL là
yêu cầu. 0 có nghĩa là xác minh đã thành công. (Đã thêm vào
7.19.0)

time_appconnect
Thời gian, tính bằng giây, từ lúc bắt đầu cho đến khi có SSL / SSH / v.v.
kết nối / bắt tay với máy chủ từ xa đã hoàn tất. (Đã thêm vào
7.19.0)

thời gian_kết nối Thời gian, tính bằng giây, từ lúc bắt đầu cho đến khi kết nối TCP
đến máy chủ từ xa (hoặc proxy) đã được hoàn tất.

time_namelookup
Thời gian, tính bằng giây, từ lúc bắt đầu cho đến khi tên
giải quyết đã hoàn thành.

thời gian_pretransfer
Thời gian, tính bằng giây, từ lúc bắt đầu cho đến khi chuyển tệp
sắp bắt đầu. Điều này bao gồm tất cả các lệnh chuyển trước và
đàm phán cụ thể cho (các) giao thức cụ thể
có tính liên quan.

time_redirect Thời gian tính bằng giây cho tất cả các bước chuyển hướng bao gồm tên
tra cứu, kết nối, chuyển trước và chuyển trước khi kết thúc
giao dịch đã được bắt đầu. time_redirect hiển thị toàn bộ quá trình thực thi
thời gian cho nhiều lần chuyển hướng. (Đã thêm vào 7.12.3)

time_starttransfer
Thời gian, tính bằng giây, từ lúc bắt đầu cho đến khi byte đầu tiên
sắp được chuyển giao. Điều này bao gồm time_pretransfer và
cũng là thời gian máy chủ cần để tính toán kết quả.

thời gian_tổng cộng Tổng thời gian, tính bằng giây, mà toàn bộ hoạt động kéo dài. Thời gian
sẽ được hiển thị với độ phân giải mili giây.

url_hiệu quả URL được tìm nạp lần cuối. Điều này có ý nghĩa nhất nếu bạn
đã nói với curl để theo dõi vị trí: tiêu đề.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-x, --proxy <[protocol: //] [user: password @] proxyhost [: port]>
Sử dụng proxy được chỉ định.

Chuỗi proxy có thể được chỉ định bằng tiền tố giao thức: // để chỉ định thay thế
giao thức proxy. Sử dụng vớ4: //, vớ4a: //, vớ5: // hoặc vớ5h: // để yêu cầu
phiên bản SOCKS cụ thể sẽ được sử dụng. Không có giao thức nào được chỉ định, http: // và tất cả các giao thức khác
sẽ được coi là proxy HTTP. (Hỗ trợ giao thức đã được thêm vào curl 7.21.7)

Nếu số cổng không được chỉ định trong chuỗi proxy, nó được giả định là 1080.

Tùy chọn này ghi đè các biến môi trường hiện có đặt proxy để sử dụng. Nếu như
có một biến môi trường đặt proxy, bạn có thể đặt proxy thành "" thành
ghi đè nó.

Tất cả các hoạt động được thực hiện qua proxy HTTP sẽ rõ ràng
được chuyển đổi sang HTTP. Có nghĩa là một số hoạt động cụ thể của giao thức nhất định có thể không
có sẵn. Đây không phải là trường hợp nếu bạn có thể chuyển qua proxy, như một proxy với
các -P, - đường hầm tùy chọn.

Người dùng và mật khẩu có thể được cung cấp trong chuỗi proxy là URL được giải mã bởi
Xoăn. Điều này cho phép bạn chuyển các ký tự đặc biệt như @ bằng cách sử dụng% 40 hoặc pass
trong dấu hai chấm có% 3a.

Máy chủ proxy có thể được chỉ định theo cách chính xác giống như môi trường proxy
các biến, bao gồm tiền tố giao thức (http: //) và người dùng được nhúng +
mật khẩu.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-X, - yêu cầu
(HTTP) Chỉ định một phương thức yêu cầu tùy chỉnh để sử dụng khi giao tiếp với HTTP
người phục vụ. Phương thức yêu cầu đã chỉ định sẽ được sử dụng thay vì phương thức khác
đã sử dụng (mặc định là GET). Đọc thông số kỹ thuật HTTP 1.1 để biết chi tiết và
những lời giải thích. Các yêu cầu HTTP bổ sung phổ biến bao gồm PUT và DELETE, nhưng có liên quan
các công nghệ như WebDAV cung cấp PROPFIND, COPY, MOVE và hơn thế nữa.

Thông thường bạn không cần tùy chọn này. Tất cả các loại yêu cầu GET, HEAD, POST và PUT
khá được gọi bằng cách sử dụng các tùy chọn dòng lệnh chuyên dụng.

Tùy chọn này chỉ thay đổi từ thực tế được sử dụng trong yêu cầu HTTP, nó không
thay đổi cách hoạt động của curl. Vì vậy, ví dụ: nếu bạn muốn tạo một HEAD thích hợp
yêu cầu, sử dụng -X HEAD sẽ không đủ. Bạn cần sử dụng -TÔI, --cái đầu tùy chọn.

Chuỗi phương thức bạn đặt với -X sẽ được sử dụng cho tất cả các yêu cầu, nếu bạn
sử dụng ví dụ -L, --vị trí có thể gây ra các tác dụng phụ ngoài ý muốn khi không uốn tóc
thay đổi phương thức yêu cầu theo mã phản hồi HTTP 30x - và tương tự.

(FTP) Chỉ định một lệnh FTP tùy chỉnh để sử dụng thay vì LIST khi thực hiện danh sách tệp
với FTP.

(POP3) Chỉ định một lệnh POP3 tùy chỉnh để sử dụng thay vì LIST hoặc RETR. (Đã thêm vào
7.26.0)

(IMAP) Chỉ định lệnh IMAP tùy chỉnh để sử dụng thay vì LIST. (Đã thêm vào 7.30.0)

(SMTP) Chỉ định một lệnh SMTP tùy chỉnh để sử dụng thay vì HELP hoặc VRFY. (Đã thêm vào
7.34.0)

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

--xattr
Khi lưu đầu ra vào một tệp, tùy chọn này yêu cầu curl lưu trữ một số siêu dữ liệu tệp nhất định
trong các thuộc tính tệp mở rộng. Hiện tại, URL được lưu trữ trong xdg.origin.url
và đối với HTTP, loại nội dung được lưu trữ trong thuộc tính mime_type. Nếu như
hệ thống tệp không hỗ trợ các thuộc tính mở rộng, một cảnh báo sẽ được đưa ra.

-y, -tốc độ-thời gian
Nếu tải xuống chậm hơn byte giới hạn tốc độ mỗi giây trong thời gian tốc độ
thời gian, quá trình tải xuống bị hủy bỏ. Nếu sử dụng thời gian tốc độ, giới hạn tốc độ mặc định
sẽ là 1 trừ khi được đặt bằng -Y.

Tùy chọn này kiểm soát quá trình truyền và do đó sẽ không ảnh hưởng đến kết nối chậm, v.v. Nếu điều này
là một mối quan tâm cho bạn, hãy thử - hết thời gian kết nối tùy chọn.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-Y, - giới hạn tốc độ
Nếu tải xuống chậm hơn tốc độ đã cho này (tính bằng byte / giây) đối với thời gian tốc độ
giây nó bị hủy bỏ. thời gian tốc độ được đặt với -y và là 30 nếu không được đặt.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-z, --time-cond |
(HTTP / FTP) Yêu cầu tệp đã được sửa đổi muộn hơn thời gian nhất định và
ngày, hoặc một ngày đã được sửa đổi trước thời điểm đó. Các có thể
tất cả các loại chuỗi ngày hoặc nếu nó không khớp với bất kỳ chuỗi bên trong nào, nó được coi là
tên tệp và cố gắng lấy ngày sửa đổi (mtime) từ thay thế. Nhìn thấy
các Curl_getdate(3) trang người đàn ông để biết chi tiết về biểu thức ngày tháng.

Bắt đầu biểu thức ngày tháng bằng một dấu gạch ngang (-) để làm cho nó yêu cầu một tài liệu
cũ hơn ngày / giờ đã cho, mặc định là tài liệu mới hơn
ngày / giờ xác định.

Nếu tùy chọn này được sử dụng nhiều lần, tùy chọn cuối cùng sẽ được sử dụng.

-h, - trợ giúp
Trợ giúp về cách sử dụng. Điều này liệt kê tất cả các tùy chọn dòng lệnh hiện tại với một mô tả ngắn.

-M, - thủ công
Thủ công. Hiển thị văn bản trợ giúp lớn.

-V, - phiên bản
Hiển thị thông tin về curl và phiên bản libcurl mà nó sử dụng.

Dòng đầu tiên bao gồm phiên bản đầy đủ của curl, libcurl và bên thứ 3 khác
thư viện được liên kết với tệp thực thi.

Dòng thứ hai (bắt đầu bằng "Giao thức:") hiển thị tất cả các giao thức mà libcurl báo cáo
hỗ trợ.

Dòng thứ ba (bắt đầu bằng "Tính năng:") hiển thị các tính năng cụ thể mà báo cáo libcurl
phục vụ. Các tính năng có sẵn bao gồm:

IPv6 Bạn có thể sử dụng IPv6 với cái này.

krb4 Krb4 cho FTP được hỗ trợ.

Các phiên bản SSL của các giao thức khác nhau được hỗ trợ, chẳng hạn như HTTPS, FTPS, POP3S
và như vậy.

libz Hỗ trợ giải nén tự động các tệp nén qua HTTP.

NTLM Xác thực NTLM được hỗ trợ.

Gỡ lỗi Chương trình này sử dụng một libcurl được xây dựng với Gỡ lỗi. Điều này cho phép theo dõi lỗi nhiều hơn
và gỡ lỗi bộ nhớ, v.v. Chỉ dành cho nhà phát triển curl!

AsynchDN
Curl này sử dụng giải quyết tên không đồng bộ. Các giải pháp tên không đồng bộ có thể được
được thực hiện bằng cách sử dụng c-ares hoặc phần phụ trợ của trình phân giải luồng.

Xác thực SPNEGO SPNEGO được hỗ trợ.

Lớn nhất
Curl này hỗ trợ truyền các tệp lớn, tệp lớn hơn 2GB.

IDN Curl này hỗ trợ IDN - tên miền quốc tế.

GSS-API
GSS-API được hỗ trợ.

SSPI SSPI được hỗ trợ.

TLS-SRP
Xác thực SRP (Mật khẩu từ xa an toàn) được hỗ trợ cho TLS.

Hỗ trợ HTTP2 HTTP / 2 đã được tích hợp sẵn.

kim loại
Curl này hỗ trợ Metalink (cả phiên bản 3 và 4 (RFC 5854)),
mô tả gương và hàm băm. curl sẽ sử dụng gương để chuyển đổi dự phòng nếu có
là lỗi (chẳng hạn như tệp hoặc máy chủ không khả dụng).

Sử dụng curl trực tuyến bằng các dịch vụ onworks.net