curl 深度教程

curl 深度教程

curl（Client URL）是世界上最广泛使用的命令行数据传输工具之一，支持 HTTP、HTTPS、FTP、SMTP 等数十种协议。从简单的网页抓取到复杂的 API 调试，从容器健康检查到大规模自动化测试，curl 无处不在。

为什么写这个教程？

curl 的 man page 超过 5000 行，官网列出 250+ 个命令行选项。大多数开发者只会用到 curl https://example.com 这一层面，但 curl 的真正威力远不止于此：

• 🔍 精确控制每一个 HTTP 请求细节
• 🔐 支持从 Basic 到 OAuth2 的全链路认证
• 📦 原生支持 multipart/form-data 文件上传
• 🛡️ TLS/SSL 证书验证与客户端证书
• 📊 请求时间分析与连接诊断
• 🐳 Docker 健康检查与容器间通信
• 📝 完整的脚本化能力，可嵌入 CI/CD 流水线

教程目录

本教程共 15 章，从基础概念到高级实践，适合各层次开发者：

阅读建议

• 初学者：从第 01-03 章开始，掌握基本概念和用法
• 后端开发者：重点阅读第 04-07 章（HTTP 方法与数据传输）和第 13 章（API 测试）
• 运维/SRE：重点阅读第 08-09 章（传输管理）、第 12 章（调试）和第 14 章（Docker）
• 安全工程师：重点阅读第 06 章（认证）和第 10 章（TLS/SSL）
• 效率追求者：直接跳到第 15 章（最佳实践）

环境说明

本教程中所有命令示例均基于以下环境：

⚠️ 注意：curl 的行为和可用选项可能因编译选项和版本不同而有差异。使用 curl --version 查看你的 curl 版本和支持的特性。

快速开始

如果你已经安装了 curl，可以直接体验：

# 查看版本和支持的协议
curl --version

# 发送一个简单的 GET 请求
curl https://httpbin.org/get

# 带参数的 GET 请求
curl "https://httpbin.org/get?name=curl&version=8"

# 发送 POST 请求（JSON）
curl -X POST https://httpbin.org/post \
  -H "Content-Type: application/json" \
  -d '{"hello": "world"}'

# 下载文件并显示进度
curl -LO https://example.com/file.zip

# 调试模式查看完整请求/响应
curl -v https://httpbin.org/get

扩展阅读

• curl 官方文档
• curl man page
• Everything curl（免费在线书）
• libcurl C API
• curl GitHub 仓库
• HTTP/2 与 curl