Nginx不原生支持环境变量替换日志路径，但可通过entrypoint脚本+envsubst、K8s ConfigMap+downwardAPI或宿主机卷挂载三种方式实现动态日志路径，核心在于启动前生成配置而非运行时解析。
Nginx 本身不原生支持用环境变量直接替换 access_log 或 error_log 路径（比如写成 access_log $LOG_PATH/access.log;），但通过容器化部署的组合策略，完全可以实现“动态日志路径”——即在启动容器时由外部传入路径参数，并让 Nginx 实际写入该位置。关键不在 Nginx 配置语法，而在构建与运行时的协同设计。
利用 entrypoint 脚本生成配置文件
Nginx 官方镜像支持在启动前执行自定义脚本。你可以挂载一个带占位符的模板配置（如 nginx.conf.tpl），再通过 entrypoint.sh 将环境变量注入生成真实配置：
#!/bin/sh # entrypoint.sh（需设为可执行） envsubst < /etc/nginx/nginx.conf.tpl > /etc/nginx/nginx.conf exec "$@"
模板中使用标准 shell 变量语法：
# nginx.conf.tpl
http {
log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent';
access_log ${NGINX_LOG_DIR:-/var/log/nginx}/access.log main;
error_log ${NGINX_LOG_DIR:-/var/log/nginx}/error.log warn;
# ... 其他配置
}启动时指定路径：
docker run -d \ -e NGINX_LOG_DIR=/host/logs \ -v $(pwd)/nginx.conf.tpl:/etc/nginx/nginx.conf.tpl \ -v $(pwd)/entrypoint.sh:/docker-entrypoint.d/10-custom.sh \ -v /path/on/host:/host/logs \ -p 80:80 nginx:alpine
使用 ConfigMap + downward API（Kubernetes 场景）
在 K8s 中，可通过 ConfigMap 存储模板配置，再结合 envFrom 和 downwardAPI 注入节点或 Pod 信息（如 hostname、namespace），用于构造带区分度的日志路径：
-
创建 ConfigMap 含模板：
data: nginx.conf.tpl: | access_log /var/log/nginx/${POD_NAMESPACE}_${POD_NAME}_access.log; error_log /var/log/nginx/${POD_NAMESPACE}_${POD_NAME}_error.log warn; -
Deployment 中挂载并注入环境变量：
env: - name: POD_NAME valueFrom: fieldRef: fieldPath: metadata.name - name: POD_NAMESPACE valueFrom: fieldRef: fieldPath: metadata.namespace volumeMounts: - name: nginx-conf-tpl mountPath: /etc/nginx/nginx.conf.tpl subPath: nginx.conf.tpl
再配合 initContainer 或 sidecar 运行 envsubst 生成最终配置，即可实现按 Pod 实例隔离日志路径。
挂载宿主机路径 + 固定容器内路径（最简可靠方案）
若无需路径“动态拼接”，只需“灵活指定物理位置”，直接利用 Docker 卷挂载是最稳定的做法：
- 宿主机创建日志目录：
mkdir -p /data/nginx-logs/app-v1 - 启动容器时绑定：
docker run -d \ -v /data/nginx-logs/app-v1:/var/log/nginx \ -v $(pwd)/custom.conf:/etc/nginx/nginx.conf \ -p 80:80 nginx
- 对应
custom.conf中写死路径：access_log /var/log/nginx/access.log; error_log /var/log/nginx/error.log warn;
此时
/var/log/nginx/是容器内路径，实际数据落在宿主机/data/nginx-logs/app-v1/，变更路径只需改-v参数，配置文件无需重写。
不复杂但容易忽略：Nginx 日志路径动态化的本质是“运行时配置生成”，不是“配置语法支持”。选对时机（启动前）、用对工具（envsubst / ConfigMap / 挂载），就能干净解耦路径与镜像。
