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 中用固定分隔符（如空格或
|）提升可解析性
