Nginx反向代理日志记录（从零开始掌握日志配置技巧）

什么是 Nginx 反向代理？

反向代理是指 Nginx 接收客户端请求后，将请求转发给后端服务器（如应用服务器、API 服务等），再将后端响应返回给客户端。这种方式可以隐藏真实服务器地址、实现负载均衡、提升安全性等。

为什么需要记录反向代理日志？

通过日志，你可以：

• 查看访问来源（IP、User-Agent 等）
• 监控请求状态码（如 404、500 错误）
• 分析请求耗时和响应时间
• 排查后端服务异常

这些信息对于运维人员和开发者都至关重要。

Nginx 默认日志位置

Nginx 默认会记录两种日志：

• access.log：访问日志，记录每个请求的详细信息
• error.log：错误日志，记录运行过程中的错误信息

在大多数 Linux 系统中，它们通常位于 /var/log/nginx/ 目录下。

自定义反向代理访问日志格式

默认的日志格式可能无法满足你的需求。我们可以通过 log_format 指令自定义日志内容。

打开 Nginx 主配置文件（通常是 /etc/nginx/nginx.conf），在 http 块中添加如下代码：

log_format proxy_log '$remote_addr - $remote_user [$time_local] '                     '"$request" $status $body_bytes_sent '                     '"$http_referer" "$http_user_agent" '                     'upstream: $upstream_addr '                     'response_time: $upstream_response_time '                     'request_time: $request_time';  

上面这段代码定义了一个名为 proxy_log 的日志格式，其中包含了：

• $remote_addr：客户端 IP
• $status：HTTP 状态码
• $upstream_addr：后端服务器地址
• $upstream_response_time：后端响应时间
• $request_time：整个请求处理时间

在反向代理 server 块中启用自定义日志

接下来，在你的反向代理配置中（通常在 /etc/nginx/sites-available/ 下的某个文件），使用这个日志格式：

server {    listen 80;    server_name example.com;    access_log /var/log/nginx/proxy_access.log proxy_log;    location / {        proxy_pass http://backend_server;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    }}  

注意：access_log 指令指定了日志文件路径和使用的格式（即前面定义的 proxy_log）。

重载 Nginx 配置

修改完配置后，需要重新加载 Nginx 使配置生效：

sudo nginx -t      # 测试配置是否正确sudo systemctl reload nginx   # 重载配置（不中断服务）  

查看日志效果

现在，当你访问你的网站时，日志文件 /var/log/nginx/proxy_access.log 就会按你定义的格式记录每一条请求。例如：

192.168.1.100 - - [10/Apr/2024:10:30:45 +0800] "GET /api/user HTTP/1.1" 200 1234 "https://example.com" "Mozilla/5.0..." upstream: 10.0.0.5:8080 response_time: 0.123 request_time: 0.125  

从中你可以清晰看到请求来自哪个 IP、访问了什么接口、后端服务器是谁、响应花了多长时间等关键信息。

总结

通过合理配置 Nginx 反向代理日志记录，你可以获得强大的可观测性能力。无论是排查线上故障，还是分析系统性能瓶颈，日志都是不可或缺的工具。希望这篇教程能帮助你掌握 Web服务器日志 的基本配置方法。

记住，良好的日志实践是专业运维的第一步！如果你正在搭建自己的 Web 服务，别忘了配置好 Nginx日志配置 和 反向代理日志记录。