如何在Ubuntu中配置Node.js日志输出

在Ubuntu上跑Node.js应用，日志配置是个绕不开的话题。很多人一开始直接用console.log凑合，但等应用上了生产环境，日志管理就成了刚需——不仅要能记录，还得方便排查、轮转归档。下面从最基础的方法说起，逐步深入到工业级方案。

使用内置的console模块

Node.js自带的console模块是入门最简单的选择。直接用console.log、console.error就能输出到标准输出和错误流。比如下面这段Express示例：

const express = require('express');
const app = express();

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

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

这种做法适合快速原型或开发阶段，但一旦需要更细粒度的控制——比如分级别记录、输出到文件、日志轮转——就得请出第三方库了。

使用第三方日志库

Winston

winston 是目前社区最成熟的日志库之一，支持多种传输通道（控制台、文件、HTTP等），配置灵活。首先安装：

npm install winston

然后创建一个logger实例，根据环境动态调整输出方式：

const express = require('express');
const winston = require('winston');
const app = express();

// 创建logger实例
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.Console(),
    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()
  }));
}

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

app.listen(3000, () => {
  logger.info('Server is running on port 3000');
});

上面的配置把错误日志单独写入error.log，所有日志放入combined.log，同时控制台也会输出。这样既不影响生产环境性能，又保留了调试阶段的可见性。

Morgan

如果用的是Express框架，morgan 是专门处理HTTP请求日志的中间件，开箱即用。安装：

npm install morgan

挂载到Express应用上，就可以自动记录每个请求的详细信息：

const express = require('express');
const morgan = require('morgan');
const app = express();

// 使用'combined'格式（Apache风格）
app.use(morgan('combined'));

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

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

morgan 输出格式有多种选择，比如dev、short、combined，可以根据场景灵活切换。它和winston可以配合使用——用morgan记录请求，用winston记录应用内部事件。

配置日志轮转

日志文件如果不做轮转，很快就会撑爆磁盘。好在winston生态里有个专门的轮转插件——winston-daily-rotate-file。安装：

npm install winston-daily-rotate-file

配置时，指定文件名模板、日期格式、最大文件大小和保留天数，就能自动按小时/天切分文件，并压缩历史日志：

const express = require('express');
const winston = require('winston');
const { createLogger, format, transports } = winston;
const DailyRotateFile = require('winston-daily-rotate-file');
const app = express();

// 创建logger实例
const logger = createLogger({
  level: 'info',
  format: format.combine(
    format.timestamp(),
    format.json()
  ),
  transports: [
    new transports.Console(),
    new DailyRotateFile({
      filename: 'application-%DATE%.log',
      datePattern: 'YYYY-MM-DD-HH',
      zippedArchive: true,
      maxSize: '20m',
      maxFiles: '14d'
    })
  ]
});

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

app.listen(3000, () => {
  logger.info('Server is running on port 3000');
});

这里的关键参数：datePattern 设为小时级别，每小时的日志独立成文件；maxSize 限制单个文件20MB，超了就自动切分；maxFiles 保留14天，旧日志自动删除，同时开启zippedArchive压缩归档。这样既保证了磁盘空间可控，又方便按时间范围检索日志。

以上几种方法覆盖了从简单到复杂的日志配置场景。实际生产环境中，建议组合使用winston+morgan+日志轮转，既能捕获应用内部异常，又能记录完整的HTTP请求链路。配置完成后，别忘了在Ubuntu上用logrotate或系统服务管理工具做好日志的定期清理，双重保险更稳妥。