命令行与文本处理 / 知识点
curl 参数速查手册
DNS、连接与代理
让匹配主机/IP 不走代理。
--noproxy · 设置代理绕过列表
什么时候查:当你在 curl 命令里看到 --noproxy,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
让匹配主机/IP 不走代理。
参数形式
curl --noproxy <LIST> <URL>关键行为
常用于 localhost、内网域名和服务网段。
示例
curl --noproxy 'localhost,127.0.0.1,.internal.example' https://api.internal.example/易混参数
还要注意 NO_PROXY/no_proxy 环境变量。
风险与边界
域名后缀和 IP 匹配规则应在目标环境验证。
通过 SOCKS5 代理连接,目标域名通常由本地解析。
--socks5 · SOCKS5,本地解析 DNS
什么时候查:当你在 curl 命令里看到 --socks5,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
通过 SOCKS5 代理连接,目标域名通常由本地解析。
参数形式
curl --socks5 <HOST:PORT> <URL>关键行为
适合希望保留本机 DNS 视角的场景。
示例
curl --socks5 127.0.0.1:1080 https://example.com/易混参数
与 --socks5-hostname 最关键区别是 DNS 在哪里解析。
风险与边界
DNS 位置会影响结果、隐私和审计。
通过 SOCKS5,并把目标域名交给代理端解析。
--socks5-hostname · SOCKS5,代理解析 DNS
什么时候查:当你在 curl 命令里看到 --socks5-hostname,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
通过 SOCKS5,并把目标域名交给代理端解析。
参数形式
curl --socks5-hostname <HOST:PORT> <URL>关键行为
本机无需先得到目标最终 IP。
示例
curl --socks5-hostname 127.0.0.1:1080 https://example.com/易混参数
要远端 DNS 视角时选它而不是 --socks5。
风险与边界
代理必须可信。
向代理服务器提供认证凭据。
-U / --proxy-user · 代理用户名和密码
什么时候查:当你在 curl 命令里看到 -U,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
向代理服务器提供认证凭据。
参数形式
curl -U <USER:PASSWORD> <URL>关键行为
只用于代理,不等于目标站点 -u。
示例
curl -x http://proxy.example:8080 -U alice:secret https://example.com/易混参数
-u 是目标服务认证;-U 是代理认证。
风险与边界
密码写在命令行有泄露风险。
不走 TCP,通过本地 Unix Domain Socket 访问 HTTP 服务。
--unix-socket · 通过 Unix Socket 连接
什么时候查:当你在 curl 命令里看到 --unix-socket,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
不走 TCP,通过本地 Unix Domain Socket 访问 HTTP 服务。
参数形式
curl --unix-socket <PATH> <URL>关键行为
URL 中仍需要协议和逻辑主机。
示例
curl --unix-socket /var/run/docker.sock http://localhost/_ping易混参数
常见于 Docker API、本地代理、sidecar。
风险与边界
Docker Socket 等高权限 socket 可能近似宿主机 root 控制能力。
让 curl 通过指定 DoH 服务解析目标主机。
--doh-url · 使用 DNS over HTTPS
什么时候查:当你在 curl 命令里看到 --doh-url,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
让 curl 通过指定 DoH 服务解析目标主机。
参数形式
curl --doh-url <URL> <URL>关键行为
改变 curl 的 DNS 解析路径,不改变 HTTP 目标本身。
示例
curl --doh-url https://dns.example/dns-query https://example.com/易混参数
可用于绕过普通系统 DNS 路径进行对比。
风险与边界
DoH 服务的证书和可达性也必须正常,企业环境注意合规。
版本边界
7.62.0+
TLS 与证书
允许在无法验证服务端身份时继续 TLS。
-k / --insecure · 跳过 TLS 证书验证
什么时候查:当你在 curl 命令里看到 -k,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
允许在无法验证服务端身份时继续 TLS。
参数形式
curl -k <URL>关键行为
会跳过关键证书链/主机身份验证。
示例
curl -k https://test.example/易混参数
证书不受信的正确方案通常是 --cacert,不是长期 -k。
风险与边界
官方明确建议生产环境不要跳过验证,会暴露中间人攻击风险。
使用指定 CA 文件验证服务器。
--cacert · 指定 CA 文件
什么时候查:当你在 curl 命令里看到 --cacert,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
使用指定 CA 文件验证服务器。
参数形式
curl --cacert <FILE> <URL>关键行为
适合企业私有 CA、自签根 CA 或独立 CA bundle。
示例
curl --cacert company-ca.pem https://internal.example/易混参数
与 -k 相比,这是处理私有 CA 的正确方向。
风险与边界
CA 文件本身必须可信。
使用包含 CA 证书的目录作为信任来源。
--capath · 指定 CA 目录
什么时候查:当你在 curl 命令里看到 --capath,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
使用包含 CA 证书的目录作为信任来源。
参数形式
curl --capath <DIR> <URL>关键行为
目录格式/hash 要求依赖 TLS 后端。
示例
curl --capath /etc/ssl/certs https://example.com/易混参数
--cacert 是文件/Bundle;--capath 是目录。
风险与边界
跨平台脚本注意 TLS 后端差异。
请求使用操作系统原生 CA trust store。
--ca-native · 使用系统原生 CA 存储
什么时候查:当你在 curl 命令里看到 --ca-native,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
请求使用操作系统原生 CA trust store。
参数形式
curl --ca-native <URL>关键行为
支持情况取决于系统和 TLS 后端组合。
示例
curl --ca-native https://example.com/易混参数
部分平台可与自定义 CA 组合。
风险与边界
不能假设所有 curl 构建行为一致。
在 mTLS 中提供客户端证书。
--cert · 客户端证书
什么时候查:当你在 curl 命令里看到 --cert,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
在 mTLS 中提供客户端证书。
参数形式
curl --cert <CERT[:PASSWORD]> <URL>关键行为
证书格式和 TLS 后端、--cert-type 相关。
示例
curl --cert client.crt --key client.key https://mtls.example.com/api易混参数
--cert 是客户端身份;--cacert 是验证服务端所信任 CA。
风险与边界
证书容器可能包含私钥,按敏感凭据保护。
证书和私钥分离时指定私钥。
--key · 客户端私钥
什么时候查:当你在 curl 命令里看到 --key,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
证书和私钥分离时指定私钥。
参数形式
curl --key <KEY> <URL>关键行为
通常与 --cert 配合。
示例
curl --cert client.crt --key client.key https://mtls.example.com/易混参数
某些 P12 场景私钥已在证书容器中。
风险与边界
私钥禁止进入日志、仓库和不安全共享。
指定 PEM、DER、P12 等证书格式。
--cert-type · 客户端证书类型
什么时候查:当你在 curl 命令里看到 --cert-type,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
指定 PEM、DER、P12 等证书格式。
参数形式
curl --cert-type <TYPE> <URL>关键行为
用于明确告诉 curl 如何读取 --cert。
示例
curl --cert-type P12 --cert 'client.p12:<PASSWORD>' https://mtls.example.com/易混参数
与 --cert 配套。
风险与边界
P12 密码写命令行同样有泄露风险。
要求 TLS 协商至少从 1.2 起。
--tlsv1.2 · 最低 TLS 1.2
什么时候查:当你在 curl 命令里看到 --tlsv1.2,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
要求 TLS 协商至少从 1.2 起。
参数形式
curl --tlsv1.2 <URL>关键行为
适合安全基线和协议兼容测试。
示例
curl --tlsv1.2 https://example.com/易混参数
最高版本用 --tls-max 控制。
风险与边界
最终能力仍取决于 TLS 后端。
控制 TLS 协商不得高于指定版本。
--tls-max · 限制最高 TLS 版本
什么时候查:当你在 curl 命令里看到 --tls-max,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
控制 TLS 协商不得高于指定版本。
参数形式
curl --tls-max <VERSION> <URL>关键行为
常用于复现旧客户端或定位 TLS 1.3 专属问题。
示例
curl --tls-max 1.2 https://example.com/易混参数
可与最低版本参数组合成明确范围。
风险与边界
不应长期降低版本去掩盖兼容问题。
额外要求远端证书公钥匹配指定公钥/哈希。
--pinnedpubkey · 固定远端公钥
什么时候查:当你在 curl 命令里看到 --pinnedpubkey,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
额外要求远端证书公钥匹配指定公钥/哈希。
参数形式
curl --pinnedpubkey <HASHES|FILE> <URL>关键行为
可作为普通证书校验之外更严格的 pinning 条件。
示例
curl --pinnedpubkey 'sha256//<BASE64_HASH>' https://example.com/易混参数
它不是 CA 信任体系的简单替代。
风险与边界
公钥轮换若未同步 pin,会导致客户端全部失败。
调试、性能与自动化
输出连接、代理、TLS、请求头和响应头等调试信息。
-v / --verbose · 详细请求过程
什么时候查:当你在 curl 命令里看到 -v,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
输出连接、代理、TLS、请求头和响应头等调试信息。
参数形式
curl -v <URL>关键行为
HTTP 中通常 > 是发送头,< 是接收头。
示例
curl -v https://example.com/api易混参数
需要更完整数据看 --trace / --trace-ascii。
风险与边界
verbose 可能显示 Authorization、Cookie 等敏感内容,分享前必须脱敏。
记录更底层的发送/接收与连接调试数据。
--trace · 完整 Trace
什么时候查:当你在 curl 命令里看到 --trace,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
记录更底层的发送/接收与连接调试数据。
参数形式
curl --trace <FILE|-> <URL>关键行为
比 -v 更完整。
示例
curl --trace trace.log https://example.com/api易混参数
--trace-ascii 更适合人工阅读。
风险与边界
Trace 极可能包含凭据和业务正文,按敏感日志管理。
以更易读的形式保存传输 trace。
--trace-ascii · ASCII Trace
什么时候查:当你在 curl 命令里看到 --trace-ascii,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
以更易读的形式保存传输 trace。
参数形式
curl --trace-ascii <FILE|-> <URL>关键行为
适合排查 Header、请求内容和协议交互。
示例
curl --trace-ascii trace.txt https://example.com/api易混参数
与 --trace 相比更偏人工阅读。
风险与边界
同样可能泄露认证和业务数据。
给 trace/verbose 相关事件增加时间信息。
--trace-time · Trace 加时间
什么时候查:当你在 curl 命令里看到 --trace-time,或者需要确认它的默认行为、易混参数和安全边界时查这一条。
作用
给 trace/verbose 相关事件增加时间信息。
参数形式
curl --trace-time <URL>关键行为
帮助判断延迟发生在哪个阶段。
示例
curl --trace-time --trace-ascii trace.txt https://example.com/api易混参数
通常与 trace 参数一起用。
风险与边界
这是客户端观测时序,不等于服务端内部耗时。