Linux Node.js日志轮转配置指南

Linux Node.js 日志轮转配置指南

日志轮转，听起来是个运维术语，但说白了，就是给你的应用日志文件“瘦身”和“归档”，防止单个日志文件无限膨胀，最终撑爆磁盘。对于Node.js应用来说，选对方案，配置得当，能省去不少后续麻烦。下面就来聊聊几种主流做法，你可以根据部署环境对号入座。

一 常用方案与适用场景

选择哪种方案，很大程度上取决于你的应用是如何部署和管理的。为了让你一目了然，这里有个快速对比表：

简单来说，生产环境通常优先考虑系统级的 logrotate，或者直接使用进程管理器自带的轮转功能，这样运维起来最省心。

二 方案一 logrotate 系统级配置

这是最通用、最经典的方法，不挑部署方式，只要你的应用在Linux上跑，它基本都能管。

• 安装与准备
  • 大多数Linux发行版已经预装了logrotate。万一没有，安装也很简单：
    • Debian/Ubuntu系：sudo apt-get install logrotate
    • CentOS/RHEL系：sudo yum install logrotate
  • 准备工作：建议将应用的日志统一输出到特定目录，比如 /var/log/yourapp/ 或 /opt/yourapp/logs/。别忘了，运行应用的用户必须对这个目录有写入权限。
• 创建配置文件
  • 在 /etc/logrotate.d/ 目录下为你的应用新建一个配置文件，例如 /etc/logrotate.d/yourapp。
  • 一个典型的按天轮转、保留7天、并启用压缩的配置示例如下：

    /var/log/yourapp/*.log {
        daily
        rotate 7
        compress
        delaycompress
        missingok
        notifempty
        create 0640 yourapp yourapp
        postrotate
            # 可选：通知应用重新打开日志（如支持 SIGUSR1/SIGUSR2 或自定义 reload 脚本）
            # kill -USR1 $(cat /var/run/yourapp.pid) 2>/dev/null || true
        endscript
    }

• 关键参数说明
  • daily：按天轮转。可以换成 hourly、weekly 或 monthly。
  • rotate N：保留N个历史日志副本。
  • compress / delaycompress：压缩旧日志。delaycompress 会延迟一次再压缩，避免影响对最新日志的读取。
  • missingok / notifempty：日志文件缺失或者为空时，不报错、不进行轮转。
  • create MODE OWNER GROUP：轮转后新建日志文件的权限、属主和属组。
  • postrotate … endscript：轮转后执行的钩子脚本。这里是关键——通常用来通知你的Node.js应用重新打开日志文件句柄。
• 测试与验证
  • 配置好了先别急着上线，测试一下：
    • 语法检查：sudo logrotate -d /etc/logrotate.d/yourapp
    • 强制执行（模拟轮转）：sudo logrotate -f /etc/logrotate.d/yourapp
  • 验证是否成功生成了类似 app.log.1.gz、app.log.2.gz 这样的归档文件，并且新的日志能正常写入到新的 app.log 中。
• 不中断写入的两种方式
  • 使用 copytruncate：先复制当前日志内容，然后清空原文件。这种方式不需要应用配合，适合那些无法接收信号重开日志的应用。

    /var/log/yourapp/*.log {
        daily
        rotate 7
        compress
        copytruncate
        missingok
        notifempty
    }

  • 使用 postrotate 发送信号：在钩子脚本里向应用进程发送特定信号（如SIGUSR1），要求它重新打开日志文件。这需要你的Node.js应用代码能够捕获并处理这个信号。

三 方案二 PM2 内置日志轮转

如果你的应用全程由PM2管理，那么用它的官方插件就是最丝滑的选择。

• 安装插件：一条命令搞定：pm2 install pm2-logrotate
• 常用配置：下面这组设置可以实现每天轮转、保留7天、并压缩旧日志。

  pm2 set pm2-logrotate:max_size 10M
  pm2 set pm2-logrotate:retain 7
  pm2 set pm2-logrotate:compress true
  pm2 set pm2-logrotate:rotateInterval “0 0 * * *”

• 验证与生效：执行 pm2 restart all 让配置生效。轮转后的日志默认存放在 ~/.pm2/logs/ 目录下。
• 适用说明：方案虽好，但只适用于PM2管理的应用。它的优势在于配置极其简单，与PM2生态无缝集成，运维成本低。

四 方案三 应用内轮转（winston/pino）

有时候，你需要更精细的控制，比如按日志文件大小和日期双重规则切割，或者想直接输出结构化的JSON日志并异步压缩。这时，在应用代码层面实现轮转就更灵活。

• 使用 winston + winston-daily-rotate-file

  const winston = require(‘winston’);
  const DailyRotateFile = require(‘winston-daily-rotate-file’);
  
  const transport = new DailyRotateFile({
      filename: ‘application-%DATE%.log’,
      datePattern: ‘YYYY-MM-DD’,
      zippedArchive: true,
      maxSize: ‘20m’,
      maxFiles: ‘14d’
  });
  
  const logger = winston.createLogger({
      level: ‘info’,
      format: winston.format.json(),
      transports: [transport]
  });
  
  logger.info(‘Hello, world!’);

• 使用 pino（示例）

  const pino = require(‘pino’);
  const rotate = require(‘pino-rotate’);
  
  const logger = pino({level: ‘info’});
  
  rotate({
      period: ‘1d’,
      path: ‘application.log’,
      size: ‘20m’,
      compress: true,
      rotate: true
  });
  
  logger.info(‘Hello, world!’);

• 适用说明：这种方式把控制权完全交给了应用本身，非常适合对日志格式、切割策略有定制化需求的场景。不过要特别注意文件句柄的释放和进程信号的处理，避免日志丢失。

五 容器与集中式日志实践

当应用跑在容器里，或者规模上去之后，日志管理又得有新思路。

• Docker 日志驱动
  • 可以利用Docker自带的 local 日志驱动，直接限制单个容器日志的大小和数量，这是防止容器日志“爆仓”的最基础防线。

    docker run -d \
        --name my_app \
        --log-driver local \
        --log-opt max-size=10m \
        --log-opt max-file=3 \
        my_image

• 集中式日志管理
  • 当服务器数量增多，或者你需要对日志进行搜索、分析和可视化时，就该考虑集中式日志方案了。业界常见的组合如ELK Stack（Elasticsearch, Logstash, Kibana）或者Graylog。这时，在应用层输出结构化的日志（比如JSON格式）会大大提升日志的“可观测性”，让后续分析事半功倍。