在CDN回源场景中,需通过Nginx的proxy_set_header在location块中显式设置可信自定义Header(如X-CDN-Provider),使用常量或$hostname等服务端可控变量,避免客户端伪造;该指令会完全覆盖同名请求头,确保源站准确识别CDN来源。

在 CDN 回源场景中,通过 Nginx 在请求头中添加自定义 Header(如 X-CDN-Provider 或 X-Forwarded-By),能让源站明确识别请求来自哪个 CDN 节点或服务商,便于日志分析、访问控制、灰度路由等。关键在于:回源请求由 Nginx 主动发起(使用 proxy_pass),因此需在 location 块中用 proxy_set_header 显式设置,且注意避免被客户端伪造的同名 Header 覆盖。
1. 在 proxy_pass 前设置可信的自定义 Header
Nginx 默认不会透传客户端发来的所有 Header,但也不会自动覆盖你用 proxy_set_header 显式声明的值。只要在 location 中配置,该 Header 就会稳定出现在发往源站的请求中:
- 使用
proxy_set_header X-CDN-Provider "YourCDNName";添加固定标识 - 若需区分边缘节点,可用变量如
$hostname或自定义 map 变量:proxy_set_header X-CDN-Node $hostname; - 避免写成
proxy_set_header X-CDN-Provider $http_x_cdn_provider;(易被客户端伪造),应始终设为服务端可控的常量或可信变量
2. 确保 Header 不被 client 请求干扰
客户端可能携带同名 Header(如 X-CDN-Provider),但 Nginx 的 proxy_set_header 会**完全覆盖**而非追加——这是安全前提。无需额外清除,只要不主动透传(即不写 proxy_pass_request_headers on 或未禁用默认行为),客户端 Header 就不会影响回源头。
- 默认情况下,Nginx 已忽略大部分非标准 Header,
X-*类 Header 不会自动透传 - 若曾启用
underscores_in_headers on并允许下划线,也建议关闭,防止解析异常 - 可配合
proxy_hide_header隐藏源站返回的敏感响应头,但不影响回源请求头设置
3. 验证 Header 是否生效
最直接的方式是让源站记录全部请求头(如用 Nginx 的 log_format 包含 $http_x_cdn_provider),或临时用 nc -l 8080 搭建简易接收端测试:
- 在 Nginx 配置中加入:
proxy_set_header X-CDN-Provider "MyEdgeCache";proxy_set_header X-Request-ID $request_id; - 重启 Nginx 后,curl 访问 CDN 域名,检查源站 access_log 或抓包确认该 Header 出现在回源请求中
- 注意:浏览器开发者工具看到的是 CDN 返回给用户的响应头,不是回源请求头;必须查源站日志或网络层
4. 进阶:按域名或路径差异化标识
若一台 Nginx 同时代理多个业务,可通过 map 指令实现动态 Header:
- 在 http 块中定义:
map $host $cdn_id {<br> default "unknown";<br> ~^app\.example\.com$ "app-cdn";<br> ~^api\.example\.com$ "api-cdn";<br>} - 在 location 中使用:
proxy_set_header X-CDN-ID $cdn_id; - 这样不同子域回源时自动带上对应标识,源站可据此做策略分流


















