内容总览
起源
curl 是一款命令行网络请求工具,底层基于 libcurl 库,支持 HTTP/HTTPS/FTP/SFTP/SMTP 等多种协议。curl 的设计目标不是文件下载,而是精确控制网络请求的每一个细节,因此被广泛用于接口调试、请求模拟、协议测试等场景。Linux/macOS 默认预装,无需额外安装。
原理
- curl 作为客户端,向目标服务器发起网络请求,接收并显示响应
- 默认输出原始响应体到终端,不显示响应头
- 支持完整的 HTTP 请求控制:方法、请求头、Cookie、参数编码、超时控制
- 多协议支持:HTTP/HTTPS/FTP/SFTP/TELNET/LDAP 等
实现
基础用法
直接访问链接,输出内容到终端:
curl https://www.baidu.com
保存内容到文件
# 方式1:-o 指定文件名
curl -o test.html https://www.baidu.com
# 方式2:-O(大写)使用链接原文件名
curl -O https://example.com/1.txt
请求方式
GET 请求(默认):
curl https://api.example.com/get?name=test
POST 请求:
# 普通表单数据
curl -X POST -d "name=test&age=18" https://api.example.com/post
# JSON 格式请求(必须加请求头)
curl -X POST -H "Content-Type: application/json" -d '{"name":"test"}' https://api.example.com/post
请求控制
携带请求头:
curl -H "Token: 123456" -H "User-Agent: mycurl" https://api.example.com
携带 Cookie:
# 临时携带 Cookie
curl -H "Cookie: uid=1001; token=abc" https://api.example.com
# 保存响应 Cookie 到文件
curl -c cookie.txt https://example.com
# 读取文件中的 Cookie 发起请求
curl -b cookie.txt https://example.com
模拟浏览器 User-Agent:
curl -A "Mozilla/5.0 (Windows NT 10.0)" https://example.com
设置超时:
# 总超时 10 秒
curl -m 10 https://www.baidu.com
响应调试
查看完整请求/响应过程:
# 简易日志(显示响应头+响应体)
curl -i https://www.baidu.com
# 完整通信日志(含握手、头、报文)
curl -v https://www.baidu.com
简易接口健康探测:
curl -s -o /dev/null -w "%{http_code}" https://api.example.com
-s:静默模式,不输出响应内容-o /dev/null:丢弃响应内容-w "%{http_code}":只输出 HTTP 状态码
文件操作
文件上传(POST 表单上传):
curl -X POST -F "file=@/本地路径/文件.txt" https://api.example.com/upload
文件下载:
curl -O https://example.com/file.zip
网络与安全
跟随重定向:
curl -L https://example.com
忽略 HTTPS 证书校验(自签名/证书异常):
curl -k https://self-sign-ssl.com
# 等价 --insecure
curl --insecure https://self-sign-ssl.com
SFTP 使用
# 下载 SFTP 文件
curl sftp://用户名:密码@服务器IP/远程文件路径 -o 本地文件名
# 示例
curl sftp://sftpuser:123456@192.168.1.100/data/test.txt -o local_test.txt
内网测试场景可用,生产环境密码明文存在安全风险,建议改用密钥认证的 sftp 命令。
常用组合示例
- POST JSON + 忽略证书 + 自定义请求头
curl -k -X POST -H "Content-Type: application/json" -d '{"data":"hello"}' https://127.0.0.1/api
- 跟随跳转 + 查看响应头
curl -iL https://example.com
curl 与 wget 核心区别
| 工具 | 主打场景 | 优势 | 断点续传 | 批量与递归下载 | 后台运行 | 代理与协议 |
|---|---|---|---|---|---|---|
| curl | 接口调试、请求测试、传参、Cookie/Header 控制 | 功能全面,擅长各类 HTTP 请求交互 | -C - 续传,配合 -o 或 -O 指定输出文件 | 不支持递归,批量场景需用脚本循环 URL 列表 | 需借助 nohup、& 或 -f 后台运行 | 支持 -x/--proxy 与 --socks5,协议覆盖 HTTP、HTTPS、FTP、SFTP、SMTP 等 |
| wget | 文件下载、断点续传、批量下载、后台下载 | 下载能力强,大文件、批量任务更顺手 | -c 原生续传,不重新下载已完成部分 | -i 读取 URL 列表,-r 递归下载站点 | -b 原生后台下载 | 支持环境变量代理,协议覆盖 HTTP、HTTPS、FTP、SFTP |
帮助与版本
curl --version # 查看版本
curl --help # 查看全部参数
常见问题
1. 中文参数编码问题
直接使用 -d 发送中文参数可能导致乱码,使用 --data-urlencode 自动编码:
curl -X POST --data-urlencode "name=中文" https://api.example.com/post
2. SSL 证书错误(curl: 60)
# 生产环境:指定 CA 证书路径
curl --cacert /path/to/ca-bundle.crt https://example.com
# 测试环境:跳过证书校验
curl -k https://example.com
3. 401 未授权 / 403 禁止访问
检查请求头是否携带正确的认证信息:
# 基本认证(Base64 编码)
curl -u username:password https://api.example.com
# Bearer Token 认证
curl -H "Authorization: Bearer xxxxx" https://api.example.com
4. 请求体大小限制
上传大文件时建议使用 -F 前端表单上传方式,而非 -d 参数传递:
curl -X POST -F "file=@/path/largefile.zip" https://api.example.com/upload
总结
- curl 定位是命令行网络请求工具,接口调试场景优于 wget
- 默认只输出响应体,通过
-i查看响应头,-v查看完整通信过程 - Cookie 和 Header 控制是 curl 的核心优势
-k跳过证书校验仅用于测试,生产环境应指定正确证书路径