Linux 下使用 Node.js 執行系統命令的實戰指南

Node.js 不僅能構建高性能 Web 服務，其 child_process 模組還能讓 JavaScript 直接調用 Linux Shell 命令，實現自動化運維、文件處理、進程管理等任務。本文通過實例詳解 exec、execFile、spawn 三種核心 API 的用法與區別。

核心 API 對比

實例 1：使用 exec 執行 Shell 命令

const { exec } = require('child_process');

exec('pwd', (error, stdout, stderr) => {
  if (error) {
    console.error(`執行錯誤: ${error}`);
    return;
  }
  console.log(`標準輸出: ${stdout}`);
  console.error(`標準錯誤: ${stderr}`);
});

注意：exec 默認使用 /bin/sh 解析命令，支持管道、重定向等 Shell 特性，但需防範命令注入（避免拼接不可信輸入）。

實例 2：使用 execFile 直接運行腳本/程序

const { execFile } = require('child_process');

// 執行 Shell 腳本
execFile('./deploy.sh', ['prod'], (error, stdout, stderr) => {
  if (error) throw error;
  console.log('部署輸出:', stdout);
});

// 執行二進制程序（如壓縮）
execFile('tar', ['-czf', 'backup.tar.gz', '/var/www'], (err, out, errout) => {
  if (err) console.error('壓縮失敗:', err);
  else console.log('壓縮完成');
});

優勢：繞過 Shell，參數以數組傳遞，安全性更高；適用於已知路徑的腳本或二進制文件。

實例 3：使用 spawn 處理大數據流（如日志實時讀取）

const { spawn } = require('child_process');

const tail = spawn('tail', ['-f', '/var/log/nginx/access.log']);

tail.stdout.on('data', (chunk) => {
  process.stdout.write(`[實時日志] ${chunk}`);
});

tail.stderr.on('data', (data) => {
  console.error(`tail 錯誤: ${data}`);
});

tail.on('close', (code) => {
  console.log(`進程退出碼: ${code}`);
});

關鍵點：spawn 返回流對象，適合持續輸出的命令（tail -f、ping、視頻轉碼等），避免緩衝區溢出。

進階：封裝通用命令執行模組

// utils/cmd.js
const { exec, spawn } = require('child_process');

/** 返回 Promise 的 exec 封裝 */
function runCmd(cmd, options = {}) {
  return new Promise((resolve, reject) => {
    exec(cmd, options, (err, stdout, stderr) => {
      if (err) reject({ err, stdout, stderr });
      else resolve({ stdout, stderr });
    });
  });
}

/** 流式輸出封裝 */
function streamCmd(cmd, args, onData) {
  const proc = spawn(cmd, args);
  proc.stdout.on('data', onData);
  return new Promise((resolve) => proc.on('close', resolve));
}

module.exports = { runCmd, streamCmd };

安全最佳實踐

• 嚴禁拼接用戶輸入：使用 execFile 或 spawn 的數組參數形式。
• 設置超時與資源限制：exec(cmd, { timeout: 5000, maxBuffer: 1024*1024 })。
• 最小權限原則：Node 進程勿以 root 運行；敏感操作通過 sudoers 免密執行特定命令。
• 輸入驗證與轉義：若必須用 exec，對參數進行 shell-escape 處理。

掌握 Node.js 執行系統命令的各種姿勢，能讓前端工程師、全棧開發者輕鬆實現自動化部署、服務器監控、文件批量處理等運維任務，極大提升開發效率。