$hostname 是 Nginx 原生变量，记录服务器自身主机名，用于标识日志来源节点；区别于 $server_name（虚拟主机域名），不可互换；容器/K8s 中建议显式设置或通过环境变量增强可读性。
$hostname 是 Nginx 日志格式（log_format）中一个内置变量，用于在每条访问日志中记录当前 Nginx 服务所在服务器的主机名（hostname），而非客户端或上游服务器的名称。
作用：标识日志来源的物理/逻辑节点
当多台服务器部署相同 Nginx 配置（如集群、灰度环境、容器化部署），日志集中收集后难以区分哪条日志来自哪台机器。加入 $hostname 后，每条日志开头或指定位置就会带上该实例的主机名（例如 web-node-01、nginx-prod-2），便于快速定位问题发生的具体节点。
与 $server_name 的区别要清楚
-
$hostname：取自操作系统命令
hostname的输出，是服务器自身的标识，不可配置、不随域名变化； -
$server_name：取自
server块中server_name指令定义的域名（如example.com），反映的是虚拟主机配置，同一台机器多个站点会不同； - 二者语义完全不同，不能互换 —— 想标机器身份用
$hostname，想标业务域名用$server_name。
使用时要注意的细节
- 该变量无需额外模块支持，Nginx 1.3.1+ 原生可用；
- 若在容器中运行（如 Docker），默认 hostname 是容器 ID，建议启动时用
--hostname显式设置有意义的值； - Kubernetes 环境下，可通过 downward API 注入
spec.nodeName或metadata.name到环境变量，再用$env_<varname></varname>引用，比直接依赖$hostname更可控； - 日志轮转或远程写入时，确保日志系统能解析并索引该字段，否则加了也白加。
简单配置示例
在 http 块中定义：
log_format main '$hostname - $remote_addr - [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"';
这样每条日志开头就是类似：web-03 - 192.168.1.10 - [10/Jul/2024:14:22:31 +0800] "GET /api/v1/user HTTP/1.1" 200 1245 ...
