Linux curl 命令完全指南：从入门到精通

# Debian/Ubuntu
sudo apt install curl -y

# CentOS/RHEL/Rocky
sudo dnf install curl -y

# Alpine
apk add curl

# macOS（Homebrew）
brew install curl

curl --version

# 获取网页内容
curl https://example.com

# 获取 HTTP 响应头
curl -I https://example.com

# 静默模式（不显示进度信息）
curl -s https://api.github.com

# GET 请求（默认）
curl https://api.example.com/users

# POST 请求
curl -X POST https://api.example.com/users

# PUT 请求
curl -X PUT https://api.example.com/users/1

# DELETE 请求
curl -X DELETE https://api.example.com/users/1

# PATCH 请求
curl -X PATCH https://api.example.com/users/1

# URL 编码表单数据（Content-Type: application/x-www-form-urlencoded）
curl -X POST -d "name=Alice&email=alice@example.com" https://api.example.com/users

# JSON 数据（需要指定 Content-Type）
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice","email":"alice@example.com"}' \
  https://api.example.com/users

# 从文件读取请求体
curl -X POST -H "Content-Type: application/json" -d @data.json https://api.example.com/users

# 设置单个 Header
curl -H "Authorization: Bearer token123" https://api.example.com/protected

# 设置多个 Headers
curl -H "Authorization: Bearer token123" \
  -H "Accept: application/json" \
  -H "User-Agent: MyApp/1.0" \
  https://api.example.com/protected

# 发送 Cookie
curl -b "session_id=abc123; user=alice" https://example.com/profile

# 从文件读取 Cookie
curl -b cookies.txt https://example.com/profile

# 将服务器返回的 Cookie 保存到文件（Cookie Jar）
curl -c cookies.txt https://example.com/login -d "username=admin&password=secret"

# 保存为指定文件名
curl -o myfile.zip https://example.com/files/large.zip

# 使用远程文件名保存
curl -O https://example.com/files/large.zip

# 断点续传（假设上次下载到 50%）
curl -C - -o myfile.zip https://example.com/files/large.zip

# 限制下载速度（100KB/s）
curl --limit-rate 100K -O https://example.com/files/large.zip

# 显示下载进度条
curl -# -O https://example.com/files/large.zip

# 表单文件上传（模拟 <input type="file">）
curl -F "file=@/path/to/photo.jpg" https://example.com/upload

# 指定表单字段名和 MIME 类型
curl -F "avatar=@photo.jpg;type=image/jpeg" https://example.com/upload

# FTP 上传
curl -T localfile.txt ftp://ftp.example.com/upload/

# 方式一：-u 选项
curl -u username:password https://api.example.com/protected

# 方式二：URL 中嵌入凭据
curl https://username:password@api.example.com/protected

# 方式三：使用 ~/.netrc 文件（更安全）
# 文件内容：machine api.example.com login username password password
curl -n https://api.example.com/protected

# OAuth2 或 JWT 认证
curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." https://api.example.com/protected

# 跳过证书验证（仅用于测试，不安全）
curl -k https://self-signed.example.com

# 指定客户端证书
curl --cert client.crt --key client.key https://api.example.com

# 指定 CA 证书路径
curl --cacert /path/to/ca-bundle.crt https://api.example.com

# 查看 SSL 连接详细信息
curl -v https://example.com 2>&1 | grep -E "SSL|TLS|certificate"

# 1. 获取用户列表（GET）
curl -s https://jsonplaceholder.typicode.com/users | head -20

# 2. 创建新用户（POST）
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice","username":"alice","email":"alice@example.com"}' \
  https://jsonplaceholder.typicode.com/users

# 3. 更新用户（PUT）
curl -s -X PUT \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice Updated"}' \
  https://jsonplaceholder.typicode.com/users/1

# 4. 部分更新（PATCH）
curl -s -X PATCH \
  -H "Content-Type: application/json" \
  -d '{"email":"newemail@example.com"}' \
  https://jsonplaceholder.typicode.com/users/1

# 5. 删除用户（DELETE）
curl -s -X DELETE https://jsonplaceholder.typicode.com/users/1

# 查看完整的请求-响应交互过程
curl -v https://api.github.com

# 仅查看响应头
curl -s -D - https://api.github.com -o /dev/null

# 获取响应时间统计
curl -s -w "\n\n========== 时间统计 ==========\n\
DNS 解析: %{time_namelookup}s\n\
TCP 连接: %{time_connect}s\n\
TLS 握手: %{time_appconnect}s\n\
首字节: %{time_starttransfer}s\n\
总耗时: %{time_total}s\n\
下载速度: %{speed_download} bytes/s\n\
HTTP 状态码: %{http_code}\n" \
https://api.github.com -o /dev/null

# 安装 jq
sudo apt install jq -y

# 提取特定字段
curl -s https://api.github.com/repos/curl/curl | jq '.stargazers_count'

# 格式化输出
curl -s https://jsonplaceholder.typicode.com/users | jq '.[] | {name, email, phone}'

# 过滤条件
curl -s https://jsonplaceholder.typicode.com/users | jq '.[] | select(.name | contains("Lea"))'

# 安装并行版本
sudo apt install parallel -y

# 并发请求多个 URL
echo -e "https://api.github.com\nhttps://httpbin.org/get\nhttps://jsonplaceholder.typicode.com/todos/1" | \
  parallel -j 3 "curl -s -o /dev/null -w '%{http_code} %{url_effective}\n' {}"

# HTTP 代理
curl -x http://proxy.example.com:8080 https://httpbin.org/get

# SOCKS5 代理（常用于 SSH 隧道）
curl --socks5 localhost:1080 https://httpbin.org/get

# 带认证的代理
curl -x http://user:pass@proxy.example.com:8080 https://httpbin.org/get

# 创建配置文件 ~/.curlrc
cat > ~/.curlrc << 'EOF'
--connect-timeout 10
--max-time 30
--retry 3
--retry-delay 2
--user-agent "MyCurl/1.0"
EOF

# 之后每次 curl 都会自动应用这些选项
curl https://example.com

curl --mail-from sender@example.com \
  --mail-rcpt recipient@example.com \
  --upload-file mail.txt \
  smtp://smtp.example.com:587 \
  --user sender@example.com:password