命令行与文本处理 / 知识点
curl 命令速查手册
请求头与内容协商
curl -H <H1> -H <H2> <URL>一次请求设置多个自定义 Header。
添加多个请求头
一次请求设置多个自定义 Header。
基本语法
curl -H <H1> -H <H2> <URL>高频用法
curl -sS -H 'Accept: application/json' -H 'X-Env: test' https://example.com/api预期结果:
请求同时带上 Accept 和 X-Env。读取方法
每个 Header 使用一个独立 -H,可读性最好。
使用说明
同名 Header 的处理取决于协议与服务端;需要覆盖默认值时应明确测试。
curl -H 'Content-Type: <TYPE>' ...显式声明请求体媒体类型。
设置 Content-Type
显式声明请求体媒体类型。
基本语法
curl -H 'Content-Type: <TYPE>' ...高频用法
curl -sS -H 'Content-Type: application/xml' --data-binary @request.xml https://example.com/api预期结果:
服务端按指定 Content-Type 解析 body。读取方法
JSON 使用 --json 时通常无需额外手写 Content-Type。
使用说明
Header 声明必须和实际 body 格式一致,否则可能得到 400/415。
curl -H 'Accept: <TYPE>' <URL>声明客户端期望的响应媒体类型。
设置 Accept
声明客户端期望的响应媒体类型。
基本语法
curl -H 'Accept: <TYPE>' <URL>高频用法
curl -sS -H 'Accept: application/json' https://example.com/api/items预期结果:
支持内容协商的服务返回 JSON 或对应格式。读取方法
Accept 控制期望的响应类型,不等同于请求体 Content-Type。
使用说明
服务端不支持时可能忽略或返回 406。
curl -A <UA> <URL>覆盖 curl 默认 User-Agent,便于服务端识别调用来源。
设置 User-Agent
覆盖 curl 默认 User-Agent,便于服务端识别调用来源。
基本语法
curl -A <UA> <URL>高频用法
curl -sS -A 'Anystack-Monitor/1.0' https://example.com/health预期结果:
服务端日志中可看到指定 User-Agent。读取方法
-A 是 --user-agent 的短写。
使用说明
不要伪装浏览器来绕过访问控制或服务条款。
curl -e <URL> <URL>设置 HTTP Referer 请求头。
设置 Referer
设置 HTTP Referer 请求头。
基本语法
curl -e <URL> <URL>高频用法
curl -sS -e 'https://example.com/' https://example.com/page预期结果:
服务端收到指定 Referer。读取方法
常用于复现浏览器请求或调试来源校验。
使用说明
Referer 不是可信身份凭据,服务端也不应把它当认证机制。
curl --compressed <URL>让 curl 声明支持其可解码的压缩格式,并自动解压响应。
请求压缩响应
让 curl 声明支持其可解码的压缩格式,并自动解压响应。
基本语法
curl --compressed <URL>高频用法
curl -sS --compressed https://example.com/api/data预期结果:
终端得到解压后的响应内容。读取方法
适合模拟真实 HTTP 压缩传输并节省带宽。
使用说明
调试原始压缩字节时不要使用自动解压。
curl -H '<HEADER>:' <URL>通过空值写法移除 curl 原本会发送的某个 Header。
移除默认请求头
通过空值写法移除 curl 原本会发送的某个 Header。
基本语法
curl -H '<HEADER>:' <URL>高频用法
curl -sS -H 'Accept:' https://example.com/api预期结果:
实际请求中不再发送该 Header。读取方法
适合验证服务端对缺失 Header 的行为。
风险与边界
不要把 Header: 与发送空 Header 的特殊语义混淆;使用前通过 -v 验证。
认证与凭据
curl -u <USER:PASSWORD> <URL>使用用户名密码进行 HTTP Basic 或协商认证。
使用 Basic Auth
使用用户名密码进行 HTTP Basic 或协商认证。
基本语法
curl -u <USER:PASSWORD> <URL>高频用法
curl -sS -u 'alice:secret' https://example.com/api/private预期结果:
认证成功时返回受保护资源;失败常见 401。读取方法
-u 会构造 Authorization 认证信息。
风险与边界
命令行密码可能出现在 Shell 历史或进程信息中;生产脚本应使用更安全的凭据注入方式。
curl -u <USER> <URL>只在命令行给用户名,让 curl 提示输入密码。
仅提供用户名并交互输入密码
只在命令行给用户名,让 curl 提示输入密码。
基本语法
curl -u <USER> <URL>高频用法
curl -u alice https://example.com/api/private预期结果:
终端交互询问密码,输入时通常不回显。读取方法
比把 user:password 直接写在命令行更适合人工操作。
风险与边界
仍应确认终端环境可信,避免在自动化流程中卡住等待输入。
curl -H 'Authorization: Bearer <TOKEN>' <URL>使用 OAuth2/JWT 等 Bearer Token 调用 API。
使用 Bearer Token
使用 OAuth2/JWT 等 Bearer Token 调用 API。
基本语法
curl -H 'Authorization: Bearer <TOKEN>' <URL>高频用法
curl -sS -H 'Authorization: Bearer <TOKEN>' https://example.com/api/me预期结果:
Token 有效时返回受保护资源。读取方法
Authorization Header 是 API 调试最常见的认证形式之一。
风险与边界
不要把真实 Token 复制进聊天、日志、命令示例或 Git 仓库;泄露后应立即轮换。
curl --netrc <URL>从 ~/.netrc 读取目标主机的登录凭据,避免把密码写进命令行。
使用 netrc 凭据
从 ~/.netrc 读取目标主机的登录凭据,避免把密码写进命令行。
基本语法
curl --netrc <URL>高频用法
curl -sS --netrc https://example.com/api/private预期结果:
curl 匹配 machine 条目后使用其中 login/password。读取方法
适合受控机器上的自动化。
风险与边界
~/.netrc 必须严格限制权限,并避免在多用户机器上泄露。
curl --netrc-file <FILE> <URL>从指定 netrc 文件读取凭据。
指定 netrc 文件
从指定 netrc 文件读取凭据。
基本语法
curl --netrc-file <FILE> <URL>高频用法
curl -sS --netrc-file /run/secrets/curl.netrc https://example.com/api/private预期结果:
使用指定文件中的 machine/login/password。读取方法
适合容器 secret、CI 临时凭据文件。
风险与边界
确保文件只对运行账号可读,并在任务结束后按策略清理。
Cookie 与会话
curl -b '<COOKIE>' <URL>直接随请求发送 Cookie。
发送 Cookie
直接随请求发送 Cookie。
基本语法
curl -b '<COOKIE>' <URL>高频用法
curl -sS -b 'session=abc123; theme=dark' https://example.com/account预期结果:
服务端收到 Cookie Header 并按会话处理。读取方法
-b/--cookie 可接受 Cookie 字符串或 Cookie 文件。
风险与边界
Session Cookie 等同于凭据,应避免进入日志和历史。
curl -b <FILE> <URL>从 Cookie 文件加载可匹配当前域名和路径的 Cookie。
读取 Cookie 文件
从 Cookie 文件加载可匹配当前域名和路径的 Cookie。
基本语法
curl -b <FILE> <URL>高频用法
curl -sS -b cookies.txt https://example.com/account预期结果:
请求自动携带文件中满足条件的 Cookie。读取方法
适合复现已有会话。
风险与边界
Cookie jar 可能包含登录态,应限制文件权限。
curl -c <FILE> <URL>把服务端设置的 Cookie 写入 Cookie jar 文件。
保存响应 Cookie
把服务端设置的 Cookie 写入 Cookie jar 文件。
基本语法
curl -c <FILE> <URL>高频用法
curl -sS -c cookies.txt https://example.com/login预期结果:
请求完成后生成/更新 Cookie 文件。读取方法
可与后续 -b cookies.txt 组合形成多请求会话。
风险与边界
不要把 Cookie jar 提交到版本控制。
curl -b <FILE> -c <FILE> <URL>读取旧 Cookie 并把响应的新 Cookie 写回同一 jar。
维护连续 Cookie 会话
读取旧 Cookie 并把响应的新 Cookie 写回同一 jar。
基本语法
curl -b <FILE> -c <FILE> <URL>高频用法
curl -sS -b cookies.txt -c cookies.txt https://example.com/account预期结果:
会话状态在多次 curl 调用之间持续更新。读取方法
适合登录后继续访问多个页面/API。
风险与边界
并发进程共享同一个 Cookie 文件可能相互覆盖;并发任务应分离状态。
上传、下载与文件
curl -o <FILE> <URL>把响应体保存到明确的本地文件名。
下载并指定文件名
把响应体保存到明确的本地文件名。
基本语法
curl -o <FILE> <URL>高频用法
curl -fL -o app.tar.gz https://example.com/releases/app.tar.gz预期结果:
成功后生成 `app.tar.gz`。读取方法
-o 不会采用 URL 末尾名称,适合脚本固定路径。
风险与边界
下载软件或制品后还应验证 checksum/签名,不要只看 HTTP 200。
curl -O <URL>使用 URL 中的远端文件名保存响应。
按远端名称下载
使用 URL 中的远端文件名保存响应。
基本语法
curl -O <URL>高频用法
curl -fLO https://example.com/releases/app.tar.gz预期结果:
当前目录生成 `app.tar.gz`。读取方法
-O 适合 URL 路径本身就有可信文件名的场景。
使用说明
不要对不可信 URL 盲目 -O 到敏感目录;先确认文件名和目标位置。
curl -L -o <FILE> <URL>跟随 3xx 重定向并把最终响应保存到文件。
跟随重定向下载文件
跟随 3xx 重定向并把最终响应保存到文件。
基本语法
curl -L -o <FILE> <URL>高频用法
curl -fL -o app.tar.gz https://example.com/download/latest预期结果:
最终文件保存到指定路径。读取方法
软件发布页、对象存储签名链接、CDN 常需要 -L。
使用说明
涉及认证时需关注凭据是否可能跨主机重定向,避免不必要的 Header 泄露。
curl -C - -o <FILE> <URL>根据现有文件大小尝试从断点继续下载。
断点续传下载
根据现有文件大小尝试从断点继续下载。
基本语法
curl -C - -o <FILE> <URL>高频用法
curl -C - -o large.iso https://example.com/large.iso预期结果:
服务端支持 Range 时从已有位置继续传输。读取方法
-C - 让 curl 自动判断续传偏移。
使用说明
服务端不支持 Range、文件已变化或 ETag 不一致时应重新下载并校验完整性。