curl命令行

July 1, 2023

文档：https://curl.se/docs/manpage.html
参考：https://curl.dev/

以下仅使用 http 协议

Usage: curl [options...] <url>

一般来说，filename 参数指定为 - 字符则从 stdin 读取
data 参数若以 @ 开头，视为二进制文件；以 < 开头视为文本文件。
剩余部分为文件名，可通过双引号包含（文件名含特殊字符时）

请求选项

--url <url>
# 指定目标 URL。一般不需要这个选项

-X, --request <method>
# 指定请求方法，如 GET/POST

-I, --head
# 发送 HEAD 请求，并输出响应头

-G, --get
# 将 -d 选项的行为改变为 添加 查询字符串 而不是 请求体
# 例如 -G -d q=a

--url-query <data>
# 添加查询字符串，不改变请求方法
# 格式为  key=val  =key  key@file_as_val  @file_as_key  +unencoded

-L, --location
# 跟随服务器重定向

--location-trusted
# 跟随服务器重定向，并且跟随发送 -u 选项发送的账号密码

-u, --user <user:password>
# 指定账号密码

-n, --netrc
# 使用 ~/.netrc (_netrc on Windows) 来指定账号密码

-H, --header <header/@file>
# 添加 http 请求头，如 -H 'Content-Type: application/json' （可多次使用）

-k, --insecure
# 跳过 ssl 检测

-d, --data <data>
# 默认为 POST 请求添加请求体，如 -d a=1 （多次使用时，直接将数据连接）
# 自动添加 "Content-Type: application/x-www-form-urlencoded" 请求头

--data-urlencode <data>
# -d 选项不编码，这个选项会编码。如果有多个字段，应多次使用此选项，不能 --data-urlencode a=1&b=2
# 而应该 --data-urlencode a=1 --data-urlencode b=2

--data-raw <data>
# POST 请求直接发送二进制数据

--json <data>
# POST 请求发送 json
# 自动添加 "Content-Type: application/json" 和 "Accept: application/json" 请求头

-F, --form <name=content>
# POST 请求发送文件，例如 -F "story=<file.txt" -F "image=@file.jpg" -F "web=@index.html;type=text/html"
# 自动添加 Content-Type: multipart/form-data 请求头

-A, --user-agent <name>
# 指定 User-Agent，若为空则不发送 User-Agent 请求头

-e, --referer <URL>
# 指定 Referer

-b, --cookie <data|filename>
# 若格式为 "NAME1=VALUE1; NAME2=VALUE2" ，则指定 Cookie 请求头为此字符串
# 否则字符串视为文件路径，读取文件再设置 Cookie 头。配合 -c 选项使用

-c, --cookie-jar <filename>
指定将服务器返回的 Set-Cookie 响应头写入文件

客户端选项

-i
# 输出响应头

-K, --config <file>
# 手动指定配置文件

--limit-rate <speed>
# 限制每秒发送的比特数，可使用 k,m,g,t,p 单位。1024 based

-o, --output <file>
# 输出到文件而不是 stdout

-O, --remote-name
# 输出到和远程文件名的同名文件

-J, --remote-header-name
# 令 -O 选项从 Content-Disposition  响应头获取文件名而不是从 url 中获取

--remove-on-error
# 请求失败时将写入的文件移除

-f, --fail
http 响应表明为错误时（例如：状态码不是 2xx 3xx）尽快使命令错误退出，
并且不要输出（例如：404 响应时还会有响应体）

-s, --silent
# 安静模式，不显示进度条和错误信息

-S, --show-error
# 令 -s 选项，显示错误信息

-v, --verbose
# 详细模式

--socks5 <host[:port]>
-x, --proxy [protocol://]host[:port]
# 指定代理

←Back to home