curl手册

参考：https://www.likecs.com/show-196181.html

参考：https://www.ruanyifeng.com/blog/2019/09/curl-reference.html

参考：https://www.ruanyifeng.com/blog/2011/09/curl.html

参考：https://blog.csdn.net/angle_chen123/article/details/120675472

简介

curl 是常用的命令行工具，用来请求 Web 服务器。它的名字就是客户端（client）的 URL 工具的意思。

它的功能非常强大，命令行参数多达几十种。如果熟练的话，完全可以取代 Postman 这一类的图形界面工具。

CURL英文手册

CURL初学者教程

一语法

curl [option] [url]

[option] 和 [url] 的位置没有限定，前后皆可。

二参数详解

由于linux curl功能十分强大，所以命令参数十分多，下表只是爱E族(aiezu.com)帅选出来的部分参数，更多参数请运行“man curl”命令查看。

1 参数对照表

参数组	参数	描述
url	url	需要抓取的一到多个URLs；多个下面通配符的方式：　　1、http://{www,ftp,mail}.aiezu.com；　　2、http://aiezu.com/images/[001-999].jpg；　　3、http://aiezu.com/images/[1-999].html；　　4、ftp://aiezu.com/file[a-z].txt
请求头	-H "name: value" --header "name: value"	(HTTP)添加一个http header(http请求头)；
	-H "name:" --header "name:"	(HTTP)移除一个http header(http请求头)；
	-A "string" --user-agent "string" 【参考】	(HTTP)设置Http请求头“User-Agent”，服务器通过“User-Agent”可以判断客户端使用的浏览器名称和操作系统类型，伪造此参数能导致服务器做出错误判断。也可以使用“-H”, “--header option”设置此选项；
	-e <URL> --referer <URL> 【参考】	(HTTP)设置访问时的来源页面，告诉http服务从哪个页面进入到此页面； -e "aiezu.com"相当于“-H "Referer: www.qq.com"”；
响应头	-I --head	(HTTP)只输出HTTP-header，不获取内容(HTTP/FTP/FILE)。用于HTTP服务时，获取页面的http头；（如：curl -I http://aiezu.com）用于FTP/FILE时，将会获取文件大小、最后修改时间；（如：curl -I file://test.txt）
	-i --include	(HTTP)输出HTTP头和返回内容；
	-D <file> --dump-header <file>	(HTTP)转储http响应头到指定文件；
cookie	-b name=data --cookie name=data 【参考】	(HTTP)发送cookie数据到HTTP服务器，数据格式为："NAME1=VALUE1; NAME2=VALUE2"；如果行中没有“=”，将把参数值当作cookie文件名；这个cookie数据可以是由服务器的http响应头“Set-Cookie:”行发送过来的；
	-c filename --cookie-jar file name 【参考】	(HTTP)完成操作后将服务器返回的cookies保存到指定的文件；指定参数值为“-”将定向到标准输出“如控制台”；
	-j --junk-session-cookies	(HTTP)告诉curl放弃所有的"session cookies"；相当于重启浏览器；
代理	-x host:port -x [protocol://[user:pwd@]host[:port] --proxy [protocol://[user:pwd@]host[:port] 【参考】	使用HTTP代理访问；如果未指定端口，默认使用8080端口; protocol默认为http_proxy，其他可能的值包括： http_proxy、HTTPS_PROXY、socks4、socks4a、socks5；如： --proxy 8.8.8.8:8080； -x "http_proxy://aiezu:123@aiezu.com:80"
	-p --proxytunnel	将“-x”参数的代理，作为通道的方式去代理非HTTP协议，如ftp；
	--socks4 <host[:port]> --socks4a <host[:port]> --socks5 <host[:port]> 【参考】	使用SOCKS4代理；使用SOCKS4A代理；使用SOCKS5代理；此参数会覆盖“-x”参数；
	--proxy-anyauth --proxy-basic --proxy-diges --proxy-negotiate --proxy-ntlm	http代理认证方式，参考： --anyauth --basic --diges --negotiate --ntlm
	-U <user:password> --proxy-user <user:password>	设置代理的用户名和密码；
数据传输	-G --get 【参考】	如果使用了此参数，“-d/”、“--data”、“--data-binary”参数设置的数据，讲附加在url上，以GET的方式请求；
	-d @file -d "string" --data "string" --data-ascii "string" --data-binary "string" --data-urlencode "string" 【参考】	(HTTP)使用HTTP POST方式发送“key/value对”数据，相当于浏览器表单属性（method="POST"，enctype="application/x-www-form-urlencoded"）　　-d，--data：HTTP方式POST数据；　　--data-ascii：HTTP方式POST ascii数据；　　--data-binary：HTTP方式POST二进制数据；　　--data-urlencode：HTTP方式POST数据（进行urlencode）；如果数据以“@”开头，后紧跟一个文件，将post文件内的内容；
	-F name=@file -F name=<file -F name=content --form name=content 【参考】	(HTTP)使用HTTP POST方式发送类似“表单字段”的多类型数据，相当于同时设置浏览器表单属性（method="POST"，enctype="multipart/form-data"），可以使用此参数上传二进制文件。如果字段内容以“@”开头，剩下的部分应该是文件名，curl将会上传此文件，如： curl -F "pic=@pic.jpg" http://aiezu.com； curl -F "page=@a.html;type=text/html" http://aiezu.com curl -F "page=@/tmp/a;filename=a.txt" http://aiezu.com 如果字段内容以“<”开头，剩下的部分应该是文件名，curl将从文件中获取作为此字段的值，如：curl -F "text=<text.txt" http://aiezu.com；
	--form-string <key=value>	(HTTP)类似于“--form”，但是“@”、“<”无特殊含义；
	-T file --upload-file file	通过“put”的方式将文件传输到远程网址；选项参数只使用字符"-"，将通过stdin读入文件内容；如： cat test.txt\|curl "http://aiezu.com/a.php" -T - curl "http://aiezu.com/a.php" -T - <test.txt 此参数也可以使用通配符： curl -T "{file1,file2}" http://aiezu.com curl -T "img[1-1000].png" http://aiezu.com
断点续传	-C <offset> --continue-at <offset>	断点续转，从文件头的指定位置开始继续下载/上传； offset续传开始的位置，如果offset值为“-”，curl会自动从文件中识别起始位置开始传输；
断点续传	-r <range> --range <range>	(HTTP/FTP/SFTP/FILE) 只传输内容的指定部分： 0-499：最前面500字节； -500：最后面500字节； 9500-：最前面9500字节； 0-0,-1：最前面和最后面的1字节； 100-199,500-599：两个100字节；
认证	--basic	(HTTP)告诉curl使用HTTP Basic authentication（HTTP协议时），这是默认认证方式；
	--ntlm	(HTTP)使用NTLM身份验证方式，用于HTTP协议；一般用于IIS使用NTLM的网站；
	--digest	(HTTP)使用HTTP Digest authentication加密，用于HTTP协议；配合“-u/--user”选项，防止密码使用明文方式发送；
	--negotiate	(HTTP)使用GSS-Negotiate authentication方式，用于HTTP协议；它主要目的是为它的主要目的是为kerberos5认证提供支持支持；
	--anyauth	(HTTP)告诉curl自动选择合适的身份认证方法，并选用最安全的方式；
	-u user:password --user user:password	使用用户名、密码认证，此参数会覆盖“-n”、“--netrc”和“--netrc-optional”选项；如果你只提供用户名，curl将要求你输入密码；如果你使用“SSPI”开启的curl库做“NTLM”认证，可以使用不含用户名密码的“-u:”选项，强制curl使用当前登录的用户名密码进行认证；此参数相当于设置http头“Authorization：”；
证书	-E <证书[:密码]> --cert <证书[:密码]>	(SSL)指定“PEM”格式的证书文件和证书密码；
	--cert-type <type>	(SSL)告诉curl所提供证书的类型：PEM、DER、ENG等；默认为“PEM”；
	--cacert <CA证书>	(SSL)告诉curl所以指定的CA证书文件，必须是“PEM”格式；
	--capath <CA证书路径>	(SSL)告诉curl所以指定目录下的CA证书用来验证；这些证书必须是“PEM”格式；
	--crlfile <file>	(HTTPS/FTPS)提供一个PEM格式的文件，用于指定被吊销的证书列表；
	-k --insecure	(SSL)设置此选项将允许使用无证书的不安全SSL进行连接和传输。
SSL 其他	--ciphers <list of ciphers>	(SSL)指定SSL要使用的加密方式；如：“aes_256_sha_256”；
	--engine <name>	设置一个OpenSSL加密引擎用于加密操作；使用“curl --engine list”查看支持的加密引擎列表；
	--random-file	(SSL)指定包含随机数据的文件路径名；数据是用来为SSL连接产生随机种子为；
	--egd-file <file>	(SSL)为随机种子生成器EGD(Entropy Gathering Daemon socket)指定的路径名；
	-1/--tlsv1 --tlsv1.0 --tlsv1.1 --tlsv1.2 -2/--sslv2 -3/--sslv3	(SSL)使用TLS版本2与远程服务器通讯； (SSL)使用TLS 1.0版本与远程服务器通讯； (SSL)使用TLS 1.1版本与远程服务器通讯； (SSL)使用TLS 1.2版本与远程服务器通讯； (SSL)使用SSL版本2与远程服务器通讯； (SSL)使用SSL版本3与远程服务器通讯；
私钥公钥	--key <key>	(SSL/SSH)指定一个私钥文件名；为指定时自动尝试使用下面文件：“~/.ssh/id_rsa”、“~/.ssh/id_dsa”、“./id_rsa'”、 “./id_dsa”；
	--key-type <type>	(SSL)指定私钥文件类型，支持：DER、PEM、ENG，默认是PEM；
	--pass <phrase>	(SSL/SSH)指定私钥文件的密码；
	--pubkey <key>	(SSH)使用指定文件提供的您公钥；
FTP	-P --ftp-port <接口>	(FTP)FTP主动模式时，设置一个地址等待服务器的连接，如：网卡：eth1 IP：8.8.8.8 主机名：aiezu.com 可以加端口号：eth1:20000-21000;
	--crlf	(FTP)上传时将换行符(LF)转换为回车换行(CRLF)；
	--ftp-account [data]	(FTP)ftp帐号信息；
	--ftp-method [method]	(FTP)可选值：multicwd/nocwd/singlecwd；
	--ftp-pasv	(FTP)使用使用PASV(被动)/EPSV模式；
	--ftp-skip-pasv-ip	(FTP)使用PASV的时,跳过指定IP；
	--ftp-create-dirs	(FTP)上传时自动创建远程目录；
	-l --list-only	(FTP)列出ftp文件列表；
	-B --use-ascii	(FTP/LDAP)使用Ascii传输模式，用于FTP、LDAP；在ftp中相当与使用了“type=A;”模式。
	--disable-epsv	(FTP)告诉curl在PASV(被动模式)时不要使用EPSV；
	--disable-eprt	(FTP)告诉curl在主动模式时禁用EPRT和LPRT；
限速	--limit-rate <speed>	限制curl使用的最大带宽；如果未指定单位，默认单位为“bytes/秒”，你也可以指定单位为“K”、“M”、“G”等单位，如：“--limit-rate 1m”为限制最大使用带宽为“1m字节/秒”；
	-y --speed-time <time>	If a download is slower than speed-limit bytes per second during a speed-time period, the download gets aborted. If speed-time is used, the default speed-limit will be 1 unless set with -Y. This option controls transfers and thus will not affect slow connects etc. If this is a concern for you, try the --connect-timeout option.
	-Y --speed-limit <speed>	If a download is slower than this given speed (in bytes per second) for speed-time seconds it gets aborted. speed-time is set with -y and is 30 if not set.
其他选项	-0/--http1.0	(HTTP) 强制curl使用HTTP 1.0而不是使用默认的HTTP 1.1；
	--interface <name>	使用指定的网卡接口访问； curl --interface eth0 http://aiezu.com curl --interface 10.0.0.101 http://aiezu.com
	-X <command> --request <command>	（HTTP）指定与服务器通信使用的请求方法，如：GET、PUT、POST、DELETE等，默认GET；
	--keepalive-time <seconds>	设置keepalive时间
	--no-keepalive	关闭keepalive功能；
	--no-buffer	禁用对输出流缓冲；
	--buffer	启用输出流缓冲；
	-L --location	(HTTP/HTTPS)追随http响应头“Location：”定向到跳转后的页面； (在http响应码为3XX时使用，如301跳转、302跳转)
	--location-trusted	(HTTP/HTTPS)同“--location”，但跳转后会发送跳转前的用户名和密码；
	--compressed	(HTTP)请求对返回内容使用压缩算法进行压缩；curl支持对gzip压缩进行解压；
	--connect-timeout <seconds>	指定最大连接超时，单位“秒”；
	-m seconds --max-time seconds	限制整个curl操作的最长时间，单位为秒；
	-s --silent	安静模式。不要显示进度表或错误消息；
	-# --progress-bar	显示进度条；
错误选项	-f --fail	(HTTP)连接失败时（400以上错误）不返回默认错误页面，而是返回一个curl错误码“22”；
	--retry <num> --retry-delay <seconds> --retry-max-time <seconds>	失败重试次数；重试间隔时间；最大重试时间；
	-S --show-error	安静模式下显示错误信息；
	--stderr <file>	错误信息保存文件；
输出	-o file --output file	将返回内容输出到文件。如果是用过通配符获取多个url，可以使用“#”后跟“数字序号”，curl会自动将它替换对应的关键词，如：　　curl "http://aiezu.com/{a,b}.txt" -o "#1.txt"; 　　将保存为：“a.txt”,“b.txt”; 　　curl "http://aiezu.com/{a,b}_[1-3].txt" -o "#1#2.txt"; 　　将保存为：a1.txt、a2.txt、a3.txt、b1.txt、b2.txt、b3.txt 　　如果要根据规则创建保存目录，参考：“--create-dirs” 指定“-”将定向到标准输出“如控制台”；
	-O --remote-name	将返回内容输出到当前目录下，和url中文件名相同的文件中（不含目录）；
	--create-dirs	与“-o”参数配合使用，创建必要的本地目录层次结构
	-w --write-out format	操作完成后在返回信息尾部追加指定的内容；要追加的内容可以是一个字符串“string”、从文件中获取“@filename”、从标准输入中获取“@-” 格式参数中可以用%{variable_name} 方式使用响应信息的相关变量，如：%{content_type}、%{http_code}、%{local_ip}...，更多变量参考“man curl”获取；格式参数可以使用“\n”、“\r”、“\t”等转义字符；
调试	--trace <file>	转储所有传入和传出的数据到文件，包括描述信息；使用“-”作为文件名将输出发送到标准输出。
	--trace-ascii file	转储所有传入和传出的数据到文件，包括描述信息，只转储ASCII部分，更容易阅读；使用“-”作为文件名将输出发送到标准输出。这个选项会覆盖之前使用的-v、 --verbose、 --trace-ascii选项；
	--trace-time	转储文件中添加时间信息；
	-K --config <config file>	从配置文件中读取参数，参考：http://curl.haxx.se/docs/
	-v --verbose	显示更详细的信息，调试时使用；
帮助	-M --manual	显示完整的帮助手册；
帮助	-h --help	linux curl用法帮助；

2 参数分类

# 调试类
-v, --verbose                          输出信息
-q, --disable                          在第一个参数位置设置后 .curlrc 的设置直接失效，这个参数会影响到 -K, --config -A, --user-agent -e, --referer
-K, --config FILE                      指定配置文件
-L, --location                         跟踪重定向 (H)

# CLI显示设置
-s, --silent                           Silent模式。不输出任务内容
-S, --show-error                       显示错误. 在选项 -s 中，当 curl 出现错误时将显示
-f, --fail                             不显示 连接失败时HTTP错误信息
-i, --include                          显示 response的header (H/F)
-I, --head                             仅显示 响应文档头
-l, --list-only                        只列出FTP目录的名称 (F)
-#, --progress-bar                     以进度条 显示传输进度

# 数据传输类
-X, --request [GET|POST|PUT|DELETE|…]  使用指定的 http method 例如 -X POST
-H, --header <header>                  设定 request里的header 例如 -H "Content-Type: application/json"
-e, --referer                          设定 referer (H)
-d, --data <data>                      设定 http body 默认使用 content-type application/x-www-form-urlencoded (H)
    --data-raw <data>                  ASCII 编码 HTTP POST 数据 (H)
    --data-binary <data>               binary 编码 HTTP POST 数据 (H)
    --data-urlencode <data>            url 编码 HTTP POST 数据 (H)
-G, --get                              使用 HTTP GET 方法发送 -d 数据 (H)
-F, --form <name=string>               模拟 HTTP 表单数据提交 multipart POST (H)
    --form-string <name=string>        模拟 HTTP 表单数据提交 (H)
-u, --user <user:password>             使用帐户，密码 例如 admin:password
-b, --cookie <data>                    cookie 文件 (H)
-j, --junk-session-cookies             读取文件中但忽略会话cookie (H)
-A, --user-agent                       user-agent设置 (H)

# 传输设置
-C, --continue-at OFFSET               断点续转
-x, --proxy [PROTOCOL://]HOST[:PORT]   在指定的端口上使用代理
-U, --proxy-user USER[:PASSWORD]       代理用户名及密码

# 文件操作
-T, --upload-file <file>               上传文件
-a, --append                           添加要上传的文件 (F/SFTP)

# 输出设置
-o, --output <file>                    将输出写入文件，而非 stdout
-O, --remote-name                      将输出写入远程文件
-D, --dump-header <file>               将头信息写入指定的文件
-c, --cookie-jar <file>                操作结束后，要写入 Cookies 的文件位置

3 完整参数

在以下选项中，(H) 表示仅适用 HTTP/HTTPS ，(F) 表示仅适用于 FTP
    --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 如果作为第一个参数无效

三常用操作

0 获取网页内容

当我们不加任何选项使用 curl 时，默认会发送 GET 请求来获取链接内容到标准输出。

curl http://www.baidu.com

1 -d 发送 POST 请求

我们以登陆网页为例来进行说明使用 CURL 发送 POST 请求的方法。假设有一个登录页面 www.example.com/login，只需要提交用户名和密码便可登录。我们可以使用 CURL 来完成这一 POST 请求，-d 用于指定发送的数据，-X 用于指定发送数据的方式：

curl -d "userName=tom&passwd=123456" -X POST http://www.example.com/login

在使用 -d 的情况下，如果省略 -X，则默认为 POST 方式：

curl -d "userName=tom&passwd=123456" http://www.example.com/login

等同于GET方式：

GET模式什么option都不用，只需要把变量写在url里面就可以了

curl http://www.yahoo.com/login.cgi?user=nick&password=12345

强制使用 GET 方式

发送数据时，不仅可以使用 POST 方式，也可以使用 GET 方式，例如：

curl -d "somedata" -G http://www.example.com/api

从文件中读取数据, @+文件名

curl -d "@data.txt" http://www.example.com/login

带 Cookie 登录

当然，如果我们再次访问该网站，仍然会变成未登录的状态。我们可以用之前提到的方法保存 Cookie，在每次访问网站时都带上该 Cookie 以保持登录状态。

curl -c "cookie-login" -d "userName=tom&passwd=123456" http://www.example.com/login

再次访问该网站时，使用以下命令：

curl -b "cookie-login" http://www.example.com/login

这样，就能保持访问的是登录后的页面了。

2 -I 显示http头

如果我们只想要显示 HTTP 头，而不显示文件内容，可以使用 -I 选项, 同时显示 HTTP 头和文件内容，使用 -i 选项：

curl http://www.baidu.com -I

HTTP/1.1 200 OK
Accept-Ranges: bytes
Cache-Control: private, no-cache, no-store, proxy-revalidate, no-transform
Connection: keep-alive
Content-Length: 277
Content-Type: text/html
Date: Fri, 17 Jun 2022 07:10:52 GMT
Etag: "575e1f65-115"
Last-Modified: Mon, 13 Jun 2016 02:50:13 GMT
Pragma: no-cache
Server: bfe/1.0.8.18

3 -o 抓取网页内容到文件

我们可以使用 > 符号将输出重定向到本地文件中。

curl http://www.baidu.com > index.html

也可以通过 curl 自带的 -o/-O 选项将内容保存到文件中。

-o（小写的 o）：结果会被保存到命令行中提供的文件名
-O（大写的 O）：-O后面的url必须具体到服务器的某个文件，不然会抓取失败。

注意：使用 -O 选项时，必须确保链接末尾包含文件名，否则 curl 无法正确保存文件。如果遇到链接中无文件名的情况，应该使

用 -o 选项手动指定文件名，或使用重定向符号。

curl -o index.html http://www.baidu.com

-O抓取文件

curl -O http://www.baidu.com/img/bdlogo.gif

4 同时下载多个文件

我们可以使用 -o 或 -O 选项来同时指定多个链接，按照以下格式编写命令：

curl -o page1.html http://www.codebelief.com/page/1/ -o page2.html http://www.codebelief.com/page/2/

5 -L 跟随链接重定向

如果直接使用 curl 打开某些被重定向后的链接，这种情况下就无法获取我们想要的网页内容。例如：

curl http://codebelief.com

会得到如下提示：

<html> 
<head><title>301 Moved Permanently</title></head> 
<body bgcolor="white"> 
<center><h1>301 Moved Permanently</h1></center> 
<hr><center>nginx/1.10.3</center> 
</body> 
</html>

而当我们通过浏览器打开该链接时，会自动跳转到 http://www.codebelief.com。此时我们想要 curl 做的，就是像浏览器一样跟随链接的跳转，获取最终的网页内容。我们可以在命令中添加 -L 选项来跟随链接重定向：

curl -L http://codebelief.com

这样我们就能获取到经过重定向后的网页内容了。

6 -A 自定义 User-Agent

我们可以使用 -A 来自定义用户代理，例如下面的命令将伪装成安卓火狐浏览器对网页进行请求：

curl -A "Mozilla/5.0 (Android; Mobile; rv:35.0) Gecko/35.0 Firefox/35.0" http://www.baidu.com

当我们需要传递特定的 header 的时候，可以仿照以下命令来写：

curl -H "Referer: www.example.com" -H "User-Agent: Custom-User-Agent" http://www.baidu.com

可以看到，当我们使用 -H 来自定义 User-Agent 时，需要使用 "User-Agent: xxx" 的格式。

我们能够直接在 header 中传递 Cookie，格式与上面的例子一样：

curl -H "Cookie: JSESSIONID=D0112A5063D938586B659EF8F939BE24" http://www.example.com

当我们使用 CURL 访问页面的时候，默认是不会保存 Cookie 的。有些情况下我们希望保存 Cookie 以便下次访问时使用。例如登陆了某个网站，我们希望再次访问该网站时保持登陆的状态，这时就可以现将登陆时的 Cookie 保存起来，下次访问时再读取。

-c 后面跟上要保存的文件名。

curl -c "cookie-example" http://www.example.com

前面讲到了使用 -H 来发送 Cookie 的方法，这种方式是直接将 Cookie 字符串写在命令中。如果使用 -b 来自定义 Cookie，命令如下：

curl -b "JSESSIONID=D0112A5063D938586B659EF8F939BE24" http://www.example.com

如果要从文件中读取 Cookie，-H 就无能为力了，此时可以使用 -b 来达到这一目的：

curl -b "cookie-example" http://www.example.com

即 -b 后面既可以是 Cookie 字符串，也可以是保存了 Cookie 的文件名。

10 模拟表单信息，模拟登录，保存cookie信息

curl -c ./cookie_c.txt -F log=aaaa -F pwd=****** http://www.XXXX.com/wp-login.php

11 模拟表单信息，模拟登录，保存头信息

curl -D ./cookie_D.txt -F log=aaaa -F pwd=****** http://www.XXXX.com/wp-login.php

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

12 断点续传，-C(大写)

curl -C -O http://www.baidu.com/img/bdlogo.gif

13 显示抓取错误

curl -f http://www.XXXX.com

14 伪造来源地址

curl -e http://localhost http://www.baidu.com

15 使用代理

curl -x 24.10.28.84:32779 -o home.html http://www.XXXX.com

16 大文件分段下载

curl -r 0-100 -o img.part1 http://xxx.tar.gz
curl -r 100-200 -o img.part2 http://xxx.tar.gz
curl -r 200- -o img.part3 http://xxx.tar.gz
cat img.part* >xxx.tar.gz

显示文件大小

 ls |grep part | xargs du -sh

17 显示下载进度信息

显示下载进度

curl  -0 http://www.baidu.com/img/bdlogo.gif

不显示下载进度

curl -s -o aaa.jpg http://www.baidu.com/img/bdlogo.gif

18 通过ftp下载文件

curl -u 用户名:密码 -O 文件url

curl -O ftp://用户名:密码@ip:port/xxx/文件名

19 通过ftp上传文件

curl -T 上传文件名 ftp://用户名:密码@ip:port/路径

20 模拟浏览器头

curl -A "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)" -x 123.45.67.89:1080 -o page.html -D cookie0001.txt http://www.www.baidu.com

四特殊字符处理

1 GET请求处理

1.1 将整个`URL`都用双引号“”或者单引号\'\'括起来

curl \'http://restapi.amap.com/v3/geocode/geo?address=山东省青岛市崂山区深圳路178号丽海馨苑&output=JSON&key=abc\'
curl "http://restapi.amap.com/v3/geocode/geo?address=山东省青岛市崂山区深圳路178号丽海馨苑&output=JSON&key=abc"

1.2 您可以在特殊字符前使用\'\\'号。

curl http://restapi.amap.com/v3/geocode/geo?address=山东省青岛市崂山区深圳路178号丽海馨苑\&output=JSON\&key=abc

2 POST请求处理

传递账号密码，但是含有特殊字符

curl -d name=john passwd=@31&3*J https://www.mysite.com

2.1 cURL> 7.18.0具有选项`--data-urlencode`，它可以解决此问题。使用这个，我可以简单地发送一个POST请求作为

curl -d name=john --data-urlencode passwd=@31&3*J https://www.mysite.com

2.2 使用urlencode之后的数据

curl -d \'name=john&passwd=%4031%263*J\' https://www.mysite.com

2.3 您可以在特殊字符前使用\'\\'号。

passwd=\@31\&3*J

2.4 变量

export CURLNAME="john:@31&3*J"
curl -d -u "${CURLNAME}" https://www.example.com

posted @ 2022-06-17 15:50 IllidanStormrage 阅读(394) 评论(0) 编辑收藏举报

刷新页面返回顶部

Illidon

curl手册

简介

一语法

二参数详解

1 参数对照表

2 参数分类

3 完整参数

三常用操作

0 获取网页内容

1 -d 发送 POST 请求

2 -I 显示http头

3 -o 抓取网页内容到文件

4 同时下载多个文件

5 -L 跟随链接重定向

6 -A 自定义 User-Agent

7 -H 自定义 header

10 模拟表单信息，模拟登录，保存cookie信息

11 模拟表单信息，模拟登录，保存头信息

12 断点续传，-C(大写)

13 显示抓取错误

14 伪造来源地址

15 使用代理

16 大文件分段下载

17 显示下载进度信息

18 通过ftp下载文件

19 通过ftp上传文件

20 模拟浏览器头

四特殊字符处理

1 GET请求处理

1.1 将整个`URL`都用双引号“”或者单引号\'\'括起来

1.2 您可以在特殊字符前使用\'\\'号。

2 POST请求处理

2.1 cURL> 7.18.0具有选项`--data-urlencode`，它可以解决此问题。使用这个，我可以简单地发送一个POST请求作为

2.2 使用urlencode之后的数据

2.3 您可以在特殊字符前使用\'\\'号。

2.4 变量

公告

Illidon

curl手册

简介

一 语法

二 参数详解

1 参数对照表

2 参数分类

3 完整参数

三 常用操作

0 获取网页内容

1 -d 发送 POST 请求

2 -I 显示http头

3 -o 抓取网页内容到文件

4 同时下载多个文件

5 -L 跟随链接重定向

6 -A 自定义 User-Agent

7 -H 自定义 header

8 -c 保存 Cookie

9 -b 读取 Cookie

10 模拟表单信息，模拟登录，保存cookie信息

11 模拟表单信息，模拟登录，保存头信息

12 断点续传，-C(大写)

13 显示抓取错误

14 伪造来源地址

15 使用代理

16 大文件分段下载

17 显示下载进度信息

18 通过ftp下载文件

19 通过ftp上传文件

20 模拟浏览器头

四 特殊字符处理

1 GET请求处理

1.1 将整个URL都用双引号“”或者单引号\'\'括起来

1.2 您可以在特殊字符前使用\'\\'号。

2 POST请求处理

2.1 cURL> 7.18.0具有选项--data-urlencode，它可以解决此问题。 使用这个，我可以简单地发送一个POST请求作为

2.2 使用urlencode之后的数据

2.3 您可以在特殊字符前使用\'\\'号。

2.4 变量

公告

一语法

二参数详解

三常用操作

四特殊字符处理

1.1 将整个`URL`都用双引号“”或者单引号\'\'括起来

2.1 cURL> 7.18.0具有选项`--data-urlencode`，它可以解决此问题。使用这个，我可以简单地发送一个POST请求作为