Nginx 默认透传 User-Agent，无需配置；问题多因中间覆盖、代理链干扰或 CDN 改写所致，排查应先验证日志与后端请求头，避免误加 proxy_set_header User-Agent。
默认情况下，Nginx 使用 proxy_pass 转发请求时，会自动携带原始请求的 User-Agent 头，**无需额外配置即可透传**。但实际中常因上游服务（如后端应用）未收到或收到被覆盖的 User-Agent，误以为需要手动设置。问题往往出在中间覆盖、代理链干扰或 Nginx 默认行为被意外修改。
确认 User-Agent 是否真的丢失
先排查是否真没传过去，而不是后端读取方式有误：
- 在后端服务（如 Node.js/Python/Java）中打印全部请求头，确认
User-Agent字段是否存在、内容是否符合预期 - 用
curl -H "User-Agent: test-bot/1.0" http://your-nginx-domain/测试，避免浏览器缓存或扩展干扰 - 在 Nginx 日志中添加
$http_user_agent变量，验证接入层是否接收到：
log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"';
避免显式覆盖 User-Agent 的常见错误
如果在 location 或 server 块中写了类似 proxy_set_header User-Agent ""; 或 proxy_set_header User-Agent "nginx";，就会强制覆盖原始值。只要不写这行，Nginx 就保持原样透传。
Bailian Usage Proxy
下载
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
若需在特定条件下修改（例如统一标识为“via-nginx”），应明确赋值：
-
proxy_set_header User-Agent "via-nginx";—— 全部覆盖 -
proxy_set_header User-Agent "$http_user_agent";—— 等价于默认行为（冗余但安全） - 想追加信息（如标记代理层）：
proxy_set_header User-Agent "$http_user_agent, nginx-proxy";
注意多级代理或 CDN 场景
如果请求经过 CDN（如 Cloudflare）、WAF 或其他反向代理，原始 User-Agent 可能已被改写或丢弃。此时 Nginx 收到的 $http_user_agent 本身就不对。
- 检查 CDN 控制台是否启用了 “Preserve Original User-Agent” 类似选项
- 某些 CDN 会把原始 UA 放在
X-Original-User-Agent或Cf-Connecting-Ip等自定义头里，可配合proxy_set_header User-Agent $http_x_original_user_agent;回填 - 确保 Nginx 的
underscores_in_headers on;（如需读取带下划线的头）
附：一个干净的 proxy_pass 配置示例
以下是最简且安全的写法，无多余覆盖，保证 UA 透传：
location /api/ {
proxy_pass https://backend-server/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# 不设置 User-Agent → 自动继承客户端原始值
} 
