萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 監聽 Unix Domain Socket (sock 文件) 實現進程間通信

Node.js 的 HTTP/TCP 服務可監聽 Unix Domain Socket 文件,而非 TCP 端口。適用於同機器進程間高性能通信(如 Nginx 反向代理到 Node.sock),避免端口佔用與網絡棧開銷。

TCP Server 監聽 Sock 文件

const net = require('net');

const server = net.createServer((socket) => {
  socket.on('data', (data) => {
    console.log('收到:', data.toString());
    socket.write('Echo: ' + data);
  });
  socket.on('error', (err) => console.error('Socket error:', err));
});

const sockPath = '/tmp/node_tcp.sock';

// 清理舊 sock 文件
const fs = require('fs');
if (fs.existsSync(sockPath)) fs.unlinkSync(sockPath);

server.listen(sockPath, () => {
  console.log('TCP Server listening on', sockPath);
  // 設置權限允許其他進程連接
  fs.chmodSync(sockPath, '0o666');
});

客戶端連接測試

// 命令行測試
// telnet /tmp/node_tcp.sock  (需 socat 或支持 Unix socket 的 telnet)
// 或使用 nc (netcat)
// nc -U /tmp/node_tcp.sock

// Node.js 客戶端
const client = net.connect('/tmp/node_tcp.sock', () => {
  client.write('Hello from client!');
});
client.on('data', (data) => console.log('Server reply:', data.toString()));

HTTP Server 監聽 Sock 文件

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello via Unix Socket\n');
});

server.listen('/tmp/node_http.sock', () => {
  console.log('HTTP Server on /tmp/node_http.sock');
  fs.chmodSync('/tmp/node_http.sock', '0o666');
});

HTTP 客戶端訪問 Sock

const http = require('http');

const options = {
  socketPath: '/tmp/node_http.sock',
  method: 'GET',
  path: '/'
};

const req = http.request(options, (res) => {
  console.log('STATUS:', res.statusCode);
  console.log('HEADERS:', res.headers);
  res.on('data', (chunk) => console.log('BODY:', chunk.toString()));
});
req.end();

Nginx 反向代理配置(生產常用)

upstream node_backend {
  server unix:/tmp/node_http.sock fail_timeout=0;
}

server {
  listen 80;
  server_name example.com;
  
  location / {
    proxy_pass https://node_backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

優勢與注意事項

  • 性能: 繞過 TCP/IP 協議棧,延遲更低、吞吐更高。
  • 安全: 文件系統權限控制訪問,不暴露網絡端口。
  • 權限: 需確保 sock 文件權限允許 Nginx/客戶端進程讀寫(chmod 666 或同用戶組)。
  • 清理: 進程退出時需 fs.unlinkSync(sockPath),否則重啟報 EADDRINUSE。
  • Windows 支持: Node.js 10+ 支持 Windows Named Pipes (\\.\pipe\name),路徑格式不同。
copyright © 萬盛學電腦網 all rights reserved