cURL 常用操作指南

cURL (Client URL) 是一个强大的命令行工具，用于传输数据，支持多种协议（HTTP/HTTPS/FTP/SFTP等）。它广泛用于 API 测试、文件传输和网络调试。

1. 基本请求

GET 请求

curl https://example.com

• 获取网页内容
• 带参数：

  curl "https://example.com/api?param1=value1&param2=value2"
  

POST 请求

curl -X POST https://example.com/api \
     -d "key1=value1&key2=value2"

• 发送 JSON 数据：

  curl -X POST https://example.com/api \
       -H "Content-Type: application/json" \
       -d '{"key1":"value1", "key2":"value2"}'
  

2. 请求头设置

添加自定义 Header

curl -H "Authorization: Bearer token123" \
     -H "User-Agent: MyApp/1.0" \
     https://example.com/api

• 查看服务器返回的 Headers：

  curl -I https://example.com  # 只显示 Headers
  

3. 文件上传 & 下载

上传文件

curl -X POST https://example.com/upload \
     -F "file=@/path/to/file.txt" \
     -F "name=myfile"

• -F 用于 multipart/form-data 上传

下载文件

curl -O https://example.com/file.zip  # 保存为原文件名
curl -o custom_name.zip https://example.com/file.zip  # 自定义文件名

4. 认证 & Cookies

Basic Auth

curl -u username:password https://example.com

• 或只输入用户名，交互式输入密码：

  curl -u username https://example.com
  

Cookie 管理

curl --cookie "name=value" https://example.com

• 保存 Cookie 到文件：

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

• 使用 Cookie 文件：

  curl -b cookies.txt https://example.com/dashboard
  

5. 调试 & 高级选项

显示详细请求信息

curl -v https://example.com  # 显示请求 & 响应 Headers
curl --trace-ascii debug.txt https://example.com  # 输出调试信息到文件

跟随重定向

curl -L https://example.com  # 自动跳转

限速下载

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

• 100K = 100KB/s，可设置 M (MB/s) 或 G (GB/s)

6. 代理设置

HTTP/HTTPS 代理

curl -x http://proxy-server:8080 https://example.com

• 带认证的代理：

  curl -x http://user:pass@proxy-server:8080 https://example.com
  

SOCKS5 代理

curl --socks5 127.0.0.1:1080 https://example.com

7. 保存响应到变量（Bash）

response=$(curl -s https://example.com/api)
echo "$response"

• -s 静默模式（不显示进度）

8. 常用组合命令

检查 API 返回状态码

curl -s -o /dev/null -w "%{http_code}" https://example.com/api

• -o /dev/null 丢弃响应体
• -w "%{http_code}" 只显示 HTTP 状态码

测试 API 响应时间

curl -w "DNS: %{time_namelookup} | Connect: %{time_connect} | Total: %{time_total}\n" \
     -o /dev/null -s https://example.com

总结

cURL 功能非常强大，适用于自动化脚本、API 测试和网络调试。更多选项可查看 man curl 或 curl --help。