首页 > 编程语言 >如何自定义Nginx日志输出格式

如何自定义Nginx日志输出格式

来源：互联网 2026-07-16 07:02:00

通过log_format和access_log指令可自定义Nginx日志输出。在配置文件中定义格式模板，包含客户端IP、请求时间、状态码等变量，再指定日志路径与格式名称，最后重载配置即可生效，便于问题排查与性能分析。

在 Nginx 的日常运维中，日志绝对是排查问题和监控系统健康状态的第一手资料。但默认的日志格式信息有限，有时候很难定位到真正的问题所在。所以，自定义日志输出就成了一个非常实用的技能。

那么，具体怎么操作呢？其实并不复杂，核心就是围绕 log_format 和 access_log 这两个指令来展开。直接进入正题。

如何自定义Nginx日志输出格式

首先，需要找到 Nginx 的配置文件。它通常位于 /etc/nginx/nginx.conf 这个全局配置文件中，或者在你为每个网站单独绑定的配置里，比如 /etc/nginx/sites-a vailable/your_domain.conf。

找到位置之后，下一步就是定义你想要的日志“样子”。我们需要在 http、server 或 location 块中，使用 log_format 指令来创建一个新的格式模板。比如，我们来定义一个名为 my_custom_format 的日志格式：

http {    ...    log_format my_custom_format '$remote_addr - $remote_user [$time_local] '                         '"$request" $status $body_bytes_sent '                         '"$http_referer" "$http_user_agent" '                         '"$http_x_forwarded_for" "$request_time"';    ...}

这个例子里，我们定义了一个包含多个关键字段的格式。可以把它想象成一个定制化的信息清单：

$remote_addr：来访的客户端 IP 地址。
$remote_user：如果开启了 HTTP 基本认证，这里会记录用户名。
$time_local：请求发生的本地时间。
$request：完整的请求行，包含了请求方法、URI 和 HTTP 协议版本。
$status：后端返回给客户端的 HTTP 状态码，比如 200、404、500。
$body_bytes_sent：发送给客户端的响应体字节数，不包含响应头。
$http_referer：请求来源页面的 URL，方便分析流量来源。
$http_user_agent：客户端的浏览器或爬虫的用户袋里信息。
$http_x_forwarded_for：如果使用了反向袋里或负载均衡，这个头可以记录客户端的真实 IP。
$request_time：Nginx 处理这个完整请求所花费的时间，单位是秒，这个是性能分析的关键指标。

你看，用哪些变量，完全取决于你关心的内容。如果你只需要简单的记录，那完全可以精简一下。

定义好格式之后，接下来就是应用它。在具体的 server 或 location 块里，通过 access_log 指令来指定日志文件的存储路径和刚才定义好的格式名称。

http {    ...    server {        listen 80;        server_name my_domain.com;        access_log /var/log/nginx/my_domain.com.access.log my_custom_format;        ...    }}

这个例子就很直接了：将名为 my_domain.com 的站点的访问日志，按照 my_custom_format 的格式，写入到 /var/log/nginx/my_domain.com.access.log 文件里。

最后，也是最关键的一步，自然是让配置生效。保存好配置文件后，先用以下命令检查一下语法有没有问题：