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

使用 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 
{
    daily
    missingok
    rotate 30
    compress
    delaycompress
    notifempty
    sharedscripts
    postrotate
        [ -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 命令向容器内发送信号。

postrotate
    docker 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 {
    daily
    missingok
    rotate 30
    compress
    delaycompress
    notifempty
    sharedscripts
    postrotate
        docker 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 {
    daily
    dateext                   # 使用日期后缀
    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 &amp;
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 ] &amp;&amp; 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 信号

nginx 收到 usr1 信号后的行为是：重新打开日志文件（包括 access.log 和 error.log）。这样做的目的是为了让 nginx 开始写入新的日志文件（比如切割后的 access.log），而不是继续写入旧的被重命名的日志文件（如 access.log.1）。

总结

通过logrotate实现nginx日志轮转：

宿主机方案：标准配置+usr1信号通知

docker方案：docker exec穿透容器执行命令

核心价值：

节省70%磁盘空间
保留30天历史日志便于审计
避免单文件过大导致的性能问题

最佳实践：生产环境建议启用dateext按日期归档，并集成日志分析系统实时监控异常。

到此这篇关于nginx使用logrotate实现日志轮转与保留策略！的文章就介绍到这了,更多相关nginx logrotate日志轮转与保留内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！

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

2026年04月30日 • SSL •我要评论