如何规划 Nginx 日志目录结构
在 linux 中规范管理 nginx 日志，核心做法是按虚拟主机（server block）建立独立的子目录，并在配置文件中将 `access_log` 和 `error_log` 指向这些子目录下的具体文件。这样做能避免所有日志混在一个大文件中导致难以排查，同时配合 logrotate 实现按天切割和自动清理。默认情况下，nginx 会将日志写入 /var/log/nginx/ 目录，但为了规范化管理，建议为每个站点创建单独的目录，例如 /var/log/nginx/example.com/。
server {
listen 80;
server_name example.com;
# 访问日志：指向特定站点的目录
access_log /var/log/nginx/example.com/access.log;
# 错误日志：指向特定站点的目录
error_log /var/log/nginx/example.com/error.log warn;
root /var/www/example.com;
index index.html;
}
上述配置展示了最基础的目录隔离方案。当 Nginx 启动或重载配置时，它会自动创建这些目录（如果权限允许）并生成日志文件。这种结构使得在排查某个特定域名的故障时，可以直接进入对应的目录查看日志，而无需从全局日志中过滤。对于拥有多个站点的服务器，这种“一域一目录”的模式是管理日志的基础。
如何通过 Logrotate 实现日志切割与清理
随着时间推移，单个日志文件会迅速膨胀，影响 Nginx 性能并占用大量磁盘空间。解决这一问题的标准做法是使用 logrotate 工具对日志进行定期切割、压缩和删除。Nginx 官方提供的 logrotate 配置文件通常位于 /etc/logrotate.d/nginx，我们需要根据自定义的目录结构对其进行适配，确保它能正确找到我们创建的子目录中的日志文件。
# /etc/logrotate.d/nginx
/var/log/nginx/*.log {
daily
missingok
rotate 52
compress
delaycompress
notifempty
create 0640 www-data adm
sharedscripts
postrotate
[ -f /var/run/nginx.pid ] && kill -USR1 $(cat /var/run/nginx.pid)
endscript
}
这段配置解释了切割的具体逻辑。daily 表示每天切割一次；rotate 52 表示保留最近 52 周（即一年）的日志；compress 启用 gzip 压缩以节省空间；postrotate 脚本中的命令向 Nginx 主进程发送 USR1 信号，通知其重新打开日志文件，从而让新的日志写入新文件，而旧文件被重命名。注意，通配符 *.log 必须覆盖到我们自定义的子目录，例如 /var/log/nginx/example.com/access.log，否则切割不会生效。如果使用了非标准路径，可能需要调整通配符或使用绝对路径列表。
基于 Nginx 日志格式变量优化存储效率
在确定了目录结构和切割策略后，进一步优化存储效率的关键在于日志内容的精简。Nginx 默认的 combined 日志格式包含大量信息，其中某些字段（如完整的请求头或用户代理）可能体积庞大且对日常排查帮助有限。通过定义自定义的 log_format，我们可以只记录关键指标，从而显著减少磁盘 I/O 和存储空间占用。
http {
# 定义自定义日志格式
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent"';
server {
listen 80;
server_name example.com;
# 应用自定义格式
access_log /var/log/nginx/example.com/access.log main;
}
}
在这个示例中，log_format 块定义了名为 main 的格式。虽然这与默认的 combined 格式相似，但在实际生产中，通常会移除 $http_cookie 或简化 $http_user_agent 以减小单行日志的大小。通过将 access_log 指令指向这个自定义格式，Nginx 会以更紧凑的方式写入日志。结合前文提到的 logrotate 压缩机制，这种精简后的日志在压缩率上会有更好的表现，进一步提升了存储管理的效率。需要注意的是，修改日志格式后，现有的日志分析工具（如 ELK 或 Grafana）可能需要相应调整解析规则。
