如何使用 cURL 发送 HTTP 头：综合指南

Michael Lee

Expert Network Defense Engineer

22-Sep-2025

关键要点：

HTTP头对于客户端与服务器之间的通信至关重要，传递有关请求和响应的必要元数据。
cURL提供了-H或--header选项，以便轻松地与请求一起发送自定义HTTP头。
可以通过多次使用-H选项发送多个头。
理解和操作头对于网络爬虫、API测试和调试网络问题至关重要。
使用cURL查看响应头有助于调试和理解服务器行为。

介绍

cURL（客户端URL）是一个强大的命令行工具，用于通过URL传输数据，支持HTTP、HTTPS和FTP等协议。对于开发人员和系统管理员而言，cURL是不可或缺的。它发送和接收HTTP头的能力是定义客户端-服务器交互的基础。本指南提供了如何使用cURL发送HTTP头的综合概述，涵盖各种场景、实用示例和最佳实践。

什么是HTTP头？

HTTP头是HTTP请求和响应的基本部分，携带交易的必要元数据。它们就像信件的信封和邮资信息，而信件的主体就是信件本身。它们使得缓存、身份验证和内容协商等功能成为可能。

HTTP头的类型：

请求头： 由客户端发送（例如，User-Agent，Authorization）。
响应头： 由服务器发送（例如，Content-Type，Set-Cookie）。
一般头： 适用于两者（例如，Date，Connection）。
实体头： 描述主体（例如，Content-Length）。

操作请求头对于调试、API测试和模拟特定客户端行为至关重要。

基本语法：发送单个头

要使用cURL发送HTTP头，请使用-H或--header选项，后跟"Header-Name: Header-Value"。

语法：

bash Copy

curl -H "Header-Name: Header-Value" [URL]

示例1：设置自定义User-Agent

覆盖cURL的默认User-Agent以模拟网页浏览器：

bash Copy

curl -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36" https://www.example.com

这使请求看起来像是来自Chrome浏览器，对于与阻止非浏览器用户代理的网站进行交互非常有用。

示例2：设置Accept头

指定首选内容类型，例如JSON：

bash Copy

curl -H "Accept: application/json" https://api.example.com/data

这请求从API端点获取JSON格式的数据。

发送多个HTTP头

通过在单个命令中多次使用-H选项发送多个头。

语法：

bash Copy

curl -H "Header-Name-1: Header-Value-1" \
     -H "Header-Name-2: Header-Value-2" \
     [URL]

示例3：包含身份验证和内容类型的POST请求

对于API调用，包含Authorization和Content-Type头：

bash Copy

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -d '{"name": "John Doe", "age": 30}' \
     https://api.example.com/users

这发送带有JSON数据的POST请求，使用Bearer令牌进行身份验证。

覆盖默认头

cURL发送一些默认头。通过使用-H指定自定义值来覆盖它们。您的自定义头具有优先权。

示例4：覆盖User-Agent头

bash Copy

curl -H "User-Agent: MyCustomApp/1.0" https://www.example.com

这将您的客户端标识为MyCustomApp/1.0，以供服务器识别。

示例5：移除默认头

要移除cURL通常会发送的头，请使用没有值的分号：

bash Copy

curl -H "Accept-Encoding;" https://www.example.com

这明确告诉cURL不要发送Accept-Encoding头。

使用不同HTTP方法发送头

cURL支持所有标准HTTP方法，使用-X选项，头通过-H添加。

示例6：带有头的PUT请求

bash Copy

curl -X PUT \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_AUTH_TOKEN" \
     -d '{"status": "active"}' \
     https://api.example.com/items/123

这更新了资源，确保正确的内容解释和身份验证。

示例7：带有头的DELETE请求

bash Copy

curl -X DELETE \
     -H "Authorization: Bearer YOUR_AUTH_TOKEN" \
     https://api.example.com/items/456

这对资源执行经过身份验证的DELETE请求。

使用cURL处理Cookies

Cookies是用于会话管理的特殊HTTP头。cURL提供了特定的选项来发送和接收它们。

示例8：发送Cookie

使用-H "Cookie: ..."或更方便的-b（或--cookie）选项：

bash Copy

curl -b "session_id=abc123xyz" https://www.example.com/dashboard

示例9：从文件存储和发送Cookies
首先，将从服务器收到的cookie保存到cookies.txt中：

bash Copy

curl -c cookies.txt https://www.example.com/login

然后，在后续请求中发送这些cookie：

bash Copy

curl -b cookies.txt https://www.example.com/profile

这对于模拟登录用户会话是基础内容。

查看响应头

查看响应头对于调试和理解服务器行为至关重要。使用-i或-I。

示例 10：查看所有响应头和主体

使用-i（或--include）来显示头部和响应主体：

bash Copy

curl -i https://www.example.com

示例 11：仅查看响应头（HEAD请求）

使用-I（或--head）发送HEAD请求，仅获取头部，省略主体：

bash Copy

curl -I https://www.example.com

对于检查资源状态或缓存头信息非常高效。

示例 12：将头部保存到文件

使用-D或--dump-header将响应头保存到文件中：

bash Copy

curl -D headers.txt https://www.example.com

这将在打印主体到标准输出的同时将头部保存到headers.txt中。

使用cURL发送HTTP头的实际用例

自定义头对于各种应用是不可或缺的：

1. API测试和调试

发送特定头用于身份验证或自定义参数，以测试API端点。

示例： 使用X-API-Key测试API。

bash Copy

curl -H "X-API-Key: your_secret_api_key" https://api.example.com/v1/data

2. 网络爬虫和数据提取

模拟真实浏览器以避免被检测，通过设置User-Agent、Referer和Cookie头。

示例： 使用类似浏览器的User-Agent和会话cookie进行爬取。

bash Copy

curl -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36" \
     -b "session_id=your_session_id" \
     https://www.example.com/protected_data

3. 模拟浏览器行为

模拟诸如表单提交等交互，其中头部起着关键作用。

示例： 通过application/x-www-form-urlencoded模拟表单提交。

bash Copy

curl -X POST \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "username=testuser&password=testpass" \
     https://www.example.com/login

4. 测试Web服务器配置

测试服务器配置、缓存策略和安全设置。

示例： 使用If-Modified-Since检查缓存行为。

bash Copy

curl -I -H "If-Modified-Since: Wed, 21 Oct 2015 07:28:00 GMT" https://www.example.com/static/image.jpg

最佳实践和故障排除

为了确保有效和负责任地使用cURL与HTTP头，请考虑以下最佳实践和故障排除技巧：

最佳实践：

明确具体： 仅发送必要的头。过多的头可能触发反爬虫机制。
明智使用User-Agent： 模拟流行浏览器进行网络爬虫以避免被封，但要注意针对性的反爬虫检测。
正确处理Cookies： 使用-c（cookie-jar）和-b（cookie）选项进行会话管理，而不是手动设置Cookie头。
检查响应： 始终使用-i或-I以查看响应头，以便调试和理解服务器行为。
URL编码： 正确对查询字符串或表单数据中的参数进行URL编码，以防止特殊字符导致的问题。
遵循robots.txt： 从道德角度，检查并遵循网站的robots.txt指南进行自动化操作。

故障排除常见问题：

"403 Forbidden" 或 "401 Unauthorized" 错误：
- 验证Authorization头（令牌的有效性）。
- 检查User-Agent和Referer头。
- 考虑IP被封；使用代理或等候。
内容不正确或响应为空：
- 确认Content-Type和Accept头与服务器预期匹配。
- JavaScript渲染： cURL获取原始HTML。如果内容由JS渲染，考虑使用无头浏览器或专门的爬虫API。
- 跟随重定向： 使用-L或--location使cURL跟随HTTP 3xx重定向。
连接超时或连接被拒绝：
- 确保URL正确且服务器可达。
- 检查本地防火墙或网络代理。
- 服务器可能暂时宕机或超载。

在cURL中使用详细输出（-v）选项可以为调试提供宝贵的详细信息。

结论及号召行动

使用cURL发送HTTP头是从事网络技术的任何人必须掌握的基本技能。从基本的User-Agent操控到复杂的身份验证方案和cookie管理，cURL提供了灵活性和强大的能力来构建精确的HTTP请求。掌握这些技巧对于有效的API测试、稳健的网络爬虫和全面的网络调试至关重要。
通过了解每个头部的作用并利用cURL的多功能选项，您可以获得更大的控制能力来管理客户端与服务器的交互。请记住，始终遵循最佳实践，尊重网站政策，并利用cURL的调试功能，以确保您的请求既有效又负责任。

准备好提升您的cURL技能吗？

通过本指南中提供的示例进行实验，探索cURL的广泛文档，并将在日常工作流程中整合这些技术。精确控制HTTP头部的能力无疑会使您成为更高效、更有能力的网络专业人士。