remote-exec-v2

remote-exec-v2 is a modern Node.js package that allows executing commands over SSH on multiple servers. It enhances automation while being careful with dangerous operations.

Why remote-exec-v2?

Thanks to https://github.com/tpresley/node-remote-exec, which inspired this project. However, that package has not been updated for years and cannot connect to newer OpenSSH servers (v8.8+). remote-exec-v2 is a fresh alternative with updated features.

Runtime

Developed and tested with:

• Node.js v22.11.0
• macOS 15.1

Other platforms are not officially tested yet.

Features

• Execute commands on multiple remote hosts via SSH
• Automatically skips dangerous commands (e.g., rm -rf /, shutdown)
• Sequential or parallel execution mode
• Force execution of risky commands (optional)
• Supports custom encoding (e.g., GBK for Windows)
• Optional timestamped output and detailed logging

Installation

npm install remote-exec-v2

Usage

const remoteExec = require("remote-exec-v2");

const hosts = [
  { host: "192.168.0.101", name: "Server-A", encoding: "gbk" },
  { host: "192.168.0.102", name: "Server-B" }
];

// or hosts in simple way
// const hosts = ["192.168.0.101","192.168.0.12"];

const commands = [
  "echo Hello World",
  "dir /w",
  "rm -rf /important" // this will be skipped unless force: true
];

const options = {
  force: false,      // Skip risky commands (default)
  timestamp: true,   // Show timestamps and host names
  parallel: false    // Run sequentially
};

remoteExec(hosts, commands, options, (err) => {
  if (err) {
    console.error("Error during execution:", err);
  } else {
    console.log("Commands executed successfully on all hosts.");
  }
});

Options

| Option | Type | Default | Description | | -------------- | ---------------- | ----------------- | ------------------------------------------------ | | port | number | 22 | SSH port | | username | string | "root" | SSH username | | privateKey | string or Buffer | ~/.ssh/id_rsa | Path or buffer of private key | | encoding | string or null | null | Remote system output encoding (e.g.,"gbk") | | force | boolean | false | Allow execution of risky commands | | parallel | boolean | false | Run all hosts in parallel | | timestamp | boolean | false | Show detailed logs with timestamps and hostnames |

Risky Commands

The following commands are considered risky and will be skipped unless force: true:

• rm
• rmdir
• del
• rimraf
• rm -rf
• shutdown
• reboot
• mkfs
• dd if=
• chmod 777 /
• chown root
• kill -9 -1
• mv /
• cp /
• del /f /s /q
• format
• netsh advfirewall reset
• netsh firewall
• erase /f
• rd /s /q
• taskkill /F /IM
• reg delete
• sc stop
• sc delete

Contributing

Thanks to https://openai.com/ (ChatGPT) for code generation assistance.

If you want to contribute, feel free to fork the repository and create a pull request.

License

MIT License """