Nginx可通过$log_format配合$http_user_agent变量将User-Agent写入日志，需注意变量名大小写及双引号包裹；启用时用access_log引用格式名，并可用map截取前200字符防日志过长。
在 Nginx 中，可以通过自定义 log_format 指令，将客户端请求头中的 User-Agent 信息写入访问日志。关键在于使用内置变量 $http_user_agent，它会自动提取请求头中 User-Agent 字段的原始值。
定义包含 User-Agent 的日志格式
在 http 块（推荐）或 server 块中添加自定义日志格式：
log_format ua_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';说明：
-
$http_user_agent是标准变量，区分大小写，必须全小写加下划线； - 该变量值为空字符串（而非
-）时，表示客户端未发送User-Agent头； - 建议用双引号包裹，避免日志中因 UA 含空格、斜杠等导致解析困难；
- 变量名不能写成
$user_agent或$http_User_Agent，否则无效。
启用自定义日志格式
在 server 或 location 块中，用 access_log 指令引用刚定义的格式名：
access_log /var/log/nginx/access_ua.log ua_log;
注意：
- 确保日志路径目录存在且 Nginx 进程有写入权限；
- 格式名
ua_log必须与log_format后的第一个标识符完全一致； - 可同时配置多个
access_log行，实现不同格式分别记录。
验证与调试技巧
确认日志是否生效：
- 修改配置后执行
nginx -t检查语法，再nginx -s reload生效； - 用
curl -A "TestBrowser/1.0" http://your-site/发起带 UA 的请求； - 查看日志文件末尾：
tail -f /var/log/nginx/access_ua.log，应看到类似：
127.0.0.1 - - [10/Jan/2024:15:22:33 +0800] "GET / HTTP/1.1" 200 612 "-" "TestBrowser/1.0"
如果 "$http_user_agent" 显示为空引号 ""，说明客户端确实没发该头；若显示为 -，可能是日志格式写错或变量未识别。
进阶：过滤或截断过长的 User-Agent
Nginx 原生不支持字符串截断，但可通过以下方式缓解日志膨胀问题：
- 用
map指令预处理（需在http块中）：
map $http_user_agent $ua_short {
~^(.{0,200}).*$ $1;
default $http_user_agent;
}
log_format ua_log_short '$remote_addr ... "$ua_short"';说明：该 map 将 UA 截取前 200 字符，超长部分丢弃，适合防止日志行过长影响分析工具读取。
