一聚教程网:一个值得你收藏的教程网站

热门教程

Nginx 中如何在 nginx.conf 中配置访问日志按天自动切割归档

时间:2026-08-28 11:04:49 编辑:袖梨 来源:一聚教程网

Nginx 本身不支持按日期自动分割日志,需借助 logrotate 工具实现:配置 /etc/logrotate.d/nginx,设 daily、rotate 30、postrotate kill -USR1 等参数,并手动验证 -d 和 -vf。

在 Nginx 中,nginx.conf 本身不支持原生的“按天切割日志”功能,它只能将日志写入指定文件(如 access.log),而日志轮转(rotate)需借助外部工具实现。最常用、轻量且可靠的方式是配合 Linux 的 logrotate 工具完成按天归档和压缩。

1. 确保 Nginx 日志路径固定且可被 logrotate 识别

nginx.conf 中,明确配置访问日志路径(推荐使用绝对路径),例如:

http {access_log /var/log/nginx/access.log main;error_log /var/log/nginx/error.log warn;}

注意:

- 不要用变量(如 $time_iso8601)动态生成日志名,否则 logrotate 无法匹配;

- 确保 Nginx 对该路径有读写权限(尤其 logrotate 切割后发 USR1 信号时需重开文件)。

2. 配置 logrotate 按天轮转(推荐方式)

新建或编辑 /etc/logrotate.d/nginx

/var/log/nginx/*.log {dailymissingokrotate 30compressdelaycompressnotifemptycreate 0644 www-data www-datasharedscriptspostrotateif [ -f /var/run/nginx.pid ]; thenkill -USR1 `cat /var/run/nginx.pid`fiendscript}

关键说明:

- daily:每天执行一次轮转;

- rotate 30:保留最近 30 个归档文件(如 access.log.1.gz ~ access.log.30.gz);

- compress + delaycompress:压缩旧日志,但最新一轮(.1)暂不压,下次再压;

- create 0644 www-data www-data:轮转后重建日志文件,权限与属主需匹配 Nginx 运行用户(常见为 www-datanginx);

- postrotate ... kill -USR1:通知 Nginx 关闭旧日志文件、打开新文件(这是关键一步,否则 Nginx 仍往旧文件写)。

3. 验证与调试

手动触发并测试是否正常:

  1. 运行 sudo logrotate -d /etc/logrotate.d/nginx(-d 表示 debug 模式,只打印动作不执行)
  2. -f 强制执行:sudo logrotate -f /etc/logrotate.d/nginx
  3. 检查:ls -l /var/log/nginx/ 是否出现 access.log.1,Nginx 是否仍在写新 access.log
  4. 确认 Nginx 进程未报错:sudo tail -n 10 /var/log/nginx/error.log

4. 替代方案(不推荐用于生产)

极简场景下可用 shell 脚本 + cron,但稳定性、原子性、信号处理不如 logrotate

# 示例:/usr/local/bin/rotate-nginx-log.shmv /var/log/nginx/access.log /var/log/nginx/access.log.$(date +%Y%m%d)kill -USR1 $(cat /var/run/nginx.pid)gzip /var/log/nginx/access.log.$(date +%Y%m%d)

然后添加 crontab:

0 0 * * * /usr/local/bin/rotate-nginx-log.sh

缺点:无归档数量控制、无错误防护、并发风险、gzip 失败会导致磁盘占满。

logrotate 是标准、安全、可维护的做法,无需修改 Nginx 配置,也不依赖第三方模块。只要路径、权限、USR1 信号三者配合好,就能稳定实现按天归档。

热门栏目