Nginx 日志记录：如何通过环境变量自定义日志内容-Nginx-PHP中文网

nginx无法直接在log_format中引用环境变量，但可通过map指令映射响应头、openresty的log_by_lua_block读取os.getenv()、proxy_set_header透传后端响应头或nginx -e注入变量等方式间接实现动态日志定制。

nginx 日志记录：如何通过环境变量自定义日志内容

Nginx 本身不支持直接在 log_format 中引用环境变量，但可以通过启动前注入、模块扩展或反向代理透传等方式间接实现日志内容的动态定制。核心思路是：让 Nginx 能“看到”所需变量，再通过内置变量（如 $sent_http_x_custom_header、$arg_* 或自定义 map）将其写入日志。

使用 map 指令映射环境变量值

Nginx 启动时会读取系统环境变量，但不能直接在 log_format 中使用 $env_MY_VAR 这类语法。可行办法是借助 map 指令，在配置中预先将环境变量映射为一个 Nginx 变量：

在 http 块中添加：

map $sent_http_x_env_my_var $my_log_var {<br>  default "";<br>  "" $sent_http_x_env_my_var;<br>}

更实用的做法是：由上游服务（如应用层）在响应头中设置 X-Env-My-Var，Nginx 用 $sent_http_x_env_my_var 获取它；或用 Lua 模块在请求阶段读取系统环境并赋值
若使用 OpenResty，可直接用 os.getenv("MY_VAR") 在 log_by_lua* 阶段写入自定义字段

通过 proxy_set_header 透传运行时变量

当 Nginx 作为反向代理时，可让后端服务返回特定响应头，再将该头内容记录进 access log：

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

在 location 块中添加：proxy_pass_request_headers on;（默认已开启）
确保后端在响应中带上类似 X-App-Instance: prod-01 的头
定义日志格式：log_format custom '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$sent_http_x_app_instance"';
这样每条日志末尾就会出现部署实例名，便于追踪灰度流量或容器 ID

利用 nginx -e 参数注入启动变量（适用于容器化部署）

Docker 或 systemd 启动 Nginx 时，可通过 -e 传入变量，并在配置中用 env 指令声明，再配合 map 或 Lua 使用：

启动命令示例：nginx -e "NGINX_ENV=staging" -c /etc/nginx/nginx.conf
在 nginx.conf 的 http 块顶部加：env NGINX_ENV;
注意：仅声明的 env 才能在后续配置中被 map 或 Lua 访问，未声明则视为不可见
配合 map 使用时需注意——map 不支持直接引用 env，仍需借助 Lua 或 header 机制桥接

推荐方案：OpenResty + log_by_lua_block（最灵活）

如果允许引入 Lua，这是最可控的方式。无需重启即可动态读取环境变量并写入日志字段：

安装 OpenResty 后，在 location 或 server 块中添加：

log_by_lua_block {<br>  local my_env = os.getenv("SERVICE_NAME") or "unknown"<br>  ngx.var.log_service_name = my_env<br>}

然后在 log_format 中使用：$log_service_name
该变量会在每次请求结束时计算，支持热更新、条件判断和拼接，适合多租户或微服务场景