Nginx 默认记录 $http_user_agent，但需确保 log_format 显式包含双引号包裹的 "$http_user_agent"，注意大小写；代理场景下应保障 UA 透传；敏感信息宜用 map 提取类型而非全量记录；可结合 if 实现 UA 过滤与条件日志。
默认情况下，Nginx 的 access_log 已包含 $http_user_agent 变量，但要确保它被正确记录、安全使用并适配真实网络环境，需关注几个关键配置细节。
确认日志格式中已启用 User-Agent 字段
检查 log_format 是否显式包含 "$http_user_agent"。常见错误是沿用精简格式（如 short）或自定义时遗漏该变量：
- 标准 combined 格式已包含：`"$http_user_agent" "$http_x_forwarded_for"`
- 若自定义格式，请确保写法为双引号包裹：
"$http_user_agent"，避免因空格或特殊字符导致截断 - 注意大小写：必须是
$http_user_agent，不是$user_agent或$http_ua
处理代理转发场景下的 UA 真实性
当 Nginx 前有 CDN、负载均衡器或反向代理时，原始 UA 可能被覆盖或丢失：
Accessibility Review
下载
对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。
- 确保上游代理在转发请求时携带
User-Agent头（多数默认保留） - 若需透传多级 UA（如真实 UA + 中间代理 UA），可组合使用：
"$http_user_agent" "$http_x_forwarded_for" "$sent_http_user_agent"（后者需 upstream 显式返回） - 不建议依赖
$http_x_forwarded_for来“还原” UA，它只传 IP，与 UA 无关
规避敏感信息泄露与日志膨胀
User-Agent 字符串常含版本号、设备型号甚至操作系统序列号，直接全量记录存在风险：
- 对内部分析系统，可截取关键字段：用
map指令预处理，例如只提取浏览器类型：map $http_user_agent $ua_type { ~*msie "IE"; ~*firefox "Firefox"; ~*chrome "Chrome"; ~*safari "Safari"; default "Other"; }
再在 log_format 中使用$ua_type - 避免在日志路径或文件名中暴露 UA 特征（如按 UA 分割日志），易被扫描利用
- 若开启日志压缩（
gzip参数），UA 长字符串会显著提升压缩率，但解析时需解压——权衡存储与运维成本
配合访问控制做 UA 行为识别
User-Agent 不仅用于记录，还可联动过滤与监控：
- 在
location或server块中，用if ($http_user_agent ~* "Scrapy|MJ12bot") { return 403; }主动拦截恶意爬虫 - 结合
access_log ... if=实现条件记录：例如只记录非爬虫请求的完整 UA，减少日志体积map $http_user_agent $log_ua { ~*(Scrapy|Baiduspider) 0; default 1; }access_log /var/log/nginx/access.log main if=$log_ua; - 注意：不建议在
if中做复杂正则匹配高频请求，可能影响性能
