如何实现点击网页HTML按钮打开PuTTY会话并执行用户输入的指定命令？

阿华AIGC实验室

2026-4-28

How to Trigger PuTTY/Plink to Run a User-Input Command from a Web Button

Got it, let's tackle this problem head-on. First, a critical note: plain HTML/JS in a standard browser can't directly launch local programs like PuTTY—browsers block this for security reasons. But there are workarounds that let you bridge the web interface to your local system, depending on your use case.

Option 1: Custom URL Protocol (Best for Desktop Environments)

This involves registering a custom protocol with your OS (Windows, since PuTTY is commonly used there) that tells the system to launch Plink (PuTTY's command-line sibling, better suited for running commands) when the protocol is triggered.

Step 1: Register the Custom Protocol in Windows Registry

Create a .reg file with this content, adjust paths to match where plink.exe is installed on your system:

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\puttycmd]
@="URL:PuTTY Command Protocol"
"URL Protocol"=""

[HKEY_CLASSES_ROOT\puttycmd\shell]
@=""

[HKEY_CLASSES_ROOT\puttycmd\shell\open]
@=""

[HKEY_CLASSES_ROOT\puttycmd\shell\open\command]
@="\"C:\\Program Files\\PuTTY\\plink.exe\" -ssh user@your-server -pw your-password %1"

Important: Replace user@your-server and your-password with your default SSH credentials, or adjust the command to accept dynamic parameters (we'll handle that next). Double-check the path to plink.exe—it might be in C:\Program Files (x86)\PuTTY\ on 64-bit systems.

Run the .reg file to add the registry entries.

Step 2: Web Interface to Trigger the Protocol

Create an HTML page with a text input for the command and a button to launch Plink:

<!DOCTYPE html>
<html>
<body>
  <label for="commandInput">Enter command to run:</label>
  <input type="text" id="commandInput" placeholder="e.g., ls -l">
  <button onclick="runPuTTYCommand()">Execute in PuTTY</button>

  <script>
    function runPuTTYCommand() {
      const command = document.getElementById('commandInput').value;
      if (!command) {
        alert('Please enter a command first!');
        return;
      }
      // Encode the command to make it URL-safe
      const encodedCommand = encodeURIComponent(command);
      // Trigger the custom protocol
      window.location.href = `puttycmd:${encodedCommand}`;
    }
  </script>
</body>
</html>

Note: Windows doesn't support process substitution for passing commands directly, so we'll use a batch script to handle it. Update the registry's command key to:
@="\"C:\\path\\to\\run_putty_cmd.bat\" %1"
Then create run_putty_cmd.bat:
@echo off
setlocal enabledelayedexpansion
set "cmd=%~1"
set "tempfile=%temp%\putty_cmd.tmp"
echo !cmd! > !tempfile!
"C:\Program Files\PuTTY\plink.exe" -ssh user@your-server -pw your-password -m !tempfile!
del !tempfile!

Option 2: Package as an Electron Desktop App (Cross-Platform & More Control)

If you need this to work across Windows/macOS/Linux or want tighter integration, wrap your web interface in an Electron app. Electron lets you use Node.js to launch local programs directly.

Example Electron Setup

Initialize an Electron project, then create these files:

index.html (your web interface):

<!DOCTYPE html>
<html>
<body>
  <label for="commandInput">Enter command:</label>
  <input type="text" id="commandInput">
  <button onclick="window.electronAPI.runCommand()">Execute</button>
</body>
</html>

main.js (Electron main process):

const { app, BrowserWindow, ipcMain } = require('electron');
const { spawn } = require('child_process');
const path = require('path');

function createWindow() {
  const win = new BrowserWindow({
    width: 800,
    height: 600,
    webPreferences: {
      preload: path.join(__dirname, 'preload.js'),
      contextIsolation: true
    }
  });
  win.loadFile('index.html');
}

ipcMain.handle('run-command', async (event, command) => {
  if (!command) return;
  // Launch plink with the user's command
  spawn('plink.exe', ['-ssh', 'user@your-server', '-pw', 'your-password', command], {
    stdio: 'inherit' // Show the plink window/output
  });
});

app.whenReady().then(createWindow);

preload.js (Bridge between renderer and main process):

const { contextBridge, ipcRenderer } = require('electron');

contextBridge.exposeInMainWorld('electronAPI', {
  runCommand: () => {
    const command = document.getElementById('commandInput').value;
    ipcRenderer.invoke('run-command', command);
  }
});

Important Security Notes

Custom URL protocols can be abused if not restricted—only use this in a trusted, internal environment.
Hardcoding passwords in registry/batch files is bad practice. Consider using PuTTY's saved sessions instead (replace the plink command with -load "SavedSessionName" to use stored credentials).
Plink will show a security prompt the first time connecting to a new server—you can pre-accept the host key with plink.exe -ssh user@host -pw password -batch once to avoid this.

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