如何在Debian中集成Node.js日志工具

在Debian系统里集成Node.js日志工具，其实流程比想象中要直接。今天咱们就一步步把这个过程走通，顺便聊聊实际部署时的一些小门道。

1. 安装Node.js

第一步当然是确保系统里有Node.js环境。如果你的Debian还没装，直接跑下面两条命令就行：

sudo apt update
sudo apt install nodejs npm

这里多说一句：apt源里的Node.js版本可能不是最新的，但日常开发够用。如果对版本有特别要求，可以用nvm装指定版本，不过那就是另一话题了。

2. 选一个趁手的日志工具

Node.js社区里日志库不少，像winston、morgan、pino都是热门选手。今天拿winston演示，因为它功能全面、配置灵活，适合从开发到生产环境的过渡。

3. 安装 winston

用npm一把梭：

npm install winston

4. 配置 winston

建一个专门的日志配置文件，比如logger.js，把输出来源、格式和存储策略都定义好：

const winston = require('winston');

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

if (process.env.NODE_ENV !== 'production') {
  logger.add(new winston.transports.Console({
    format: winston.format.simple()
  }));
}

module.exports = logger;

注意这里的小心思：生产环境下只写文件、不打印到控制台，避免日志刷屏；开发环境则输出到终端，方便调试。

5. 在应用里用起来

假设你有一个Express应用，引入刚才的logger，在请求处理和错误捕获时打点日志：

const express = require('express');
const logger = require('./logger');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  logger.info('Hello World!');
  res.send('Hello World!');
});

app.use((err, req, res, next) => {
  logger.error(err.stack);
  res.status(500).send('Something broke!');
});

app.listen(port, () => {
  logger.info(`App listening at http://localhost:${port}`);
});

6. 启动并检查日志

直接运行node app.js，然后在应用根目录下就能看到error.log和combined.log两个文件。访问几次接口，日志内容就写进去了。

7. 别忘了日志轮转

日志文件如果不加管理，迟早会撑爆磁盘。推荐配合logrotate来做自动轮转和清理。

先安装它：

sudo apt install logrotate

然后创建配置文件，比如/etc/logrotate.d/nodejs：

/path/to/your/nodejs/app/*.log {
    daily
    missingok
    rotate 7
    compress
    notifempty
    create 640 root adm
}

这里配置的意思是：每天轮转一次，保留最近7天的日志，旧日志压缩存档，如果文件为空就不轮转。权限设置为640，避免被无关用户读取。

走完以上几步，你的Debian系统上就已经集成好了Node.js日志工具winston，并且有了基本的日志管理和监控能力。往后排查问题、跟踪请求，就清晰多了。