Nginx 如何在 Nginx 中配置访问日志记录服务器自身的 hostname 区分集群节点

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 中使用：

1. 确认 Nginx 版本 ≥ 1.7.4（执行 nginx -v 查看）
2. 在 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 传递）：

1. 启动前导出环境变量：export NGINX_HOSTNAME=$(hostname)
2. 在 nginx.conf 的 http 块顶部添加：env NGINX_HOSTNAME;
3. 定义日志格式时使用 $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 的场景：

1. 在 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";}

验证与注意事项

1. 修改配置后务必执行 nginx -t 测试语法，再 nginx -s reload
2. 确保系统 hostname 设置正确（hostname 命令输出应为期望值），必要时用 hostnamectl set-hostname xxx 设置
3. 容器环境中（如 Docker/K8s），建议在启动命令中显式传入 hostname，或挂载 /etc/hostname 文件
4. 日志轮转、ELK 收集时，注意字段解析——建议在 log_format 中用固定分隔符（如空格或 |）提升可解析性