curl 是 CommandLine Uniform Resource Locator (命令行统一资源定位器) 的简写，基于开源库 libcurl 。
curl 相比 wget 功能更底层，可在命令行 (或脚本) 中按 URL 分块传输数据。 可用于汽车 电视机 路由器 打印机 音频设备 手机 平板电脑 机顶盒 媒体播放器中。
支持特性： AsynchDNS IDN IPv6 Largefile GSS-API Kerberos SPNEGO NTLM NTLM_WB SSL libz TLS-SRP UnixSockets
支持协议： dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtmp rtsp smb smbs smtp smtps telnet tftp
另请参阅： wget dante-server
curl -I www.baidu.com curl -s -o /dev/null www.baidu.com
远程文件
curl -O http://xxx.edu.cn/test-full.tar.gz
分块下载
curl -r 0-10000 -o local_part1.tar.gz http://xxx.edu.cn/test-full.tar.gz curl -r 10001- -o local_part2.tar.gz http://xxx.edu.cn/test-full.tar.gz cat local_part* > local_test.tar.gz
基本语法
curl [options...] <url>
| 参数 | EN 解释 | 中文翻译 | 备注 |
|---|---|---|---|
| --anyauth | Pick "any" authentication method (H) | 选择任何身份验证方法 (H) | |
| -a, --append | Append to target file when uploading (F/SFTP) | 上传时追加到目标文件 (F/SFTP) | |
| --basic | Use HTTP Basic Authentication (H) | 使用 HTTP 基本身份验证 (H) | |
| --cacert FILE | CA certificate to verify peer against (SSL) | CA 证书验证对等方 (SSL) | |
| --capath DIR | CA directory to verify peer against (SSL) | CA 目录验证对等方 (SSL) | |
| -E, --cert CERT[:PASSWD] | Client certificate file and password (SSL) | 客户端证书文件 口令 (SSL) | |
| --cert-status | Verify the status of the server certificate (SSL) | 验证服务器证书状态 (SSL) | |
| --cert-type TYPE | Certificate file type (DER/PEM/ENG) (SSL) | 证书文件类型 (DER/PEM/ENG) (SSL) | |
| --ciphers LIST | SSL ciphers to use (SSL) | 要使用的 SSL 暗号 | |
| --compressed | Request compressed response (using deflate or gzip) | 请求压缩响应 (使用 deflate 或 gzip ) | |
| -K, --config FILE | Read config from FILE | 从 FILE 读取配置 | |
| --connect-timeout SECONDS | Maximum time allowed for connection | 允许的最大连接时间 | |
| -C, --continue-at OFFSET | Resumed transfer OFFSET | 恢复传输 OFFSET | |
| -b, --cookie STRING/FILE | Read cookies from STRING/FILE (H) | 从 STRING/FILE 中读取 Cookie (H) | |
| -c, --cookie-jar FILE | Write cookies to FILE after operation (H) | 操作后将 Cookie 写入 FILE (H) | |
| --create-dirs | Create necessary local directory hierarchy | 创建必要的本地目录层次结构 | |
| --crlf | Convert LF to CRLF in upload | 在上传时将 LF 转换为 CRLF | |
| --crlfile FILE | Get a CRL list in PEM format from the given file | 从给定文件获取 PEM 格式 CRL 列表 | |
| -d, --data DATA | HTTP POST data (H) | HTTP POST 数据 (H) | |
| --data-raw DATA | HTTP POST data, '@' allowed (H) | HTTP POST 数据，允许 '@' (H) | |
| --data-ascii DATA | HTTP POST ASCII data (H) | HTTP POST ASCII 数据 (H) | |
| --data-binary DATA | HTTP POST binary data (H) | HTTP POST 二进制数据 (H) | |
| --data-urlencode DATA | HTTP POST data url encoded (H) | HTTP POST 数据编码 url (H) | |
| --delegation STRING | GSS-API delegation permission | GSS-API 委托权限 | |
| --digest | Use HTTP Digest Authentication (H) | 使用 HTTP 摘要验证 (H) | |
| --disable-eprt | Inhibit using EPRT or LPRT (F) | 阻止使用 EPRT 或 LPRT (F) | |
| --disable-epsv | Inhibit using EPSV (F) | 阻止使用 EPSV (F) | |
| --dns-servers | DNS server addrs to use: 1.1.1.1;2.2.2.2 | 要使用的 DNS 服务器地址：1.1.1.1; 2.2.2.2 | |
| --dns-interface | Interface to use for DNS requests | DNS 请求使用接口 | |
| --dns-ipv4-addr | IPv4 address to use for DNS requests, dot notation | DNS 请求使用 IPv4 地址，点表示法 | |
| --dns-ipv6-addr | IPv6 address to use for DNS requests, dot notation | DNS 请求使用 IPv6 地址，点表示法 | |
| -D, --dump-header FILE | Write the headers to FILE | 把头写入 FILE | |
| --egd-file FILE | EGD socket path for random data (SSL) | 随机数据的 EGD 套接字路径 (SSL) | |
| --engine ENGINE | Crypto engine (use "--engine list" for list) (SSL) | 加密引擎 (使用 "--engine list" 为列表) (SSL) | |
| --expect100-timeout SECONDS | How long to wait for 100-continue (H) | 100 次继续等待时间 (H) | |
| -f, --fail | Fail silently (no output at all) on HTTP errors (H) | 出现 HTTP 错误时默默失败 (根本没有输出) (H) | |
| --false-start | Enable TLS False Start | 启用 TLS False 启动 | |
| -F, --form CONTENT | Specify HTTP multipart POST data (H) | 指定 HTTP 分段 POST 数据 (H) | |
| --form-string STRING | Specify HTTP multipart POST data (H) | 指定 HTTP 分段 POST 数据 data (H) | |
| --ftp-account DATA | Account data string (F) | 帐户数据字符串 (F) | |
| --ftp-alternative-to-user COMMAND | String to replace "USER [name]" (F) | 要替换 "USER [name]" 的字符串 (F) | |
| --ftp-create-dirs | Create the remote dirs if not present (F) | 创建远程目录，若不存在 (F) | |
| --ftp-method [MULTICWD/NOCWD/SINGLECWD] | Control CWD usage (F) | 控制 CWD 用法 (F) | |
| --ftp-pasv | Use PASV/EPSV instead of PORT (F) | 使用 PASV/EPSV，而不是 PORT (F) | |
| -P, --ftp-port ADR | Use PORT with given address instead of PASV (F) | 使用给定地址 PORT，而不是 PASV (F) | |
| --ftp-skip-pasv-ip | Skip the IP address for PASV (F) | 跳过 PASV IP 地址 (F) | |
| --ftp-pret | Send PRET before PASV (for drftpd) (F) | 在 PASV 之前发送 PRET (对于 drftpd) (F) | |
| --ftp-ssl-ccc | Send CCC after authenticating (F) | 验证后发送 CCC (F) | |
| --ftp-ssl-ccc-mode ACTIVE/PASSIVE | Set CCC mode (F) | 设置 CCC 模式 (F) | |
| --ftp-ssl-control | Require SSL/TLS for FTP login, clear for transfer (F) | FTP 登录需要 SSL/TLS，传输归零 (F) | |
| -G, --get | Send the -d data with a HTTP GET (H) | 以 HTTP GET 发送 -d 数据 (H) | |
| -g, --globoff | Disable URL sequences and ranges using {} and [] | 以 {} [] 禁用 URL 序列 范围 | |
| -H, --header LINE | Pass custom header LINE to server (H) | 把自定义头 LINE 传递给服务器 (H) | |
| -I, --head | Show document info only | 仅展示文档信息 | |
| -h, --help | This help text | 显示帮助文本信息 | |
| --hostpubmd5 MD5 | Hex-encoded MD5 string of the host public key. (SSH) | 十六进制编码主机公钥 MD5 字符串 (SSH) | |
| -0, --http1.0 | Use HTTP 1.0 (H) | 使用 HTTP 1.0 (H) | |
| --http1.1 | Use HTTP 1.1 (H) | 使用 HTTP 1.1 (H) | |
| --http2 | Use HTTP 2 (H) | 使用 HTTP 2 (H) | |
| --ignore-content-length | Ignore the HTTP Content-Length header | 忽略 HTTP Content-Length 头 | |
| -i, --include | Include protocol headers in the output (H/F) | 在输出中包括协议头 (H/F) | |
| -k, --insecure | Allow connections to SSL sites without certs (H) | 允许无证书连接到 SSL 站点 (H) | |
| --interface INTERFACE | Use network INTERFACE (or address) | 使用网络 INTERFACE (或地址) | |
| -4, --ipv4 | Resolve name to IPv4 address | 将名称解析成 IPv4 地址 | |
| -6, --ipv6 | Resolve name to IPv6 address | 将名称解析成 IPv6 地址 | |
| -j, --junk-session-cookies | Ignore session cookies read from file (H) | 忽略从文件读取的会话 cookie (H) | |
| --keepalive-time SECONDS | Wait SECONDS between keepalive probes | 在 Keepalive 探针之间等待 SECONDS | |
| --key KEY | Private key file name (SSL/SSH) | 私钥文件名 (SSL/SSH) | |
| --key-type TYPE | Private key file type (DER/PEM/ENG) (SSL) | 私钥文件类型 (DER/PEM/ENG) (SSL) | |
| --krb LEVEL | Enable Kerberos with security LEVEL (F) | 以安全级别 LEVEL 启用 Kerberos (F) | |
| --libcurl FILE | Dump libcurl equivalent code of this command line | 转储本命令行的 libcurl 等效代码 | |
| --limit-rate RATE | Limit transfer speed to RATE | 把传输速度限制为 RATE | |
| -l, --list-only | List only mode (F/POP3) | 仅列出模式 (F/POP3) | |
| --local-port RANGE | Force use of RANGE for local port numbers | 把 RANGE 强制用于本地端口号 | |
| L, --location | Follow redirects (H) | 跟随重定向 | |
| --location-trusted | Like '--location', and send auth to other hosts (H) | 类似 '--location'，并将 auth 发送给其他主机 (H) | |
| --login-options OPTIONS | Server login options (IMAP, POP3, SMTP) | 服务器登录选项 (IMAP, POP3, SMTP) | |
| -M, --manual | Display the full manual | 显示完整手册 | |
| --mail-from FROM | Mail from this address (SMTP) | 邮件来自此地址 (SMTP) | |
| --mail-rcpt TO | Mail to this/these addresses (SMTP) | 邮到 此/这些 地址 (SMTP) | |
| --mail-auth AUTH | Originator address of the original email (SMTP) | 原电子邮件的发起人地址 (SMTP) | |
| --max-filesize BYTES | Maximum file size to download (H/F) | 要下载的最大文件尺寸 (H/F) | |
| --max-redirs NUM | Maximum number of redirects allowed (H) | 最大允许重定向次数 (H) | |
| -m, --max-time SECONDS | Maximum time allowed for the transfer | 允许传输的最大时间 | |
| --metalink | Process given URLs as metalink XML file | 将给定 URL 处理成 metalink XML 文件 | |
| --negotiate | Use HTTP Negotiate (SPNEGO) authentication (H) | 使用 HTTP 协商 (SPNEGO) 身份验证 (H) | |
| -n, --netrc | Must read .netrc for user name and password | 为用户名 口令必须读取 .netrc | |
| --netrc-optional | Use either .netrc or URL; overrides -n | 使用 .netrc 或 URL；覆盖 -n | |
| --netrc-file FILE | Specify FILE for netrc | 为 netrc 指定 FILE | |
| -:, --next | Allows the following URL to use a separate set of options | 允许之后 URL 使用单独选项集 | |
| --no-alpn | Disable the ALPN TLS extension (H) | 禁用 ALPN TLS 扩展 (H) | |
| -N, --no-buffer | Disable buffering of the output stream | 禁用输出流缓冲 | |
| --no-keepalive | Disable keepalive use on the connection | 禁止 keepalive 用于连接 | |
| --no-npn | Disable the NPN TLS extension (H) | 禁用 NPN TLS 扩展 (H) | |
| --no-sessionid | Disable SSL session-ID reusing (SSL) | 禁止重用 SSL 会话 ID (SSL) | |
| --noproxy | List of hosts which do not use proxy | 列出不使用代理的主机 | |
| --ntlm | Use HTTP NTLM authentication (H) | 使用 HTTP NTLM 身份验证 (H) | |
| --oauth2-bearer TOKEN | OAuth 2 Bearer Token (IMAP, POP3, SMTP) | OAuth 2 不记名令牌 (IMAP, POP3, SMTP) | |
| -o, --output FILE | Write to FILE instead of stdout | 写入 FILE 文件，而不是标准输出 | |
| --pass PASS | Pass phrase for the private key (SSL/SSH) | 传递私钥短语 (SSL/SSH) | |
| --path-as-is | Do not squash .. sequences in URL path | 不要压缩 .. 序列 URL 路径 | |
| --pinnedpubkey FILE/HASHES | Public key to verify peer against (SSL) | 用来验证对等方的公钥 (SSL) | |
| --post301 | Do not switch to GET after following a 301 redirect (H) | 在随 301 重定向后，不切换到 GET (H) | |
| --post302 | Do not switch to GET after following a 302 redirect (H) | 在随 302 重定向后，不切换到 GET (H) | |
| --post303 | Do not switch to GET after following a 303 redirect (H) | 在随 303 重定向后，不切换到 GET (H) | |
| -#, --progress-bar | Display transfer progress as a progress bar | 以进度条方式显示传输进度 | |
| --proto PROTOCOLS | Enable/disable PROTOCOLS | 启用/禁用 PROTOCOLS 协议 | |
| --proto-default PROTOCOL | Use PROTOCOL for any URL missing a scheme | 对任何缺少方案的 URL 使用 PROTOCOL 协议 | |
| --proto-redir PROTOCOLS | Enable/disable PROTOCOLS on redirect | 启用/禁用 重定向 PROTOCOLS 协议 | |
| -x, --proxy [PROTOCOL://]HOST[:PORT] | Use proxy on given port | 在给定端口上使用代理 | |
| --proxy-anyauth | Pick "any" proxy authentication method (H) | 选择任何代理身份验证方法 (H) | |
| --proxy-basic | Use Basic authentication on the proxy (H) | 在代理上使用基本身份验证 (H) | |
| --proxy-digest | Use Digest authentication on the proxy (H) | 在代理上使用摘要身份验证 (H) | |
| --proxy-negotiate | Use HTTP Negotiate (SPNEGO) authentication on the proxy (H) | 在代理上使用 HTTP 协商 (SPNEGO) 身份验证 (H) | |
| --proxy-ntlm | Use NTLM authentication on the proxy (H) | 在代理上使用 NTLM 身份验证 (H) | |
| --proxy-service-name NAME | SPNEGO proxy service name | SPNEGO 代理服务名称 | |
| --service-name NAME | SPNEGO service name | SPNEGO 服务名称 | |
| -U, --proxy-user USER[:PASSWORD] | Proxy user and password | 代理用户 口令 | |
| --proxy1.0 HOST[:PORT] | Use HTTP/1.0 proxy on given port | 在给定端口上使用 HTTP/1.0 代理 | |
| -p, --proxytunnel | Operate through a HTTP proxy tunnel (using CONNECT) | 通过 HTTP 代理隧道进行操作 (使用 CONNECT) | |
| --pubkey KEY | Public key file name (SSH) | 公钥文件名 (SSH) | |
| -Q, --quote CMD | Send command(s) to server before transfer (F/SFTP) | 传输前将命令发送给服务器 (F/SFTP) | |
| --random-file FILE | File for reading random data from (SSL) | 用于从中读取随机数据的文件 (SSL) | |
| -r, --range RANGE | Retrieve only the bytes within RANGE | 仅检索 RANGE 范围内的字节 | |
| --raw | Do HTTP "raw"; no transfer decoding (H) | 做 HTTP "raw"；不解码传输 (H) | |
| -e, --referer | Referer URL (H) | 引荐 URL (H) | |
| -J, --remote-header-name | Use the header-provided filename (H) | 使用头提供文件名 (H) | |
| -O, --remote-name | Write output to a file named as the remote file | 将输出写入到名为远程文件的文件 | |
| --remote-name-all | Use the remote file name for all URLs | 对所有 URL 使用远程文件名 | |
| -R, --remote-time | Set the remote file's time on the local output | 在本地输出设置远程文件时间 | |
| -X, --request COMMAND | Specify request command to use | 指定要使用的请求命令 | |
| --resolve HOST:PORT:ADDRESS | Force resolve of HOST:PORT to ADDRESS | 把 HOST:PORT 强制解析为 ADDRESS | |
| --retry NUM | Retry request NUM times if transient problems occur | 重试请求次 NUM 数，若出现暂时性问题 | |
| --retry-delay SECONDS | Wait SECONDS between retries | 重试之间等待 SECONDS 秒 | |
| --retry-max-time SECONDS | Retry only within this period | 仅在此区间重试 | |
| --sasl-ir | Enable initial response in SASL authentication | 在 SASL 身份验证中启用初始响应 | |
| -S, --show-error |
Show error With -s, make curl show errors when they occur |
展示错误 采用 -s，使 curl 发生错误时展示错误 |
|
| -s, --silent | Silent mode (don't output anything) | 静音模式 (不输出任何内容) | |
| --socks4 HOST[:PORT] | SOCKS4 proxy on given host + port | 给定主机 + 端口上的 SOCKS4 代理 | |
| --socks4a HOST[:PORT] | SOCKS4a proxy on given host + port | 给定主机 + 端口上的 SOCKS4a 代理 | |
| --socks5 HOST[:PORT] | SOCKS5 proxy on given host + port | 给定主机 + 端口上的 SOCKS5 代理 | |
| --socks5-hostname HOST[:PORT] | SOCKS5 proxy, pass host name to proxy | SOCKS5 代理，把主机名传递给代理 | |
| --socks5-gssapi-service NAME | SOCKS5 proxy service name for GSS-API | GSS-API 的 SOCKS5 代理服务名 | |
| --socks5-gssapi-nec | Compatibility with NEC SOCKS5 server | 兼容 NEC SOCKS5 服务器 | |
| -Y, --speed-limit RATE | Stop transfers below RATE for 'speed-time' secs | 当在 RATE 每 'speed-time' 秒内时停止传输 | |
| -y, --speed-time SECONDS | Trigger 'speed-limit' abort after SECONDS (default: 30) | 在 SECONDS 秒后触发 '限速' 中止 (默认：30) | |
| --ssl | Try SSL/TLS (FTP, IMAP, POP3, SMTP) | 尝试 SSL/TLS (FTP, IMAP, POP3, SMTP) | |
| --ssl-reqd | Require SSL/TLS (FTP, IMAP, POP3, SMTP) | 要求 SSL/TLS (FTP, IMAP, POP3, SMTP) | |
| -2, --sslv2 | Use SSLv2 (SSL) | 使用 SSLv2 (SSL) | |
| -3, --sslv3 | Use SSLv3 (SSL) | 使用 SSLv3 (SSL) | |
| --ssl-allow-beast | Allow security flaw to improve interop (SSL) | 允许安全缺陷，以改善互操作 (SSL) | |
| --ssl-no-revoke | Disable cert revocation checks (WinSSL) | 禁用证书吊销检查 (WinSSL) | |
| --stderr FILE | Where to redirect stderr (use "-" for stdout) | 重定向标准错误位置 (使用 "-" 为标准输出) | |
| --tcp-nodelay | Use the TCP_NODELAY option | 使用 TCP_NODELAY 选项 | |
| -t, --telnet-option OPT=VAL | Set telnet option | 设置 telnet 选项 | |
| --tftp-blksize VALUE | Set TFTP BLKSIZE option (must be >512) | 设置 TFTP BLKSIZE 选项 (必须 > 512) | |
| -z, --time-cond TIME | Transfer based on a time condition | 传输基于时间条件 | |
| -1, --tlsv1 | Use >= TLSv1 (SSL) | 使用 >= TLSv1 (SSL) | |
| --tlsv1.0 | Use TLSv1.0 (SSL) | 使用 TLSv1.0 (SSL) | |
| --tlsv1.1 | Use TLSv1.1 (SSL) | 使用 TLSv1.1 (SSL) | |
| --tlsv1.2 | Use TLSv1.2 (SSL) | 使用 TLSv1.2 (SSL) | |
| --trace FILE | Write a debug trace to FILE | 将调试跟踪写入 FILE | |
| --trace-ascii FILE | Like --trace, but without hex output | 类似 --trace，但没有十六进制输出 | |
| --trace-time | Add time stamps to trace/verbose output | 将时间戳添加到 跟踪/详细 输出 | |
| --tr-encoding | Request compressed transfer encoding (H) | 请求压缩传输编码 (H) | |
| -T, --upload-file FILE | Transfer FILE to destination | 把 FILE 文件传输到目的地 | |
| --url URL | URL to work with | 处理 URL | |
| -B, --use-ascii | Use ASCII/text transfer | 使用 ASCII/text 传输 | |
| -u, --user USER[:PASSWORD] | Server user and password | 服务器用户 口令 | |
| --tlsuser USER | TLS username | TLS 用户名 | |
| --tlspassword STRING | TLS password | TLS 口令 | |
| --tlsauthtype STRING | TLS authentication type (default: SRP) | TLS 身份验证类型 (默认: SRP) | |
| --unix-socket FILE | Connect through this Unix domain socket | 通过此 Unix 域套接字连接 | |
| -A, --user-agent STRING | Send User-Agent STRING to server (H) | 把用户代理 STRING 发送给服务器 (H) | |
| -v, --verbose | Make the operation more talkative | 使操作更健谈 | |
| -V, --version | Show version number and quit | 展示版本号并离开 | |
| -w, --write-out FORMAT | Use output FORMAT after completion | 完成后使用输出 FORMAT 格式 | |
| --xattr | Store metadata in extended file attributes | 把元数据存储在扩展文件属性中 | |
| -q | Disable .curlrc (must be first parameter) | 禁用 .curlrc (必须是第一参数) |
-I, --head 展示响应头信息。
-m, --max-time SECONDS 最大访问超时时间。
譬如： curl -I -m 5 -s -w "%{http_code}\n" -o /dev/null www.baidu.com
curl -I -m 5 -s -w "%{http_code}\n" -o /dev/null www.baidu.com | egrep "30[12]|200" | wc -l
| 功能 | 命令 | 文字解释 | 示例 | 示例解释 |
|---|---|---|---|---|
| 版本 | curl -V | 展示版本信息 | ||
| curl --version | ||||
| 手册 | curl -M | 展示完整手册 | ||
| curl --manual | ||||
| 帮助 | curl -h | 展示帮助信息 | ||
| curl --help |
版权声明： 本文为独家原创稿件，版权归 乐数软件 ，未经许可不得转载。
