需显式设置 referer 是因跨域请求、spa 跳转、后端防盗链校验等场景会导致其缺失或不匹配；正确写法为 proxy_set_header referer "https://example.com";，须带协议和引号，并置于 proxy_pass 前。
直接在 Nginx 反向代理配置中使用 proxy_set_header Referer，可主动设置后端服务接收到的请求来源标识，解决因 Referer 缺失或不匹配导致的资源加载失败、防盗链拦截、页面渲染异常等问题。
为什么需要显式设置 Referer？
默认情况下，Nginx 反代会透传客户端原始 Referer（如果存在），但存在几种典型失效场景：
- 浏览器发起跨域资源请求（如 JS/CSS/图片）时可能自动省略 Referer
- 后端服务（如 PHP 应用、CDN 或 Cloudflare）严格校验 Referer 值，只接受特定域名
- 前端单页应用（SPA）通过 History API 跳转，document.referrer 为空，导致后续 AJAX 请求无 Referer
- 反代目标站本身做了 Referer 白名单限制（例如仅允许
https://example.com）
正确写法与关键细节
在 server 或 location 块中添加如下配置：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
proxy_set_header Referer "https://example.com";
- 引号必须保留，URL 必须带协议（
http://或https://），否则 Nginx 启动报错 - 值应为后端服务预期的合法来源地址，通常与目标站主域名一致
- 若需动态构造（如复用原请求 Host），可用变量：
proxy_set_header Referer "$scheme://$host"; - 该指令需放在
proxy_pass之前，且优先级高于客户端原始头（即会覆盖）
配合其他 header 提升兼容性
单独设 Referer 不足以应对所有场景，建议组合以下配置：
-
proxy_set_header Host $host;：确保后端识别正确的虚拟主机名 -
proxy_set_header X-Real-IP $remote_addr;：传递真实客户端 IP -
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;：补充 IP 链路 - 若目标站使用 Cloudflare：必须加
proxy_ssl_server_name on;，否则 SSL 握手失败（502 错误） - 若页面含
<meta name="referrer">标签，可在 proxy_redirect 或 sub_filter 中替换为<meta name="referrer" content="no-referrer">，避免前端二次干扰
验证是否生效
可通过以下方式确认 Referer 已被正确注入：
- 在后端脚本（如 PHP 的
$_SERVER['HTTP_REFERER']或 Node.js 的req.headers.referer）中打印日志 - 用 curl 模拟请求：
curl -H "Host: your-proxy-domain.com" http://127.0.0.1/path，观察后端接收值 - Nginx error.log 或 access_log 中开启
$http_referer变量记录（需自定义 log_format）
