快速掌握 curl 命令选项

快速掌握 curl 命令选项 | AI生成和翻译

Home 2026.02

curl (Client URL) 是一个强大的命令行工具，用于使用各种网络 protocols 传输数据。以下是其最常用选项的详细指南。

Basic Usage

curl https://example.com

这将获取并显示该 URL 的内容。

Essential Options

**-o, –output ** — 将输出保存到文件而不是 stdout：

curl -o page.html https://example.com

-O, –remote-name — 使用与远程文件相同的文件名保存：

curl -O https://example.com/file.zip

-L, –location — 跟随 redirects（对许多现代 URL 至关重要）：

curl -L https://example.com

-i, –include — 在输出中包含 HTTP response headers：

curl -i https://example.com

-I, –head — 仅获取 headers（HEAD request）：

curl -I https://example.com

-v, –verbose — 显示有关 request/response 的详细信息：

curl -v https://example.com

-s, –silent — 静默模式，不显示进度或错误信息：

curl -s https://example.com

HTTP Methods

**-X, –request ** — 指定 HTTP method：

curl -X POST https://api.example.com/data
curl -X DELETE https://api.example.com/resource/123

**-d, –data ** — 发送 POST 数据（自动设置 POST method）：

curl -d "name=John&age=30" https://api.example.com/users
curl -d @data.json https://api.example.com/users  # from file

**–data-urlencode ** — 在发送前进行 URL-encode 数据：

curl --data-urlencode "name=John Doe" https://api.example.com

Headers

-H, –header <header> — 添加自定义 headers：

curl -H "Content-Type: application/json" https://api.example.com
curl -H "Authorization: Bearer TOKEN" -H "Accept: application/json" https://api.example.com

**-A, –user-agent ** — 设置 User-Agent header：

curl -A "Mozilla/5.0" https://example.com

**-e, –referer ** — 设置 Referer header：

curl -e "https://google.com" https://example.com

Authentication

**-u, –user ** — HTTP Basic Authentication：

curl -u username:password https://api.example.com
curl -u username https://api.example.com  # 提示输入密码

**–oauth2-bearer ** — OAuth 2.0 Bearer Token：

curl --oauth2-bearer "your_token_here" https://api.example.com

Cookies

**-b, –cookie ** — 发送 cookies：

curl -b "session=abc123" https://example.com
curl -b cookies.txt https://example.com  # from file

**-c, –cookie-jar ** — 将 cookies 保存到文件：

curl -c cookies.txt https://example.com

File Uploads

-F, –form <name=content> — 提交表单数据（multipart/form-data）：

curl -F "file=@document.pdf" https://api.example.com/upload
curl -F "name=John" -F "avatar=@photo.jpg" https://api.example.com/profile

**-T, –upload-file ** — 通过 PUT 上传文件：

curl -T file.txt https://example.com/upload

Download Options

**-C, –continue-at ** — 断点续传：

curl -C - -O https://example.com/largefile.zip  # 自动检测 offset

**–limit-rate ** — 限制传输速度：

curl --limit-rate 100K https://example.com/file.zip

**-r, –range ** — 仅下载特定范围的字节：

curl -r 0-999 https://example.com/file.zip  # 前 1000 字节

SSL/TLS Options

-k, –insecure — 跳过 SSL 证书校验（谨慎使用）：

curl -k https://self-signed.example.com

**–cacert ** — 指定 CA 证书：

curl --cacert ca-bundle.crt https://example.com

**–cert ** — 使用客户端证书：

curl --cert client.pem https://example.com

Timeouts and Retries

**–connect-timeout ** — 最大连接时间：

curl --connect-timeout 10 https://example.com

**-m, –max-time ** — 最大总操作时间：

curl -m 30 https://example.com

**–retry ** — 重试次数：

curl --retry 5 https://example.com

Proxy

-x, –proxy <[protocol://]host[:port]> — 使用代理：

curl -x http://proxy.example.com:8080 https://example.com
curl -x socks5://localhost:9050 https://example.com

**-U, –proxy-user ** — 代理身份验证：

curl -x proxy.example.com:8080 -U user:pass https://example.com

Output Formatting

**-w, –write-out ** — 显示自定义信息：

curl -w "Status: %{http_code}\nTime: %{time_total}s\n" https://example.com

有用的格式化变量包括 %{http_code}, %{time_total}, %{size_download}, %{speed_download}。

–compressed — 请求压缩响应：

curl --compressed https://example.com

Multiple URLs

-Z, –parallel — 并行处理多个 URL：

curl -Z https://example.com/file1 https://example.com/file2

你也可以使用花括号扩展：

curl https://example.com/file[1-10].txt
curl https://example.com/{page1,page2,page3}.html

Practical Examples

JSON API request:

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -d '{"name":"John","email":"john@example.com"}'

带有进度条的下载：

curl -# -o file.zip https://example.com/file.zip

检查网站响应时间：

curl -w "@curl-format.txt" -o /dev/null -s https://example.com

其中 curl-format.txt 包含：

time_namelookup:  %{time_namelookup}s
time_connect:     %{time_connect}s
time_total:       %{time_total}s

这涵盖了最常用的 curl 选项。如需完整列表，请在系统中运行 curl --help 或 man curl。

Back Donate