如何借助Master进程发送特定信号完成Nginx日志的平滑切割与物理归档

作者：袖梨 2026-06-19

Nginx日志平滑切割通过Master进程响应USR1信号实现，不中断服务且不丢失日志；核心步骤为重命名旧日志、发送USR1信号触发reopen、验证后归档；推荐用logrotate自动化管理并注意权限、pid路径及执行顺序。

通过 Nginx Master 进程实现日志平滑切割与物理归档，核心是利用 USR1 信号触发日志文件句柄的重新打开，整个过程不中断服务、不丢失请求日志。这不是 Nginx 自身的轮转功能，而是靠外部操作配合 Master 进程的信号响应机制完成的。

Master 进程收到 SIGUSR1（即 nginx -s reopen 或 kill -USR1 <pid>）后会：

按顺序执行以下三步，确保原子性与安全性：

备份旧日志：将当前正在写的日志重命名，例如：
mv /var/log/nginx/access.log /var/log/nginx/access.log.$(date +%F-%H)
触发 reopen：向 Master 进程发送 USR1 信号，方式任选其一：
nginx -s reopen，或
kill -USR1 $(cat /var/run/nginx.pid)，或
kill -USR1 $(pgrep -f "nginx: master")
验证与清理：检查新 access.log 是否已生成且有新写入（如 curl 访问后查看文件大小变化），再对归档文件做压缩、同步或上传等后续处理

手动操作适合调试或低频场景；高可用系统应交由 logrotate 托管，它能精准控制周期、保留策略和权限。典型配置（/etc/logrotate.d/nginx）如下：

/var/log/nginx/*.log {
daily —— 每天凌晨触发
missingok —— 日志不存在也不报错
rotate 30 —— 最多保留 30 份
compress —— 压缩旧文件（.gz）
delaycompress —— 延迟压缩，确保当日日志不被立即压缩
create 0644 www-data adm —— 新日志权限与属主
sharedscripts —— 所有匹配文件共用一次 postrotate
  postrotate
    if [ -f /var/run/nginx.pid ]; then
      kill -USR1 $(cat /var/run/nginx.pid)
    fi
  endscript
}