一篇文了解Linux命令cURL

参数1

参数2

说明

--anyauth

选择 "any" 认证方法 (H)

-a,

--append

添加要上传的文件 (F/SFTP)

--basic

使用HTTP基础认证（Basic Authentication）(H)

--cacert FILE

CA 证书，用于每次请求认证 (SSL)

--capath DIR

CA 证书目录 (SSL)

-E,

--cert CERT[:PASSWD]

客户端证书文件及密码 (SSL)

--cert-type TYPE

证书文件类型 (DER/PEM/ENG) (SSL)

--ciphers LIST

SSL 秘钥 (SSL)

--compressed

请求压缩 (使用 deflate 或 gzip)

-K,

--config FILE

指定配置文件

--connect-timeout SECONDS

连接超时设置

-C,

--continue-at OFFSET

断点续转

-b,

--cookie STRING/FILE

Cookies字符串或读取Cookies的文件位置 (H)

-c,

--cookie-jar FILE

操作结束后，要写入 Cookies 的文件位置 (H)

--create-dirs

创建必要的本地目录层次结构

--crlf

在上传时将 LF 转写为 CRLF

--crlfile FILE

从指定的文件获得PEM格式CRL列表

-d,

--data DATA

HTTP POST 数据 (H)

--data-ascii DATA  ASCII

编码 HTTP POST 数据 (H)

--data-binary DATA  binary

编码 HTTP POST 数据 (H)

--data-urlencode DATA  url

编码 HTTP POST 数据 (H)

--delegation STRING GSS-API

委托权限

--digest

使用数字身份验证 (H)

--disable-eprt

禁止使用 EPRT 或 LPRT (F)

--disable-epsv

禁止使用 EPSV (F)

-D,

--dump-header FILE

将头信息写入指定的文件

--egd-file FILE

为随机数据设置EGD socket路径(SSL)

--engine ENGINGE

加密引擎 (SSL). "--engine list" 指定列表

-f,

--fail

连接失败时不显示HTTP错误信息 (H)

-F,

--form CONTENT

模拟 HTTP 表单数据提交（multipart POST） (H)

--form-string STRING

模拟 HTTP 表单数据提交 (H)

--ftp-account DATA

帐户数据提交 (F)

--ftp-alternative-to-user COMMAND

指定替换 "USER [name]" 的字符串 (F)

--ftp-create-dirs

如果不存在则创建远程目录 (F)

--ftp-method [MULTICWD/NOCWD/SINGLECWD]

控制 CWD (F)

--ftp-pasv

使用 PASV/EPSV 替换 PORT (F)

-P,

--ftp-port ADR

使用指定 PORT 及地址替换 PASV (F)

--ftp-skip-pasv-ip

跳过 PASV 的IP地址 (F)

--ftp-pret

在 PASV 之前发送 PRET (drftpd) (F)

--ftp-ssl-ccc

在认证之后发送 CCC (F)

--ftp-ssl-ccc-mode ACTIVE/PASSIVE

设置 CCC 模式 (F)

--ftp-ssl-control ftp

登录时需要 SSL/TLS (F)

-G,

--get

使用 HTTP GET 方法发送 -d 数据  (H)

-g,

--globoff

禁用的 URL 队列 及范围使用 {} 和 []

-H,

--header LINE

要发送到服务端的自定义请求头 (H)

-I,

--head

仅显示响应文档头

-h,

--help

显示帮助

-0,

--http1.0

使用 HTTP 1.0 (H)

--ignore-content-length

忽略 HTTP Content-Length 头

-i,

--include

在输出中包含协议头 (H/F)

-k,

--insecure

允许连接到 SSL 站点，而不使用证书 (H)

--interface INTERFACE

指定网络接口／地址

-4,

--ipv4

将域名解析为 IPv4 地址

-6,

--ipv6

将域名解析为 IPv6 地址

-j,

--junk-session-cookies

读取文件中但忽略会话cookie (H)

--keepalive-time SECONDS

keepalive 包间隔

--key KEY

私钥文件名 (SSL/SSH)

--key-type TYPE

私钥文件类型 (DER/PEM/ENG) (SSL)

--krb LEVEL

启用指定安全级别的 Kerberos (F)

--libcurl FILE

命令的libcurl等价代码

--limit-rate RATE

限制传输速度

-l,

--list-only

只列出FTP目录的名称 (F)

--local-port RANGE

强制使用的本地端口号

-L,

--location

跟踪重定向 (H)

--location-trusted

类似  --location 并发送验证信息到其它主机 (H)

-M,

--manual

显示全手动

--mail-from FROM

从这个地址发送邮件

--mail-rcpt TO

发送邮件到这个接收人(s)

--mail-auth AUTH

原始电子邮件的起始地址

--max-filesize BYTES

下载的最大文件大小 (H/F)

--max-redirs NUM

最大重定向数 (H)

-m,

--max-time SECONDS

允许的最多传输时间

--metalink

处理指定的URL上的XML文件

--negotiate

使用 HTTP Negotiate 认证 (H)

-n,

--netrc

必须从 .netrc 文件读取用户名和密码

--netrc-optional

使用 .netrc 或 URL; 将重写 -n 参数

--netrc-file FILE

设置要使用的 netrc 文件名

-N,

--no-buffer

禁用输出流的缓存

--no-keepalive

禁用 connection 的 keepalive

--no-sessionid

禁止重复使用 SSL session-ID (SSL)

--noproxy

不使用代理的主机列表

--ntlm

使用 HTTP NTLM 认证 (H)

-o,

--output FILE

将输出写入文件，而非 stdout

--pass PASS

传递给私钥的短语 (SSL/SSH)

--post301

在 301 重定向后不要切换为 GET 请求 (H)

--post302

在 302 重定向后不要切换为 GET 请求 (H)

--post303

在 303 重定向后不要切换为 GET 请求 (H)

-#,

--progress-bar

以进度条显示传输进度

--proto PROTOCOLS

启用/禁用 指定的协议

--proto-redir PROTOCOLS

在重定向上 启用/禁用 指定的协议

-x,

--proxy [PROTOCOL://]HOST[:PORT]

在指定的端口上使用代理

--proxy-anyauth

在代理上使用 "any" 认证方法 (H)

--proxy-basic

在代理上使用 Basic 认证  (H)

--proxy-digest

在代理上使用 Digest 认证 (H)

--proxy-negotiate

在代理上使用 Negotiate 认证 (H)

--proxy-ntlm

在代理上使用 NTLM 认证 (H)

-U,

--proxy-user USER[:PASSWORD]

代理用户名及密码

--proxy1.0 HOST[:PORT]

在指定的端口上使用 HTTP/1.0 代理

-p,

--proxytunnel

使用HTTP代理 (用于 CONNECT)

--pubkey KEY

公钥文件名 (SSH)

-Q,

--quote CMD

在传输开始前向服务器发送命令 (F/SFTP)

--random-file FILE

读取随机数据的文件 (SSL)

-r,

--range RANGE

仅检索范围内的字节

--raw

使用原始HTTP传输，而不使用编码 (H)

-e,

--referer

Referer URL (H)

-J,

--remote-header-name

从远程文件读取头信息 (H)

-O,

--remote-name

将输出写入远程文件

--remote-name-all

使用所有URL的远程文件名

-R,

--remote-time

将远程文件的时间设置在本地输出上

-X,

--request COMMAND

使用指定的请求命令

--resolve HOST:PORT:ADDRESS

将 HOST:PORT 强制解析到 ADDRESS

--retry NUM

出现问题时的重试次数

--retry-delay SECONDS

重试时的延时时长

--retry-max-time SECONDS

仅在指定时间段内重试

-S,

--show-error

显示错误. 在选项 -s 中，当 curl 出现错误时将显示

-s,

--silent

Silent模式。不输出任务内容

--socks4 HOST[:PORT]

在指定的 host + port 上使用 SOCKS4 代理

--socks4a HOST[:PORT]

在指定的 host + port 上使用 SOCKSa 代理

--socks5 HOST[:PORT]

在指定的 host + port 上使用 SOCKS5 代理

--socks5-hostname HOST[:PORT] SOCKS5

代理，指定用户名、密码

--socks5-gssapi-service NAME

为gssapi使用SOCKS5代理服务名称

--socks5-gssapi-nec

与NEC Socks5服务器兼容

-Y,

--speed-limit RATE

在指定限速时间之后停止传输

-y,

--speed-time SECONDS

指定时间之后触发限速. 默认 30

--ssl

尝试 SSL/TLS (FTP, IMAP, POP3, SMTP)

--ssl-reqd

需要 SSL/TLS (FTP, IMAP, POP3, SMTP)

-2,

--sslv2

使用 SSLv2 (SSL)

-3,

--sslv3

使用 SSLv3 (SSL)

--ssl-allow-beast

允许的安全漏洞，提高互操作性(SSL)

--stderr FILE

重定向 stderr 的文件位置. - means stdout

--tcp-nodelay

使用 TCP_NODELAY 选项

-t,

--telnet-option OPT=VAL

设置 telnet 选项

--tftp-blksize VALUE

设备 TFTP BLKSIZE 选项 (必须 >512)

-z,

--time-cond TIME

基于时间条件的传输

-1,

--tlsv1

使用 => TLSv1 (SSL)

--tlsv1.0

使用 TLSv1.0 (SSL)

--tlsv1.1

使用 TLSv1.1 (SSL)

--tlsv1.2

使用 TLSv1.2 (SSL)

--trace FILE

将 debug 信息写入指定的文件

--trace-ascii FILE

类似  --trace 但使用16进度输出

--trace-time

向 trace/verbose 输出添加时间戳

--tr-encoding

请求压缩传输编码 (H)

-T,

--upload-file FILE

将文件传输（上传）到指定位置

--url URL

指定所使用的 URL

-B,

--use-ascii

使用 ASCII/text 传输

-u,

--user USER[:PASSWORD]

指定服务器认证用户名、密码

--tlsuser USER

TLS 用户名

--tlspassword STRING

TLS 密码

--tlsauthtype STRING

TLS 认证类型 (默认 SRP)

--unix-socket FILE

通过这个 UNIX socket 域连接

-A,

--user-agent STRING

要发送到服务器的 User-Agent (H)

-v,

--verbose

显示详细操作信息

-V,

--version

显示版本号并退出

-w,

--write-out FORMAT

完成后输出什么

--xattr

将元数据存储在扩展文件属性中

-q

.curlrc 如果作为第一个参数无效

退 出 码

错误描述

1

Unsupported protocol. This build of curl has no support for this protocol.

2

Failed to initialize.

3

URL malformed. The syntax was not correct.

5

Couldn't resolve proxy. The given proxy host could not be resolved.

6

Couldn't resolve host. The given remote host was not resolved.

7

Failed to connect to host.

8

FTP weird server reply. The server sent data curl couldn't parse.

9

FTP access denied. The server denied login or denied access to the particular resource or directory you wanted to reach. Most often you tried to change to a directory that doesn't exist on the server.

11

FTP weird PASS reply. Curl couldn't parse the reply sent to the PASS request.

13

FTP weird PASV reply, Curl couldn't parse the reply sent to the PASV request.

14

FTP weird 227 format. Curl couldn't parse the 227-line the server sent.

15

FTP can't get host. Couldn't resolve the host IP we got in the 227-line.

17

FTP couldn't set binary. Couldn't change transfer method to binary.

18

Partial file. Only a part of the file was transferred.

19

FTP couldn't download/access the given file, the RETR (or similar) command failed.

21

FTP quote error. A quote command returned error from the server.

22

HTTP page not retrieved. The requested url was not found or returned another error with the HTTP error code being 400 or above. This return code only appears if -f/--fail is used.

23

Write error. Curl couldn't write data to a local filesystem or similar.

25

FTP couldn't STOR file. The server denied the STOR operation, used for FTP uploading.

26

Read error. Various reading problems.

27

Out of memory. A memory allocation request failed.

28

Operation timeout. The specified time-out period was reached according to the conditions.

30

FTP PORT failed. The PORT command failed. Not all FTP servers support the PORT command, try doing a transfer using PASV instead!

31

FTP couldn't use REST. The REST command failed. This command is used for resumed FTP transfers.

33

HTTP range error. The range "command" didn't work.

34

HTTP post error. Internal post-request generation error.

35

SSL connect error. The SSL handshaking failed.

36

FTP bad download resume. Couldn't continue an earlier aborted download.

37

FILE couldn't read file. Failed to open the file. Permissions?

38

LDAP cannot bind. LDAP bind operation failed.

39

LDAP search failed.

41

Function not found. A required LDAP function was not found.

42

Aborted by callback. An application told curl to abort the operation.

43

Internal error. A function was called with a bad parameter.

45

Interface error. A specified outgoing interface could not be used.

47

Too many redirects. When following redirects, curl hit the maximum amount.

48

Unknown TELNET option specified.

49

Malformed telnet option.

51

The peer's SSL certificate or SSH MD5 fingerprint was not ok.

52

The server didn't reply anything, which here is considered an error.

53

SSL crypto engine not found.

54

Cannot set SSL crypto engine as default.

55

Failed sending network data.

56

Failure in receiving network data.

58

Problem with the local certificate.

59

Couldn't use specified SSL cipher.

60

Peer certificate cannot be authenticated with known CA certificates.

61

Unrecognized transfer encoding.

62

Invalid LDAP URL.

63

Maximum file size exceeded.

64

Requested FTP SSL level failed.

65

Sending the data requires a rewind that failed.

66

Failed to initialize SSL Engine.

67

The user name, password, or similar was not accepted and curl failed to log in.

68

File not found on TFTP server.

69

Permission problem on TFTP server.

70

Out of disk space on TFTP server.

71

Illegal TFTP operation.

72

Unknown TFTP transfer ID.

73

File already exists (TFTP).

74

No such user (TFTP).

75

Character conversion failed.

76

Character conversion functions required.

77

Problem with reading the SSL CA cert (path? access rights?).

78

The resource referenced in the URL does not exist.

79

An unspecified error occurred during the SSH session.

80

Failed to shut down the SSL connection.

82

Could not load CRL file, missing or wrong format (added in 7.19.0).

83

Issuer check failed (added in 7.19.0).

XX

More error codes will appear here in future releases. The existing ones are meant to never change.