如何在Debian服务器上设置Node.js日志轮转

Node.js 应用在 Debian 服务器上运行时，如果不做日志管理，app.log 会无限增长，最终占满磁盘。解决方案就是配置日志轮转(log rotation)。下面我给你一个完整的 Debian 下 Node.js 日志轮转设置指南。

一、为什么要做日志轮转

避免磁盘爆满：Node.js 应用长时间运行时，日志可能几十 GB。
方便运维排查：旧日志按日期归档，新日志保持清晰。
提升性能：避免单个日志文件过大导致 tail、grep 慢。

二、常见的日志轮转方案

在 Debian 中，有两种主流方式：

logrotate(推荐)：Linux 内置工具，定时执行，规则灵活。

PM2 内置日志管理：如果用 PM2 管理 Node.js 进程，可以直接用它的 pm2-logrotate 插件。

下面我分别讲解。

三、方法一：使用 logrotate 配置 Node.js 日志轮转

确认日志存放路径

假设 Node.js 应用的日志文件在：

php 复制代码

/var/www/myapp/logs/app.log

安装 logrotate

Debian 默认有 logrotate，没有就装：

php 复制代码

sudo apt-get update
sudo apt-get install logrotate -y

创建配置文件

在 /etc/logrotate.d/ 下新建配置：

php 复制代码

sudo nano /etc/logrotate.d/myapp

写入内容：

php 复制代码

/var/www/myapp/logs/*.log {
    daily                # 每日轮转
    rotate 7             # 保留7天的日志
    compress             # 压缩旧日志
    delaycompress        # 延迟一天再压缩，避免影响最新日志
    missingok            # 忽略不存在的日志文件
    notifempty           # 空日志文件不处理
    create 0640 www-data www-data   # 新文件权限与属主
    postrotate
        # 通知 Node.js 应用重新打开日志
        # 适配 pm2 的情况可以用 pm2 reload logs
    endscript
}

测试配置

php 复制代码

sudo logrotate -d /etc/logrotate.d/myapp

强制执行轮转(验证效果)

php 复制代码

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

执行后，app.log 会被切割为：

php 复制代码

app.log
app.log.1.gz
app.log.2.gz
...

四、方法二：使用 PM2 的日志轮转插件

如果你用 PM2 管理 Node.js 进程，可以直接用 pm2-logrotate 插件。

安装插件

php 复制代码

pm2 install pm2-logrotate

查看默认配置

php 复制代码

pm2 conf

修改参数

比如设置每天轮转，最多保留 7 天：

php 复制代码

pm2 set pm2-logrotate:compress true
pm2 set pm2-logrotate:rotateInterval '0 0 * * *'
pm2 set pm2-logrotate:max_days 7

说明：

rotateInterval '0 0 * * *' → 每天凌晨轮转

max_days 7 → 保留 7 天旧日志

compress true → 压缩归档

验证

观察日志目录(默认在 ~/.pm2/logs/)，是否出现 .1, .2, .gz 文件。

总结：在 Debian 服务器上，给 Node.js 应用做日志轮转有两种最佳实践：

系统级 logrotate：适合任何 Node.js 部署方式。

PM2-logrotate 插件：更适合 PM2 管理的应用。

推荐你：

如果是生产环境 → 用 logrotate，稳定可靠;

如果是个人项目 + PM2 → 用 pm2-logrotate，简单方便。