内容总览

curl 命令思维导图

起源

curl 是一款命令行网络请求工具,底层基于 libcurl 库,支持 HTTP/HTTPS/FTP/SFTP/SMTP 等多种协议。curl 的设计目标不是文件下载,而是精确控制网络请求的每一个细节,因此被广泛用于接口调试、请求模拟、协议测试等场景。Linux/macOS 默认预装,无需额外安装。

原理

  1. curl 作为客户端,向目标服务器发起网络请求,接收并显示响应
  2. 默认输出原始响应体到终端,不显示响应头
  3. 支持完整的 HTTP 请求控制:方法、请求头、Cookie、参数编码、超时控制
  4. 多协议支持: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 命令。

常用组合示例

  1. POST JSON + 忽略证书 + 自定义请求头
curl -k -X POST -H "Content-Type: application/json" -d '{"data":"hello"}' https://127.0.0.1/api
  1. 跟随跳转 + 查看响应头
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

总结

  1. curl 定位是命令行网络请求工具,接口调试场景优于 wget
  2. 默认只输出响应体,通过 -i 查看响应头,-v 查看完整通信过程
  3. Cookie 和 Header 控制是 curl 的核心优势
  4. -k 跳过证书校验仅用于测试,生产环境应指定正确证书路径