在Debian上跑Node.js应用，日志配置是个绕不开的话题。虽然方法不少，但选对路子能让后续维护省心很多。下面从最简单的内置方案讲起，再到生产环境常用的专业工具，一步步来。

1. 使用内置的console.log

开发调试阶段，最直接的方法就是Node.js自带的console.log。简单粗暴，拿来就用，适合快速验证逻辑。

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

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

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

但这种方式的局限性也很明显：日志格式单一，无法分级，也不方便持久化存储。生产环境基本不会这么用。

2. 使用日志库

当应用规模变大，对日志的管控需求就上来了。这时候第三方日志库就成了刚需，比如winston和pino，它们各自有鲜明的特点。

使用winston

winston功能全面，支持多种传输方式——控制台、文件、HTTP等，几乎能满足所有场景。先装包：

npm install winston

然后配置一个logger实例，可以同时输出到不同目的地：

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

// 配置winston
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('Request received at', new Date());
  res.send('Hello World!');
});

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

这段代码里，error.log只记录错误级别日志，combined.log记录所有级别。非生产环境还在控制台输出简化格式，便于实时查看。

使用pino

如果对性能有极致要求，pino是不二之选。它的设计目标就是快，生产环境下尤其突出。安装：

npm install pino

使用方式同样简洁：

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

// 配置pino
const logger = pino({
  level: 'info'
});

app.get('/', (req, res) => {
  logger.info('Request received at', { timestamp: new Date() });
  res.send('Hello World!');
});

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

pino默认输出JSON格式，便于后续传输到日志收集系统。它的吞吐量远高于winston，但功能相对精简——取舍之间，看具体需求。

3. 使用系统日志

有些场景下，希望Node.js的日志直接汇入系统日志服务（比如syslog），方便统一管理。可以用winston-syslog这个传输插件来实现。

安装：

npm install winston-syslog

配置示例：

const express = require('express');
const winston = require('winston');
const SyslogTransport = require('winston-syslog').SyslogTransport;
const app = express();

// 配置winston
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new SyslogTransport({
      host: 'localhost',
      port: 514,
      protocol: 'udp4'
    })
  ]
});

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

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

这样日志就会发送到本机的syslog服务，与其他系统日志统一归档。当然，前提是系统里已经配置并运行了syslog守护进程。

4. 使用环境变量配置日志级别

开发、测试、生产环境需要的日志粒度往往不同。通过环境变量动态控制日志级别，是最灵活的做法。比如：

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

// 配置winston
const logger = winston.createLogger({
  level: process.env.LOG_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' })
  ]
});

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

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

启动时设置LOG_LEVEL=debug，就能看到更详细的调试信息；生产环境默认info，避免日志刷屏。这个技巧在容器化部署时尤其有用。

以上几种方法覆盖了从简单到复杂的日志配置场景。在Debian系统上，根据应用的规模、性能和运维需求选择合适方案，就能把日志这件事管得明明白白。