nginx集群中记录主机名有三种方法:一是1.7.4+版本直接使用$hostname变量;二是旧版本通过env指令注入nginx_hostname环境变量;三是用map模块基于域名或ip映射node_name。

在 Nginx 集群中,为便于日志分析和问题定位,常需在访问日志中记录当前 Nginx 实例所在的主机名(hostname),以区分不同节点。Nginx 本身不直接支持 $hostname 变量,但可通过系统环境变量或启动时注入的方式实现。
方法一:使用 $hostname 变量(Nginx 1.7.4+ 原生支持)
从 Nginx 1.7.4 开始,官方引入了内置变量 $hostname,可直接在 log_format 中使用:
- 确认 Nginx 版本 ≥ 1.7.4(执行
nginx -v查看) - 在
http或server块中定义日志格式,例如:
log_format main '$hostname $remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';
access_log /var/log/nginx/access.log main;
重启 Nginx 后,每条日志开头就会显示该节点的 hostname(如 web-node-01)。
方法二:通过环境变量注入(兼容旧版本)
若使用较老版本 Nginx(如 1.6.x),可借助系统环境变量 + env 指令(需编译时启用 --with-http_realip_module 等基础模块,且支持 env 传递):
- 启动前导出环境变量:
export NGINX_HOSTNAME=$(hostname) - 在 nginx.conf 的
http块顶部添加:env NGINX_HOSTNAME; - 定义日志格式时使用
$env_NGINX_HOSTNAME:
log_format with_host '$env_NGINX_HOSTNAME $remote_addr ...'; access_log /var/log/nginx/access.log with_host;
⚠ 注意:Nginx 默认会清除大部分环境变量,env 指令必须显式声明要保留的变量,且仅在 master 进程启动时读取一次。
方法三:使用 map 模块动态映射(推荐用于多环境统一配置)
适用于需要根据 IP 或其他条件区分节点,或希望避免依赖系统 hostname 的场景:
- 在
http块中用map定义 hostname 映射:
map $host $node_name {
default "unknown";
~^web-node-01\.example\.com$ "web-node-01";
~^web-node-02\.example\.com$ "web-node-02";
}
log_format cluster '$node_name $remote_addr ...';
或更可靠地基于 $server_addr(监听 IP)映射:
map $server_addr $node_name {
192.168.1.10 "web-node-01";
192.168.1.11 "web-node-02";
default "unknown";
}
验证与注意事项
- 修改配置后务必执行
nginx -t测试语法,再nginx -s reload - 确保系统 hostname 设置正确(
hostname命令输出应为期望值),必要时用hostnamectl set-hostname xxx设置 - 容器环境中(如 Docker/K8s),建议在启动命令中显式传入 hostname,或挂载
/etc/hostname文件 - 日志轮转、ELK 收集时,注意字段解析——建议在 log_format 中用固定分隔符(如空格或
|)提升可解析性











