nginx默认透传user-agent，无需额外配置；仅当需改写、拼接或清洗时才需显式设置proxy_set_header user-agent，并确保使用$http_user_agent变量且置于proxy_pass前。

Nginx 默认就会把客户端的 User-Agent 完整透传给后端，不需要额外配置。只要没手动覆盖或清空，后端服务（如 Node.js、Spring Boot、Flask）就能直接读到真实浏览器 UA。

默认行为已满足大多数场景

• Nginx 内部等效执行了 proxy_set_header User-Agent $http_user_agent;
• $http_user_agent 是内置变量，自动提取原始请求头中的 User-Agent 字段
• 如果你的配置里没写过 proxy_set_header User-Agent，那它就是原样转发的

需要显式配置的几种情况

• 强制统一标识：比如所有请求都标为 "Backend-Proxy"，方便后端日志归类

  proxy_set_header User-Agent "Backend-Proxy";

• 拼接原始 UA + 代理标记：保留原始信息的同时注明来源

  proxy_set_header User-Agent "$http_user_agent (via Nginx)";

• 结合 map 做 UA 清洗或分类（例如识别移动端并打标签）

  map $http_user_agent $device_type {
      ~*android|iphone|mobile "mobile";
      ~*tablet|ipad         "tablet";
      default                 "desktop";
  }
  proxy_set_header X-Device-Type $device_type;

注意事项

• proxy_set_header User-Agent 必须放在 proxy_pass 之前，且在 location 或 server 块内
• 同一个块中写了多个 proxy_set_header User-Agent，只有最后一个生效
• 别写成 $user_agent（错误），正确变量名是 $http_user_agent
• 如果后端收不到 UA，先排查是否被 CDN、WAF 或前置 LB 提前剥离了请求头

快速验证方法

• 后端接口打印 req.headers['user-agent']（Express）或 request.headers.get('User-Agent')（Flask）
• 用 curl 模拟测试：

  curl -H "User-Agent: TestBot/1.0" https://your-domain.com/api/info

  看响应或日志中是否出现 TestBot/1.0

  

  Agent Passport

  AI 代理执行与问责层，支持自带身份（did:key、did:web、SPIFFE、OAuth、did:aps），网关执行边界单调递增。

  下载

不复杂但容易忽略的是：默认就对，改之前先确认真有需要。