如何为Node.js Windows服务添加状态显示的系统托盘图标？

Windows服务运行在会话0，而系统托盘属于当前登录用户的交互会话（通常是会话1及以上），这就是你用普通systray包看不到图标的核心原因——服务进程无法直接在用户会话创建UI元素。

正确的实现方式是拆分两个进程：

• 后台服务进程：负责原本的业务逻辑，运行在会话0
• 独立托盘进程：运行在用户交互会话，负责显示托盘图标并接收服务状态更新

步骤1：实现托盘进程（基于systray包） #

先安装依赖：

npm install systray

托盘进程代码（tray.js）：

const Systray = require('systray').default;
const net = require('net');

// 准备图标（用base64嵌入，避免路径依赖，可在线转换PNG为base64）
const greenIcon = 'data:image/png;base64,替换为绿色圆点图标的base64编码';
const redIcon = 'data:image/png;base64,替换为红色圆点图标的base64编码';

const systrayConfig = {
  menu: {
    icon: redIcon, // 默认显示停止状态
    title: '服务状态',
    items: [
      { title: '退出', tooltip: '退出托盘监控', checked: false, enabled: true }
    ]
  },
  debug: false,
  copyDir: true // 复制依赖到临时目录，避免权限问题
};

const systray = new Systray(systrayConfig);

// 监听服务状态的IPC连接（Windows命名管道）
const server = net.createServer(socket => {
  socket.on('data', data => {
    const status = data.toString().trim();
    systray.update({
      ...systrayConfig.menu,
      icon: status === 'running' ? greenIcon : redIcon,
      title: status === 'running' ? '服务运行中' : '服务已停止'
    });
  });
});

server.listen('\\\\.\\pipe\\service-status-pipe');

systray.on('click', action => {
  if (action.item.title === '退出') {
    server.close();
    systray.kill();
    process.exit(0);
  }
});

步骤2：修改Windows服务进程，启动托盘并发送状态 #

服务进程需要在启动时启动托盘进程（确保在用户会话），并通过命名管道发送状态更新。如果服务使用LocalSystem账户，可借助node-win32-api调用CreateProcessAsUser将托盘进程启动到当前登录用户的会话。

服务进程核心代码片段：

const { spawn } = require('child_process');
const net = require('net');
const service = require('你的服务框架，如node-windows');

// 启动托盘进程
function startTrayProcess() {
  const trayProcess = spawn('node', ['tray.js'], {
    detached: true,
    stdio: 'ignore'
  });
  trayProcess.unref();
}

// 发送状态到托盘
function sendStatusToTray(status) {
  const client = net.connect('\\\\.\\pipe\\service-status-pipe');
  client.write(status);
  client.end();
}

// 服务启动逻辑
service.on('start', () => {
  startTrayProcess();
  sendStatusToTray('running');
  // 你的业务逻辑...
});

// 服务停止逻辑
service.on('stop', () => {
  sendStatusToTray('stopped');
  // 清理业务逻辑...
});

关键注意事项 #

• 会话隔离问题：必须确保托盘进程运行在用户的交互会话，直接在服务进程（会话0）创建托盘会因为无UI桌面而完全不可见。
• 图标资源：用base64嵌入图标可避免文件路径权限问题，无需额外管理图标文件。
• IPC通信：Windows命名管道是轻量化的进程间通信方式，也可替换为TCP socket、UDP等方案。

内容的提问来源于stack exchange，提问作者Shubham Chaudhary