如何在Ubuntu中设置Node.js日志

在 Ubuntu 中设置 Node.js 日志的完整实践

一 基础方案选择

面对日志记录，开发者通常有几个清晰的路径可选。首先，最直接的方式莫过于使用 Node.js 内置的 console.log、console.error 或 console.warn。这种方法在开发和调试阶段极其方便，所有信息直接输出到标准输出或标准错误流。不过，对于生产环境而言，它的功能就显得过于单一了。

因此，引入专业的日志库就成了更主流的选择。市面上有几个备受青睐的选项：

• winston：功能相当全面，支持多种传输方式（如控制台、文件、HTTP等），并且擅长处理结构化日志。
• morgan：如果你使用 Express 框架，它是记录 HTTP 请求日志的中间件不二之选，通常与文件流结合实现日志落盘。
• pino：以高性能著称，特别适合对性能敏感的生产环境。
• log4js：配置非常灵活，支持按文件大小或日期进行日志切分，并能同时输出到多个目的地。

除了在应用内做文章，还可以借助进程管理工具来接管日志。这里有两个重量级选手：

• PM2：它内置了日志管理功能，可以轻松合并或分离标准输出与错误输出，并支持按应用查看日志。
• systemd：这是系统级的方案。通过它将应用日志接入 journald 或 syslog，可以实现系统级的集中查看、管理和自动轮转，非常规范。

二 应用内日志配置示例

理论说完了，来看看具体怎么实现。下面通过几个典型库的配置，让你快速上手。

使用 winston 输出到控制台与文件（按级别分流）

首先，安装 winston：npm install winston

接着，创建一个灵活的日志记录器，让它根据环境决定输出目的地：

const winston = require('winston');
const logger = winston.createLogger({
  level: process.env.LOG_LEVEL || 'info',
  format: winston.format.combine(
    winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
    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()
  }));
}

logger.info('Hello World');
logger.error('Something went wrong');

这个配置的精妙之处在于，它将错误级别及以上的日志单独写入 error.log，所有日志同时写入 combined.log，并且在非生产环境还会在控制台输出简化格式的日志。要动态调整日志级别？很简单，通过环境变量即可：LOG_LEVEL=debug node app.js。

使用 morgan 记录 Express HTTP 请求日志到文件

对于 Web 应用，HTTP 访问日志至关重要。morgan 中间件可以优雅地完成这个任务。先安装：npm install morgan

然后，将其集成到 Express 应用中，并将日志写入文件：

const express = require('express');
const morgan = require('morgan');
const fs = require('fs');
const path = require('path');

const accessLogStream = fs.createWriteStream(
  path.join(__dirname, 'access.log'),
  { flags: 'a' }
);

const app = express();
app.use(morgan('combined', { stream: accessLogStream }));

app.get('/', (req, res) => res.send('Hello World'));
app.listen(3000, () => console.log('Server on 3000'));

这里有个小建议：在生产环境中，最好将这类访问日志与你的业务逻辑日志分离开来。这样一来，无论是排查问题还是进行安全审计，都会清晰得多。

使用 log4js 按类别与日期切分输出

如果你需要更精细的日志管理策略，比如按日期或文件大小自动切割归档，log4js 是个强大的选择。安装命令：npm install log4js

它的配置看起来稍微复杂一些，但带来的控制力是值得的：

const log4js = require('log4js');
const path = require('path');

log4js.configure({
  appenders: {
    console: { type: 'console' },
    file: {
      type: 'file',
      filename: path.join(__dirname, 'logs', 'app.log'),
      maxLogSize: 10 * 1024 * 1024, // 10MB
      backups: 5,
      encoding: 'utf-8'
    },
    dateFile: {
      type: 'dateFile',
      filename: path.join(__dirname, 'logs', 'app'),
      pattern: '.yyyy-MM-dd.log',
      alwaysIncludePattern: true,
      compress: true
    }
  },
  categories: {
    default: { appenders: ['console', 'file', 'dateFile'], level: 'debug' }
  }
});

const logger = log4js.getLogger();
logger.info('Hello log4js');
logger.error('Oops');

这个配置同时启用了三种输出：控制台、按大小轮转的文件（app.log）以及按日期轮转并压缩的文件（如 app.2023-10-27.log.gz）。log4js 支持的 appender 类型很丰富，你可以根据实际需求自由组合。

三 运行方式与系统日志集成

应用写好了，怎么运行和管理它的日志呢？这里介绍两种系统级的方案。

使用 PM2 管理进程与日志

PM2 不仅是进程守护工具，它的日志管理功能也非常贴心。全局安装：npm install -g pm2

启动你的应用：pm2 start app.js --name my-app

查看日志变得异常简单：

• pm2 logs my-app：实时查看所有日志。
• pm2 logs my-app --err：只看错误日志。
• pm2 logs my-app --out：只看标准输出日志。

默认情况下，日志会存放在 ~/.pm2/logs/ 目录下。你还可以通过 ecosystem.config.js 文件进行更个性化的配置，比如指定自定义的日志路径：

module.exports = {
  apps: [{
    name: 'my-app',
    script: 'app.js',
    out_file: 'logs/out.log',
    error_file: 'logs/err.log',
    combine_logs: false
  }]
};

使用 systemd 将日志写入 journald/syslog

对于追求标准化和与操作系统深度集成的场景，systemd 是首选。首先，创建一个服务文件 /etc/systemd/system/myapp.service：

[Unit]
Description=My Node.js App
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/myapp
ExecStart=/usr/bin/node /opt/myapp/app.js
Restart=always
StandardOutput=journal
StandardError=journal
SyslogIdentifier=myapp

[Install]
WantedBy=multi-user.target

创建完成后，执行以下命令启用并启动服务：

• sudo systemctl daemon-reload && sudo systemctl enable --now myapp

之后，就可以使用强大的 journalctl 命令来查看日志了：

• journalctl -u myapp -f：实时跟踪日志。
• journalctl -u myapp --since "2025-12-11 00:00:00"：查看指定时间之后的日志。

这样一来，你的应用日志就完全融入了系统的日志体系，可以利用 systemd 提供的所有查询、过滤和轮转机制。当然，你也可以将 StandardOutput 和 StandardError 设置为 syslog，并配合 SyslogIdentifier 来使用传统的 syslog 服务。

四 日志轮转与保留策略

日志文件会不断增长，如果不加管理，迟早会撑满磁盘。因此，制定日志轮转和保留策略是生产环境的必修课。

使用 logrotate（系统级，推荐与文件日志搭配）

logrotate 是 Linux 系统自带的日志轮转工具，稳定可靠。为你的应用创建一个配置文件，比如 /etc/logrotate.d/myapp：

/opt/myapp/logs/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 640 www-data www-data
    copytruncate
}

这个配置的意思是：

• daily：每天轮转一次。
• rotate 14：保留最近14天的日志文件。
• compress：轮转后的旧日志进行压缩以节省空间。
• copytruncate：这是一个关键选项。它先复制当前日志文件，然后清空原文件，而不是移动后重新创建。这对于那些不支持接收信号重新打开日志文件句柄的应用程序（比如一些简单的 Node.js 脚本）非常友好。

配置好后，可以先用 sudo logrotate -d /etc/logrotate.d/myapp 测试语法，确认无误后用 sudo logrotate -f /etc/logrotate.d/myapp 强制执行一次轮转。

使用 winston-daily-rotate-file（应用内轮转）

如果你希望轮转逻辑完全由应用自身控制，可以使用 winston 的配套插件。安装：npm install winston-daily-rotate-file

配置示例如下：

const DailyRotateFile = require('winston-daily-rotate-file');
const transport = new DailyRotateFile({
  filename: 'logs/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,
    new winston.transports.Console({ format: winston.format.simple() })
  ]
});

这个配置实现了按日期（每天）和文件大小（20MB）双重条件进行日志切分，自动压缩归档，并且只保留最近14天的日志文件。应用内轮转的好处是策略更灵活，不依赖系统工具。

五 生产环境建议

最后，分享几个让日志系统更健壮的生产环境实践心得：

• 明确日志级别：规范使用 error、warn、info、debug 等级别。并通过环境变量（如 LOG_LEVEL）来动态切换，确保生产环境不会输出海量的 debug 信息。
• 采用结构化日志：输出 JSON 格式的日志。每条日志都带上时间戳、级别、服务名等统一字段，这样后续无论是用 ELK 还是其他工具进行检索、聚合和分析，效率都会高得多。
• 分离日志流：将 HTTP 访问日志、业务逻辑日志、错误日志分开记录。这就像把工具分门别类放好，审计和排查问题时能快速定位。
• 管理目录与权限：规划好统一的日志目录（如 /var/log/myapp/），并确保运行应用的用户（如 www-data）对该目录有写入权限。
• 制定保留策略：根据磁盘空间和合规要求，配置合理的日志保留周期（如30天）和压缩策略，这是防止磁盘被意外撑满的基本保障。
• 考虑集中式日志：当服务增多后，登录每台服务器看日志会成为噩梦。此时，将日志统一发送到 ELK Stack（Elasticsearch, Logstash, Kibana）或 Graylog 这样的集中式日志平台，实现统一的检索、可视化展示和告警，是必然的选择。