curl 命令参数与用法

目录

curl 是命令行下的文件传输工具,支持上传下载及 HTTP/FTP 等多种协议。以下整理常用参数与实例。

常用参数

-a/--append              上传文件时,附加到目标文件
-A/--user-agent <string> 设置用户代理发送给服务器
--anyauth                可以使用"任何"身份验证方法
-b/--cookie <name=string/file>  cookie 字符串或文件读取位置
--basic                  使用 HTTP 基本验证
-B/--use-ascii           使用 ASCII/文本传输
-c/--cookie-jar <file>   操作结束后把 cookie 写入到这个文件中
-C/--continue-at <offset>  断点续转
-d/--data <data>         HTTP POST 方式传送数据
--data-ascii <data>      以 ascii 的方式 post 数据
--data-binary <data>     以二进制的方式 post 数据
--negotiate              使用 HTTP 身份验证
--digest                 使用数字身份验证
--disable-eprt           禁止使用 EPRT 或 LPRT
--disable-epsv           禁止使用 EPSV
-D/--dump-header <file>  把 header 信息写入到该文件中
--egd-file <file>        为随机数据(SSL)设置 EGD socket 路径
--tcp-nodelay            使用 TCP_NODELAY 选项
-e/--referer             来源网址
-E/--cert <cert[:passwd]>  客户端证书文件和密码 (SSL)
--cert-type <type>       证书文件类型 (DER/PEM/ENG) (SSL)
--key <key>              私钥文件名 (SSL)
--key-type <type>        私钥文件类型 (DER/PEM/ENG) (SSL)
--pass <pass>            私钥密码 (SSL)
--engine <eng>           加密引擎使用 (SSL),"--engine list" 列出
--cacert <file>          CA 证书 (SSL)
--capath <directory>     CA 目录 (made using c_rehash) (SSL)
--ciphers <list>         SSL 密码
--compressed             要求返回是压缩的形式 (deflate 或 gzip)
--connect-timeout <seconds>  设置最大请求时间
--create-dirs            建立本地目录的目录层次结构
--crlf                   上传时把 LF 转变成 CRLF
-f/--fail                连接失败时不显示 http 错误
--ftp-create-dirs        如果远程目录不存在,创建远程目录
--ftp-method [multicwd/nocwd/singlecwd]  控制 CWD 的使用
--ftp-pasv               使用 PASV/EPSV 代替端口
--ftp-skip-pasv-ip       使用 PASV 的时候,忽略该 IP 地址
--ftp-ssl                尝试用 SSL/TLS 来进行 ftp 数据传输
--ftp-ssl-reqd           要求用 SSL/TLS 来进行 ftp 数据传输
-F/--form <name=content>   模拟 http 表单提交数据
--form-string <name=string>  模拟 http 表单提交数据
-g/--globoff             禁用网址序列和范围使用 {} 和 []
-G/--get                 以 get 的方式来发送数据
-h/--help                帮助
-H/--header <line>       自定义头信息传递给服务器
--ignore-content-length  忽略 HTTP 头信息的长度
-i/--include             输出时包括 protocol 头信息
-I/--head                只显示文档信息
-j/--junk-session-cookies  读取文件时忽略 session cookie
--interface <interface>  使用指定网络接口/地址
--krb4 <level>           使用指定安全级别的 krb4
-k/--insecure            允许不使用证书到 SSL 站点
-K/--config              指定的配置文件读取
-l/--list-only           列出 ftp 目录下的文件名称
--limit-rate <rate>      设置传输速度
--local-port <NUM>       强制使用本地端口号
-m/--max-time <seconds>  设置最大传输时间
--max-redirs <num>       设置最大读取的目录数
--max-filesize <bytes>   设置最大下载的文件总量
-M/--manual              显示全手动
-n/--netrc               从 netrc 文件中读取用户名和密码
--netrc-optional         使用 .netrc 或者 URL 来覆盖 -n
--ntlm                   使用 HTTP NTLM 身份验证
-N/--no-buffer           禁用缓冲输出
-o/--output              把输出写到该文件中
-O/--remote-name         把输出写到该文件中,保留远程文件的文件名
-p/--proxytunnel         使用 HTTP 代理
--proxy-anyauth          选择任一代理身份验证方法
--proxy-basic            在代理上使用基本身份验证
--proxy-digest           在代理上使用数字身份验证
--proxy-ntlm             在代理上使用 ntlm 身份验证
-P/--ftp-port <address>  使用端口地址,而不是使用 PASV
-Q/--quote <cmd>         文件传输前,发送命令到服务器
-r/--range <range>       检索来自 HTTP/1.1 或 FTP 服务器字节范围
--range-file             读取(SSL)的随机文件
-R/--remote-time         在本地生成文件时,保留远程文件时间
--retry <num>            传输出现问题时,重试的次数
--retry-delay <seconds>  传输出现问题时,设置重试间隔时间
--retry-max-time <seconds>  传输出现问题时,设置最大重试时间
-s/--silent              静音模式,不输出任何东西
-S/--show-error          显示错误
--socks4 <host[:port]>   用 socks4 代理给定主机和端口
--socks5 <host[:port]>   用 socks5 代理给定主机和端口
--stderr <file>
-t/--telnet-option <OPT=val>  Telnet 选项设置
--trace <file>           对指定文件进行 debug
--trace-ascii <file>     Like --trace 但没有 hex 输出
--trace-time             跟踪/详细输出时,添加时间戳
-T/--upload-file <file>  上传文件
--url <URL>              Set URL to work with
-u/--user <user[:password]>  设置服务器的用户和密码
-U/--proxy-user <user[:password]>  设置代理用户名和密码
-v/--verbose
-V/--version             显示版本信息
-w/--write-out [format]  什么输出完成后
-x/--proxy <host[:port]> 在给定的端口上使用 HTTP 代理
-X/--request <command>   指定什么命令
-y/--speed-time          放弃限速所要的时间,默认为 30
-Y/--speed-limit         停止传输速度的限制
-z/--time-cond           传送时间设置
-0/--http1.0             使用 HTTP 1.0
-1/--tlsv1               使用 TLSv1 (SSL)
-2/--sslv2               使用 SSLv2 (SSL)
-3/--sslv3               使用 SSLv3 (SSL)
--3p-quote               like -Q for the source URL for 3rd party transfer
--3p-url                 使用 url,进行第三方传送
--3p-user                使用用户名和密码,进行第三方传送
-4/--ipv4                使用 IPv4
-6/--ipv6                使用 IPv6
-#/--progress-bar        用进度条显示当前的传送状态

常用 curl 实例

1. 抓取页面内容到一个文件中

curl -o home.html http://blog.51yip.com

2. 用 -O(大写),后面的 url 要具体到某个文件;也可用正则抓取

curl -O http://blog.51yip.com/wp-content/uploads/2010/09/compare_varnish.jpg
curl -O http://blog.51yip.com/wp-content/uploads/2010/[0-9][0-9]/aaaaa.jpg

3. 模拟表单信息、模拟登录,保存 cookie 信息

curl -c ./cookie_c.txt -F log=aaaa -F pwd=****** http://blog.51yip.com/wp-login.php

4. 模拟表单信息、模拟登录,保存头信息

curl -D ./cookie_D.txt -F log=aaaa -F pwd=****** http://blog.51yip.com/wp-login.php

-c(小写)产生的 cookie 和 -D 里面的 cookie 是不一样的。

5. 使用 cookie 文件

curl -b ./cookie_c.txt http://blog.51yip.com/wp-admin

6. 断点续传,-C(大写)

curl -C -O http://blog.51yip.com/wp-content/uploads/2010/09/compare_varnish.jpg

7. 传送数据(最好用登录页面测试,传值过去后 curl 回抓数据,可看到传值是否成功)

curl -d log=aaaa http://blog.51yip.com/wp-login.php

8. 显示抓取错误

curl -f http://blog.51yip.com/asdf
# curl: (22) The requested URL returned error: 404

9. 伪造来源地址(有的网站会判断请求来源地址)

curl -e http://localhost http://blog.51yip.com/wp-login.php

10. 使用代理(频繁请求时对方可能屏蔽 IP)

curl -x 24.10.28.84:32779 -o home.html http://blog.51yip.com

11. 比较大的文件分段下载

curl -r 0-100   -o img.part1 http://blog.51yip.com/wp-content/uploads/2010/09/compare_varnish.jpg
curl -r 100-200 -o img.part2 http://blog.51yip.com/wp-content/uploads/2010/09/compare_varnish.jpg
curl -r 200-    -o img.part3 http://blog.51yip.com/wp-content/uploads/2010/09/compare_varnish.jpg
# 下载完成后合并:
cat img.part* > img.jpg

12. 不显示下载进度信息

curl -s -o aaa.jpg http://blog.51yip.com/wp-content/uploads/2010/09/compare_varnish.jpg

13. 显示下载进度条

curl -# -O http://blog.51yip.com/wp-content/uploads/2010/09/compare_varnish.jpg

14. 通过 ftp 下载文件

curl -u 用户名:密码 -O http://blog.51yip.com/demo/curtain/bbstudy_files/style.css
# 或者:
curl -O ftp://用户名:密码@ip:port/demo/curtain/bbstudy_files/style.css

15. 通过 ftp 上传

curl -T test.sql ftp://用户名:密码@ip:port/demo/curtain/bbstudy_files/

#ftp #ssl-tls