在运维和开发工作中，了解用户如何访问你的网站至关重要。而Nginx日志格式就是记录这些访问行为的关键工具。通过合理配置日志，你可以分析流量来源、排查错误、优化性能，甚至防范攻击。本文将手把手教你如何配置Nginx的access_log，即使是小白也能轻松上手！
一、Nginx默认日志长什么样？
当你安装完Nginx后，默认会启用访问日志（access log），通常位于 /var/log/nginx/access.log。默认的日志格式如下：
127.0.0.1 - - [01/Jan/2023:12:00:00 +0800] "GET / HTTP/1.1" 200 612 "-" "Mozilla/5.0 ..."这段日志包含了IP地址、时间、请求方法、状态码、响应大小、User-Agent等信息。但默认格式可能无法满足你的特定需求，比如你想记录请求耗时、上游响应时间，或者添加自定义字段。
二、自定义日志格式：log_format指令
Nginx使用 log_format 指令来定义日志格式。你可以在 http 块中定义一个或多个日志模板，然后在 server 或 location 块中引用它。
下面是一个常见的自定义日志格式示例：
log_format main '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent" ' '"$request_time" "$upstream_response_time"';上面的配置定义了一个名为 main 的日志格式，其中包含以下变量：
$remote_addr：客户端IP地址$time_local：本地时间$request：完整的HTTP请求行（如 GET /index.html HTTP/1.1）$status：响应状态码（如200、404）$body_bytes_sent：发送给客户端的字节数$http_referer：来源页面（Referer）$http_user_agent：客户端浏览器信息$request_time：整个请求处理耗时（秒）$upstream_response_time：后端服务响应时间（用于反向代理场景）
三、应用自定义日志格式
定义好日志格式后，你需要在 server 块中使用 access_log 指令来启用它：
server { listen 80; server_name example.com; access_log /var/log/nginx/example_access.log main; location / { root /usr/share/nginx/html; index index.html; }}这里 access_log 后面的第一个参数是日志文件路径，第二个参数 main 就是我们前面定义的日志格式名称。
四、常用变量与高级技巧
除了上面提到的变量，Nginx还支持很多其他变量，例如：
$host：请求中的Host头部$uri：请求的URI（不带参数）$args：请求参数（query string）$ssl_protocol：SSL协议版本（用于HTTPS）$gzip_ratio：Gzip压缩比率
你还可以结合条件判断，只记录特定状态码的日志：
map $status $loggable { ~^[23] 0; # 2xx 和 3xx 不记录 default 1; # 其他都记录}access_log /var/log/nginx/error_requests.log main if=$loggable;五、小结
通过本文，你应该已经掌握了如何配置自定义日志格式、理解了access_log配置的基本用法，并能根据业务需求灵活调整日志内容。合理的日志不仅能帮助你监控系统健康状况，还能为安全审计和性能优化提供数据支持。
记住，良好的日志实践是每个运维和开发人员的必备技能。现在就去检查你的Nginx配置，看看是否可以优化日志格式吧！
SEO关键词提示：本文涉及的核心关键词包括 Nginx日志格式、access_log配置、自定义日志格式 和 Web服务器日志，这些也是你在实际工作中最常搜索的技术点。