Debian系统Node.js日志清理方法

说起Node.js服务在Debian系统上的运维，日志管理绝对是绕不开的一环。日志越积越多，磁盘空间吃紧，排查问题的时候又得靠它，所以掌握一套靠谱的清理策略，算得上是基本功了。下面直接进入正题，聊聊几种常见且有效的做法。

几种主流的清理思路

先做个全景式的梳理，心里有个底。

• 手动清理：最直接的办法，找到日志文件，删掉或者挪走。适合临时救急，或者第一次摸清日志在哪儿。
• logrotate系统轮转：Debian自带的日志管理神器。按时间或大小自动切分、压缩、清理旧文件。一旦配好，生产环境就能长期省心。
• Node.js日志库轮转：在应用代码里直接用winston、pino这类日志库的轮转功能。跟进程的生命周期绑定得很紧，控制粒度更细。
• 定时任务脚本兜底：用cron或者自己写个Node脚本，定期扫一遍目录，把超时的日志干掉。简单粗暴，适合作为最后的防线。

先说说手动清理这回事

所谓手动清理，直白地说就是自己动手，找到日志文件，该删删，该备份备份。

• 找文件：日志通常住在/var/log/下，或者你的应用目录里（比如/opt/nodeapp/），文件名一般叫app.log、access.log、error.log这类。
• 备份与删除：
  • 备份命令示例：sudo cp /path/to/app.log /path/to/backup/app.log.bak
  • 删除命令示例：sudo rm /path/to/app.log
• 安全提醒：动手之前，先确认日志文件没有被进程占用着写。清理完后，最好通知应用重新打开日志文件——重启服务或者发个信号都行，否则应用可能继续写那个已经不存在的文件。

生产环境首选：logrotate系统轮转

如果不想隔三差五手动折腾，logrotate这个Debian自带的轮转工具，就非常香了。它由系统定时任务驱动，一旦配好，基本能自动运转。

• 安装与准备：Debian通常自带logrotate，万一没有，一句命令搞定：sudo apt-get update && sudo apt-get install logrotate
• 创建配置：在/etc/logrotate.d/下新建一个文件，比如叫nodejs，写入配置。
  下面是一个按天轮转、保留7天、启用压缩、忽略缺失文件、空文件不轮转、并自动创建新文件的示例：

  /var/log/nodejs/*.log {
      daily
      rotate 7
      compress
      missingok
      notifempty
      create 0640 root adm
  }

• 测试与生效：
  • 先演练一下，看语法有没有问题：sudo logrotate -d /etc/logrotate.d/nodejs
  • 确认无误后，可以强制执行一次看看效果：sudo logrotate -f /etc/logrotate.d/nodejs
• 注意：logrotate由系统定时任务自动调用，配置好之后无需额外重启服务，非常省心。

应用层精细化控制：Node.js日志库轮转

不少开发者在应用内部，就喜欢直接用winston、pino这些日志库自带的轮转功能。好处是跟代码逻辑完全绑定，控制起来更灵活。

• 使用winston按大小轮转：比如限制单个日志文件最大10MB，最多保留10个备份文件：

  const winston = require('winston');
  const logger = winston.createLogger({
    level: 'info',
    format: winston.format.json(),
    transports: [
      new winston.transports.File({
        filename: '/var/log/nodejs/app.log',
        maxsize: 10 * 1024 * 1024, // 10MB
        maxFiles: 10
      })
    ]
  });
  if (process.env.NODE_ENV !== 'production') {
    logger.add(new winston.transports.Console({ format: winston.format.simple() }));
  }

• 使用winston-daily-rotate-file按日期轮转：按天切分，自动压缩，保留14天内的日志：

  const winston = require('winston');
  const DailyRotateFile = require('winston-daily-rotate-file');
  const logger = winston.createLogger({
    level: 'info',
    transports: [
      new DailyRotateFile({
        filename: '/var/log/nodejs/app-%DATE%.log',
        datePattern: 'YYYY-MM-DD',
        zippedArchive: true,
        maxSize: '20m',
        maxFiles: '14d'
      })
    ]
  });

• 一点提醒：按日期命名文件时，日志清理由库自动处理；按大小轮转时，结合maxFiles控制保留数量即可。

最后一道防线：定时任务脚本兜底

无论logrotate还是日志库轮转，都有可能出现配置遗漏或意外失效的情况。作为最后一道防线，我们可以用cron定时任务或者自己写个Node脚本，定期扫一遍目录把过期的日志给清掉。

• cron定时删除：比如每天凌晨1点，删除7天前的.log文件：

  0 1 * * * find /path/to/nodejs/logs -type f -name "*.log" -mtime +7 -exec rm {} \;

• 写一个Node.js清理脚本：逻辑更灵活，比如按文件的最后修改时间来判断：

  const fs = require('fs').promises;
  const path = require('path');
  const logsDir = '/path/to/nodejs/logs';
  const cutoff = Date.now() - 7 * 24 * 60 * 60 * 1000;
  (async () => {
    const files = await fs.readdir(logsDir);
    for (const f of files) {
      const fp = path.join(logsDir, f);
      const st = await fs.stat(fp);
      if (st.isFile() && st.mtimeMs < cutoff) await fs.unlink(fp);
    }
  })().catch(console.error);

• 建议：把这个脚本加进cron定期执行，相当于给日志清理上了双保险——系统轮转和库轮转万一没搞定，这个兜底方案也能确保日志不会无限制膨胀下去。