命令行与文本处理 / 知识点
curl 命令速查手册
调试与性能分析
curl -v <URL>显示 DNS/连接、TLS、请求头和响应头等详细交互信息。
查看详细请求过程
显示 DNS/连接、TLS、请求头和响应头等详细交互信息。
基本语法
curl -v <URL>高频用法
curl -v https://example.com/api预期结果:
stderr 中出现以 `>` 开头的请求头、`<` 开头的响应头及连接信息。读取方法
这是 curl 第一排障工具,适合确认 SNI、代理、Header 和协议。
风险与边界
verbose 输出可能包含 Authorization、Cookie 等敏感 Header;分享前必须脱敏。
curl --trace-ascii <FILE> <URL>把更完整的传输调试信息保存为 ASCII trace。
输出 ASCII Trace
把更完整的传输调试信息保存为 ASCII trace。
基本语法
curl --trace-ascii <FILE> <URL>高频用法
curl --trace-ascii trace.txt https://example.com/api预期结果:
生成包含发送/接收数据和连接事件的 trace 文件。读取方法
比 -v 更适合深入协议问题和留存现场。
风险与边界
Trace 很可能包含完整凭据和业务数据,文件应按敏感日志管理。
curl --trace-time --trace-ascii <FILE> <URL>给 trace 事件增加时间信息,分析卡顿发生在哪个阶段。
为 Trace 增加时间
给 trace 事件增加时间信息,分析卡顿发生在哪个阶段。
基本语法
curl --trace-time --trace-ascii <FILE> <URL>高频用法
curl --trace-time --trace-ascii trace.txt https://example.com/api预期结果:
trace 每条事件包含时间前缀。读取方法
适合偶发延迟、代理握手、TLS 卡顿。
风险与边界
仍需按敏感数据处理 trace 文件。
curl -w <FORMAT> <URL>拆分 DNS、TCP、TLS、首字节和总耗时。
输出请求阶段耗时
拆分 DNS、TCP、TLS、首字节和总耗时。
基本语法
curl -w <FORMAT> <URL>高频用法
curl -sS -o /dev/null -w 'dns=%{time_namelookup}s tcp=%{time_connect}s tls=%{time_appconnect}s start=%{time_starttransfer}s total=%{time_total}s
' https://example.com/预期结果:
输出各阶段秒数。读取方法
time_starttransfer 明显高于前序阶段时,通常更偏向服务端处理或上游等待。
风险与边界
这些指标是客户端观测值,需要结合服务端日志和链路监控判断根因。
curl -w '%{http_version}' ...确认本次请求最终实际使用的 HTTP 协议版本。
输出协议版本
确认本次请求最终实际使用的 HTTP 协议版本。
基本语法
curl -w '%{http_version}' ...高频用法
curl -sS -o /dev/null -w 'http=%{http_version}
' https://example.com/预期结果:
输出类似 `1.1`、`2`、`3`。读取方法
比只看命令参数更可靠,因为它反映最终协商结果。
风险与边界
字段支持取决于 curl 版本;部署到旧环境前验证。
curl -w <FORMAT> <URL>记录本地源 IP、实际远端 IP 与 HTTP 状态。
输出 DNS 与连接目标
记录本地源 IP、实际远端 IP 与 HTTP 状态。
基本语法
curl -w <FORMAT> <URL>高频用法
curl -sS -o /dev/null -w 'local=%{local_ip} remote=%{remote_ip} code=%{http_code}
' https://example.com/预期结果:
输出 local、remote 和 code。读取方法
多网卡、CDN、DNS 轮询、IPv4/IPv6 排障时非常实用。
风险与边界
代理/VPN 场景要结合实际网络拓扑解释 remote_ip。
批量与自动化
curl -K <FILE>把 URL、Header、认证等参数放入配置文件,减少超长命令。
从配置文件读取参数
把 URL、Header、认证等参数放入配置文件,减少超长命令。
基本语法
curl -K <FILE>高频用法
curl -K request.conf预期结果:
curl 按配置文件执行请求。读取方法
适合可复现调试、复杂自动化和避免大量 Shell 转义。
风险与边界
配置文件可能包含凭据,应限制权限并避免提交到公开仓库。
curl 默认读取配置了解 ~/.curlrc 等默认配置对每次 curl 调用的影响。
使用用户级 curlrc
了解 ~/.curlrc 等默认配置对每次 curl 调用的影响。
基本语法
curl 默认读取配置高频用法
curl https://example.com/预期结果:
实际请求可能自动继承用户配置中的 proxy、header 等选项。读取方法
遇到“同一命令在两台机器行为不同”时应检查 curlrc。
风险与边界
不要在全局 curlrc 放 --insecure、激进重试或敏感 Header;隐式配置会污染所有请求。
curl -q <URL>忽略默认 curlrc,获得更接近命令行显式参数的行为。
临时禁用默认 curlrc
忽略默认 curlrc,获得更接近命令行显式参数的行为。
基本语法
curl -q <URL>高频用法
curl -q -sS https://example.com/预期结果:
请求不再继承用户默认配置。读取方法
排查代理、Header、证书行为差异时非常有效。
风险与边界
-q 需要放在合适位置使用;脚本中若依赖纯净环境可显式采用。
curl <URL1> <URL2> ...在同一 curl 进程中依次执行多个传输。
一次请求多个 URL
在同一 curl 进程中依次执行多个传输。
基本语法
curl <URL1> <URL2> ...高频用法
curl -sS https://example.com/a https://example.com/b预期结果:
按顺序输出各 URL 的响应。读取方法
适合少量同类资源。
风险与边界
默认早期错误可能被后续成功掩盖;自动化应考虑 --fail-early。
curl --parallel <URL1> <URL2> ...并行执行多个传输并限制并发数量。
并行请求多个 URL
并行执行多个传输并限制并发数量。
基本语法
curl --parallel <URL1> <URL2> ...高频用法
curl --parallel --parallel-max 4 -O https://example.com/a.bin -O https://example.com/b.bin预期结果:
多个下载同时进行,最多保持指定并发。读取方法
适合批量下载和并行探测。
风险与边界
并发会放大带宽、连接和服务端压力;生产环境应设置合理上限。
curl <OPTIONS1> <URL1> --next <OPTIONS2> <URL2>在同一 curl 命令里为不同 URL 使用不同的局部选项。
用 --next 分隔不同请求配置
在同一 curl 命令里为不同 URL 使用不同的局部选项。
基本语法
curl <OPTIONS1> <URL1> --next <OPTIONS2> <URL2>高频用法
curl -H 'Accept: application/json' https://example.com/api/a --next -I https://example.com/file预期结果:
第一个请求使用 JSON Accept,第二个请求发送 HEAD。读取方法
--next 会重置大量局部选项,适合构造多请求场景。
风险与边界
全局选项与局部选项的作用域不同;复杂自动化更推荐脚本显式分开调用。
curl 'https://example.com/file[1-3].txt'利用 curl URL globbing 展开数字、字母范围或集合。
使用 URL globbing 批量生成请求
利用 curl URL globbing 展开数字、字母范围或集合。
基本语法
curl 'https://example.com/file[1-3].txt'高频用法
curl -fLO 'https://example.com/file[1-3].txt'预期结果:
依次请求 file1.txt、file2.txt、file3.txt。读取方法
适合规则化批量下载。
风险与边界
URL 必须用引号防止 Shell 自己先展开;外部输入不应直接拼进 glob 表达式。
curl -g <URL>当 URL 中的 []、{} 是字面量而不是 curl glob 语法时禁用 globbing。
禁用 URL globbing
当 URL 中的 []、{} 是字面量而不是 curl glob 语法时禁用 globbing。
基本语法
curl -g <URL>高频用法
curl -g 'https://example.com/api?filter=[abc]'预期结果:
curl 按字面 URL 处理括号内容。读取方法
GraphQL、搜索过滤器或特殊查询参数可能需要。
风险与边界
仍需保证 URL 的合法编码;-g 不等同于自动 URL encode。
curl ...; echo $?通过进程退出码判断 DNS、连接、TLS、HTTP fail 等是否成功。
脚本中获取 curl 退出码
通过进程退出码判断 DNS、连接、TLS、HTTP fail 等是否成功。
基本语法
curl ...; echo $?高频用法
curl -fsS https://example.com/health >/dev/null; printf 'exit=%s
' "$?"预期结果:
成功通常输出 `exit=0`,失败为非零。读取方法
脚本应优先判断退出码而不是解析错误文案。
风险与边界
默认 HTTP 404/500 不一定让 curl 非零;需要配合 --fail/--fail-with-body。