当前位置：首页 > news >正文

Nginx 实战：使用logrotate实现日志轮转与保留策略！

news 2025/7/21 19:54:34

在使用 Nginx 作为 Web 服务器或反向代理时，访问日志（access.log）和错误日志（error.log）是非常重要的调试和分析工具。但随着运行时间的增加，access.log 文件会变得越来越大，不仅占用磁盘空间，也会影响日志的查询效率。本文将介绍如何通过日志轮转来实现 Nginx 的日志按天切割，并设置日志的保留时间，以优化日志管理。

一、问题背景

默认情况下，Nginx 将所有访问记录写入一个日志文件中（如 /var/log/nginx/access.log）。随着时间推移：

文件体积过大：日志文件可能达到GB甚至TB级别，打开和查询效率极低
磁盘空间占用：未经压缩的日志文件会快速消耗磁盘空间
管理困难：单文件难以进行历史分析、归档和自动化处理
故障排查低效：在海量日志中定位问题如同大海捞针

为了解决这个问题，我们需要对日志进行定期切割，并保留一定时间的历史日志。

二、宿主机安装方案：使用logrotate实现日志轮转

Linux 系统中广泛使用的日志轮转工具是 logrotate，它支持按天、按大小自动切割日志，并可设置保留份数。

步骤1：确认是否安装了 logrotate

大多数 Linux 发行版默认已安装。你可以执行以下命令检查：

which logrotate

如果未安装，可以使用包管理器安装：

# Ubuntu / Debian
sudo apt update && sudo apt install logrotate# CentOS / RHEL
sudo yum install logrotate

步骤2：创建或修改 logrotate 配置文件

logrotate的配置文件一般位于/etc/logrotate.d下面，我们可以新建一个nginx的配置文件来管理日志，注意改为自己的nginx日志目录。

sudo bash -c 'cat > /etc/logrotate.d/nginx << EOF
/var/log/nginx/*.log 
{dailymissingokrotate 30compressdelaycompressnotifemptysharedscriptspostrotate[ -f /run/nginx.pid ] && kill -USR1 \$(cat /run/nginx.pid)endscript
}
EOF'

参数说明：

参数	说明
`daily`	每天轮换一次
`missingok`	如果日志文件不存在，不报错
`rotate 30`	保留最近 30 天的日志
`compress`	压缩旧日志文件（生成 .gz 文件）
`delaycompress`	推迟压缩到下一轮，避免刚轮换就压缩
`notifempty`	如果日志为空，不进行轮换
`sharedscripts`	所有日志共用 postrotate 脚本
`postrotate ... endscript`	切割完成后向Nginx主进程发送USR1信号使其重新打开日志文件

步骤3：测试 logrotate 配置

为了避免配置错误导致服务异常，测试配置，其中 -d 表示 debug 模式，只输出日志不会真正执行操作：

sudo logrotate -d /etc/logrotate.d/nginx

如果你想强制执行一次日志轮换，可以去掉 -d：

sudo logrotate -f /etc/logrotate.d/nginx

三、Docker环境方案：容器化Nginx日志轮转

如果我们使用了docker安装的 Nginx，上面这段脚本可能不会生效，原因如下：

/run/nginx.pid 这个文件在容器中可能存在，也可能不存在；
即使存在，你在宿主机上运行 kill -USR1 是无效的，因为目标进程在容器内部；
所以你不能直接在宿主机上使用 kill 向容器内的进程发送信号。

正确做法（Docker 环境下）

你可以改用 docker exec 命令向容器内发送信号。

postrotatedocker exec <nginx_container_name> kill -USR1 1
endscript

但是上面的脚本可能会执行失败： exec: "kill": executable file not found in $PATH，虽然docker exec your_container kill -USR1 1这是标准的向容器发送信号的方式，但容器内可能是一个极简镜像（比如基于 alpine 或 scratch），它不包含 kill 命令。

正确解决方案：改用 sh -c 直接发送信号

你可以通过在容器内运行一个 shell 命令来发送信号，而不是依赖 kill 命令本身。例如：

docker exec your_container sh -c 'kill -USR1 1'

修改后的完整的宿主机logrotate配置，注意修改日志路径：

sudo bash -c 'cat > /etc/logrotate.d/nginx << EOF
/opt/nginx/logs/*.log {dailymissingokrotate 30compressdelaycompressnotifemptysharedscriptspostrotatedocker exec nginx sh -c "kill -USR1 1"endscript
}
EOF'

四、日志轮转效果验证

执行完日志轮换后，你可以在日志目录看到类似下面的文件：

/var/log/nginx/
├── access.log          # 当前活动日志
├── access.log.1        # 昨日日志（未压缩）
├── access.log.2.gz     # 前日日志（已压缩）
├── error.log
├── error.log.1
└── error.log.2.gz

压缩效果对比：

原始日志：2.4GB
压缩后：720MB（节省70%空间）
30天保留策略可节省数十GB磁盘空间

五、高级配置技巧

自定义日志路径

如果你希望将日志按项目或域名分类存储，可以在 Nginx 配置中指定不同的日志路径：

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;
}server {listen 80;server_name api.example.com;access_log /var/log/nginx/api-access.log;error_log /var/log/nginx/api-error.log;
}

按日期命名的日志文件

/var/log/nginx/*.log {dailydateext                   # 使用日期后缀dateformat -%Y%m%d        # 日期格式rotate 90...
}

生成文件名示例：access.log-20240623.gz

日志分析与监控集成

postrotate# 发送通知到监控系统curl -X POST https://monitor.example.com/logrotate -d 'server=web01'# 触发日志分析任务/opt/scripts/log-analysis.sh &
endscript

六、常见问题

日志切割后，Nginx 是否需要重启？

不需要。只需发送 USR1 信号给 Nginx 进程，使其重新打开日志文件即可。

kill -USR1 $(cat /run/nginx.pid)

报错unknown user 'www-data'

/etc/logrotate.d/nginx 配置文件使用了一个系统中不存在的用户：www-data，通常是这一行引起的错误：

create 0640 www-data adm

create 表示在日志轮换后自动创建新的日志文件。
www-data 是通常用于 Nginx 进程运行的用户，在 Ubuntu/Debian 系统上存在。

解决方法：

将 www-data 替换为你的系统中存在的用户和组，比如 nginx（常见于 CentOS/RHEL）：

create 0640 nginx adm

或者如果你不确定用哪个用户，可以先注释掉这一行，让系统使用默认权限创建日志文件：

# create 0640 www-data adm

postrotate脚本的作用

 postrotate[ -f /run/nginx.pid ] && kill -USR1 \$(cat /run/nginx.pid)endscript

postrotate ... endscript：是一个脚本块，在 logrotate 完成日志切割之后自动运行。通常用于通知服务重新加载配置或重新打开日志文件。
[ -f /run/nginx.pid ]：如果 /run/nginx.pid 文件存在，就继续执行后面的命令
kill -USR1 $(cat /run/nginx.pid)：获取 Nginx 主进程的 PID（进程号），向 Nginx 发送一个 USR1 信号