命令行与文本处理 / 知识点
curl 命令速查手册
超时、重试与错误处理
curl --fail-early <URL1> <URL2>一次命令执行多个传输时,不让前面的失败被后续成功掩盖。
多 URL 遇首个错误即失败
一次命令执行多个传输时,不让前面的失败被后续成功掩盖。
基本语法
curl --fail-early <URL1> <URL2>高频用法
curl --fail-early --fail https://example.com/a https://example.com/b预期结果:
任一传输失败时整体以失败结束。读取方法
--fail-early 负责多传输错误传播,--fail 负责 HTTP 错误码语义。
风险与边界
批量下载/CI 中很有价值;理解它是全局传输控制而不是 HTTP 状态开关。
重定向与协议控制
curl -L <URL>自动跟随 3xx Location 到最终资源。
跟随 HTTP 重定向
自动跟随 3xx Location 到最终资源。
基本语法
curl -L <URL>高频用法
curl -sS -L https://example.com/old预期结果:
依次访问重定向目标并输出最终响应。读取方法
软件下载、登录跳转、HTTP→HTTPS 常需要。
使用说明
携带敏感 Header 时要关注是否跨主机跳转,避免凭据扩散。
curl -L --max-redirs <N> <URL>限制重定向链长度,防止循环或异常跳转。
限制最大重定向次数
限制重定向链长度,防止循环或异常跳转。
基本语法
curl -L --max-redirs <N> <URL>高频用法
curl -sS -L --max-redirs 5 https://example.com/预期结果:
超过指定次数时 curl 失败。读取方法
适合自动化检查。
使用说明
过低可能误伤合法登录/CDN 跳转,按业务设置。
curl --proto <LIST> <URL>限制 curl 可使用的 URL 协议,降低意外协议跳转风险。
仅允许指定协议
限制 curl 可使用的 URL 协议,降低意外协议跳转风险。
基本语法
curl --proto <LIST> <URL>高频用法
curl --proto '=https' -sS https://example.com/预期结果:
只允许 HTTPS;其他协议被拒绝。读取方法
=https 表示重置为仅允许 HTTPS。
风险与边界
处理外部输入 URL、自动跟随重定向或下载器时非常重要。
curl --proto-redir <LIST> -L <URL>只允许重定向继续使用指定协议。
限制重定向目标协议
只允许重定向继续使用指定协议。
基本语法
curl --proto-redir <LIST> -L <URL>高频用法
curl -sS -L --proto-redir '=https' https://example.com/预期结果:
若 Location 跳到不允许协议则失败。读取方法
适合阻止 HTTPS 请求被重定向到 file、ftp 等非预期协议。
风险与边界
与 --proto 共同使用时更容易建立明确协议边界。
curl -4 <URL>只解析并连接 IPv4 地址。
强制使用 IPv4
只解析并连接 IPv4 地址。
基本语法
curl -4 <URL>高频用法
curl -4 -sS https://example.com/预期结果:
请求使用 A 记录对应 IPv4。读取方法
用于判断双栈环境是否只有 IPv6 路径异常。
风险与边界
不要把 -4 当永久修复;确认 IPv6 根因后再决定网络策略。
curl -6 <URL>只解析并连接 IPv6 地址。
强制使用 IPv6
只解析并连接 IPv6 地址。
基本语法
curl -6 <URL>高频用法
curl -6 -sS https://example.com/预期结果:
请求使用 AAAA 记录对应 IPv6。读取方法
用于单独验证 IPv6 DNS、路由、TLS 和服务监听。
风险与边界
目标没有 AAAA 或本机 IPv6 不可用时会失败。
DNS、连接与代理
curl --resolve <HOST:PORT:IP> <URL>像命令行版 /etc/hosts 一样,为指定 host+port 临时指定连接地址。
临时指定域名解析 IP
像命令行版 /etc/hosts 一样,为指定 host+port 临时指定连接地址。
基本语法
curl --resolve <HOST:PORT:IP> <URL>高频用法
curl -sS --resolve example.com:443:192.0.2.20 https://example.com/预期结果:
TCP 连接到指定 IP,但 Host 与 TLS SNI 仍保持原域名。读取方法
测试新节点、源站、CDN、DNS 故障时非常实用。
风险与边界
端口必须与 URL 实际连接端口匹配;IPv6 地址按 curl 要求使用括号形式。
curl --connect-to <HOST1:PORT1:HOST2:PORT2> <URL>把一个逻辑主机/端口的连接重定向到另一主机/端口。
改写实际连接目标
把一个逻辑主机/端口的连接重定向到另一主机/端口。
基本语法
curl --connect-to <HOST1:PORT1:HOST2:PORT2> <URL>高频用法
curl -sS --connect-to example.com:443:origin.internal:8443 https://example.com/预期结果:
URL、Host 等逻辑请求仍针对 example.com,但底层连接到 origin.internal:8443。读取方法
比 --resolve 更适合端口也需要改写的场景。
风险与边界
这是高级排障工具;TLS 证书与 SNI 行为需结合目标架构验证。
curl -x <PROXY> <URL>通过 HTTP/HTTPS 代理访问目标。
通过 HTTP 代理请求
通过 HTTP/HTTPS 代理访问目标。
基本语法
curl -x <PROXY> <URL>高频用法
curl -sS -x http://127.0.0.1:8080 https://example.com/预期结果:
请求先连接代理,再由代理访问目标。读取方法
-x/--proxy 适合企业代理、抓包代理和网关验证。
使用说明
代理可以看到目标和部分流量元数据;不要把敏感请求交给不可信代理。
curl --noproxy <LIST> <URL>让匹配的主机绕过已配置代理。
跳过指定主机代理
让匹配的主机绕过已配置代理。
基本语法
curl --noproxy <LIST> <URL>高频用法
curl -sS --noproxy 'localhost,127.0.0.1,.internal.example' https://api.internal.example/预期结果:
匹配列表中的目标直接连接。读取方法
适合结合 HTTPS_PROXY/ALL_PROXY 环境变量排障。
风险与边界
域名匹配规则需要按 curl 行为验证,尤其是子域与通配范围。
curl --socks5-hostname <PROXY> <URL>通过 SOCKS5 代理连接,并把目标域名交给代理端解析。
使用 SOCKS5 代理并让代理解析 DNS
通过 SOCKS5 代理连接,并把目标域名交给代理端解析。
基本语法
curl --socks5-hostname <PROXY> <URL>高频用法
curl -sS --socks5-hostname 127.0.0.1:1080 https://example.com/预期结果:
本机无需先解析目标域名,代理负责 DNS。读取方法
适合远端 DNS 视角、隧道和隔离网络。
风险与边界
代理服务必须可信;DNS 解析位置变化会影响结果与审计。
curl -x <PROXY> -U <USER:PASSWORD> <URL>向需要认证的代理提供用户名和密码。
代理认证
向需要认证的代理提供用户名和密码。
基本语法
curl -x <PROXY> -U <USER:PASSWORD> <URL>高频用法
curl -sS -x http://proxy.example:8080 -U 'alice:secret' https://example.com/预期结果:
代理认证成功后继续访问目标。读取方法
-U/--proxy-user 只用于代理认证,不是目标站点认证。
风险与边界
密码直接出现在命令行有泄露风险,优先使用安全凭据注入方式。
curl --unix-socket <PATH> <URL>通过本地 Unix Domain Socket 访问 HTTP 服务。
通过 Unix Socket 请求
通过本地 Unix Domain Socket 访问 HTTP 服务。
基本语法
curl --unix-socket <PATH> <URL>高频用法
curl --unix-socket /var/run/docker.sock http://localhost/_ping预期结果:
不经过 TCP,直接与指定 socket 通信。读取方法
适合 Docker API、本地 sidecar、反向代理等。
风险与边界
Unix Socket 可能具有高权限;例如 Docker Socket 通常近似宿主机 root 控制能力。
TLS 与证书
curl --cacert <FILE> <URL>使用指定 CA 文件验证服务端 TLS 证书。
指定 CA 证书验证
使用指定 CA 文件验证服务端 TLS 证书。
基本语法
curl --cacert <FILE> <URL>高频用法
curl -sS --cacert company-ca.pem https://internal.example/预期结果:
证书链和主机名验证成功后正常返回响应。读取方法
企业内部 CA、自签根 CA 场景优先使用该方式。
风险与边界
不要为了省事长期改成 -k;正确做法是提供可信 CA。
curl -k <URL>跳过 TLS 证书链和主机名验证,用于隔离证书问题。
临时跳过 TLS 证书验证
跳过 TLS 证书链和主机名验证,用于隔离证书问题。
基本语法
curl -k <URL>高频用法
curl -k -sS https://test.example/预期结果:
即使证书不受信或主机名不匹配也尝试建立 HTTPS。读取方法
只适合临时确认“网络/HTTP 是否正常,失败是否仅由证书导致”。
风险与边界
会削弱 HTTPS 身份验证并暴露中间人攻击风险,生产脚本和长期配置禁止默认使用。
curl --tlsv1.2 <URL>要求 TLS 连接至少使用指定版本能力。
限制最低 TLS 版本
要求 TLS 连接至少使用指定版本能力。
基本语法
curl --tlsv1.2 <URL>高频用法
curl -sS --tlsv1.2 https://example.com/预期结果:
服务端支持兼容 TLS 时握手成功。读取方法
适合安全基线和协议兼容排障。
风险与边界
选项具体语义还受 curl/TLS 后端影响;精确上限应配合 --tls-max。
curl --tls-max <VERSION> <URL>限制 TLS 协商不得高于指定版本。
限制最高 TLS 版本
限制 TLS 协商不得高于指定版本。
基本语法
curl --tls-max <VERSION> <URL>高频用法
curl -sS --tls-max 1.2 https://example.com/预期结果:
例如该命令最多协商 TLS 1.2。读取方法
适合复现旧客户端或排查 TLS 1.3 专属问题。
风险与边界
不应长期降低协议版本来掩盖服务端兼容缺陷。
curl --cert <CERT> --key <KEY> <URL>使用客户端证书和私钥完成双向 TLS 认证。
使用客户端证书 mTLS
使用客户端证书和私钥完成双向 TLS 认证。
基本语法
curl --cert <CERT> --key <KEY> <URL>高频用法
curl -sS --cert client.crt --key client.key https://mtls.example.com/api预期结果:
服务端接受客户端证书后返回受保护资源。读取方法
证书与私钥可按实际格式使用 PEM/P12 等对应参数。
风险与边界
私钥是高敏感凭据;严格限制权限,不要复制到命令日志或仓库。
curl --cert-type P12 --cert <FILE:PASSWORD> <URL>从 PKCS#12/PFX 文件加载客户端证书与私钥。
使用 P12/PFX 客户端证书
从 PKCS#12/PFX 文件加载客户端证书与私钥。
基本语法
curl --cert-type P12 --cert <FILE:PASSWORD> <URL>高频用法
curl -sS --cert-type P12 --cert 'client.p12:<PASSWORD>' https://mtls.example.com/api预期结果:
mTLS 认证成功后返回目标资源。读取方法
适合证书和私钥打包在同一 P12 文件的环境。
风险与边界
把 P12 密码写在命令行同样有泄露风险,应使用安全输入方式。