主机台 HostConsole

Überlasse SSH der KI, aber behalte die Schlüssel in deiner Hand.

English · 简体中文

Eigenschaften · Screenshots · Schnellstart · KI anbinden · Sicherheitsmodell · Funktionsweise · FAQ

Warum HostConsole?

Du kennst das Dilemma: Du möchtest, dass die KI dir bei deinem NAS, Server oder Router hilft, aber SSH-Schlüssel und Passwörter direkt an einen KI-Client zu übergeben, fühlt sich nicht richtig an——

• Sobald der Schlüssel in die KI-Konfiguration eingefügt ist, hast du die gesamte Maschine übergeben, ohne zu wissen, wo er protokolliert wird;

• Der KI einen temporären öffentlichen Schlüssel zu generieren und in authorized_keys einzutragen, muss nach der Nutzung wieder aufgeräumt werden – mühsam und leicht zu vergessen;

• Bei sudo-Befehlen der KI siehst du nicht, was sie ausführen will, geschweige denn, dass du es genehmigen könntest;

• Bei einem Wechsel des KI-Clients (Codex, OpenCode, ZCode……) muss der gesamte Autorisierungsprozess von vorn beginnen.

Die Antwort von HostConsole: Schlüssel verlassen niemals deinen Computer.

Du verbindest dich manuell per SSH in HostConsole (Passwort / privater Schlüssel, systemverschlüsselt gespeichert) und übergibst die „autorisierten Sitzungen" über die lokale MCP-Brücke an die KI. Die KI sieht nur den Sitzungsnamen (z. B. „Heim-NAS"), kann den Terminal bedienen und von dir jederzeit pausiert und getrennt werden – aber sie erhält niemals Adresse, Port, Benutzername oder privaten Schlüssel.

┌─────────────┐   SSH 凭据只到这里，加密保存    ┌──────────────┐
│   你本人     │ ────────────────────────────▶ │  你的 NAS /  │
│  (主机台 UI) │ ◀──────────────────────────── │   服务器      │
└──────┬──────┘        已建立的 SSH 会话        └──────────────┘
       │ 授权（相对安全 / 完全开放）
       ▼
┌──────────────┐  本机命名管道（不出网、不开端口） ┌─────────────┐
│  主机台 MCP   │ ◀──────────────────────────▶ │  AI Agent   │
│   桥接器      │      只传命令与输出、别名        │ Codex 等     │
└──────────────┘                                └─────────────┘

Related MCP server: SSH MCP Server

Anwendungsfälle

• 🏠 Heim-NAS / Heimserver: Lass die KI SMART-Status prüfen, Docker aufräumen, RAID-Warnungen beheben, ohne ihr Root-Rechte zu geben

• 🖥️ Persönlicher VPS / Entwicklungsrechner: Deployment, Logs ansehen, nginx-Konfiguration ändern – die KI arbeitet, du genehmigst

• 🌐 Router / Netzwerkgeräte: Gelegentlich KI-Diagnose, aber die Zugangsdaten dürfen niemals nach außen gelangen

• 🔁 Nutzer mehrerer KI-Clients: Codex, OpenCode, ZCode, WorkBuddy teilen sich dieselben autorisierten SSH-Sitzungen – kein erneutes Autorisieren beim Toolwechsel

• 🛡️ Audit-bewusste Nutzer: Jeder sudo-Befehl muss durch ein Einblendfenster mit klarem Befehlstext genehmigt werden

Screenshots

Kernfunktionen

• 🔐 Anmeldedaten-Isolation: SSH-Adresse, Port, Benutzername liegen nur in der lokalen Konfiguration; Passwort und privater Schlüssel werden über Electron safeStorage (Windows-Systemanmeldeinformationen) verschlüsselt in einem separaten Tresor gespeichert. Die KI erhält über MCP nur den Namen der Sitzung und den Autorisierungsstatus – alles andere ist unsichtbar. Dafür gibt es spezielle Testzusicherungen.

• 🚦 Zwei Berechtigungsmodi: Relativ sicher (die KI kann nur sieben feste, schreibgeschützte Prüfungen ausführen: Identität / System / Speicher / Prozesse / Container / Dienste / Logs) und Vollzugriff (vollständige Terminalrechte des aktuellen SSH-Kontos), jederzeit mit einem Klick umschaltbar.

• 💳 sudo-Genehmigungsablauf: Wenn die KI erhöhte Rechte benötigt, ruft sie exec_sudo auf; HostConsole zeigt ein Popup mit dem Befehlstext an, und erst nach deiner Genehmigung wird ausgeführt. Optional ein 30-minütiges (Standard, 0–240 Minuten einstellbar) Nachfragefenster; das sudo-Passwort wird vom lokalen Tresor über SSH-Standardeingabe direkt an den entfernten Rechner übergeben – nicht in den Befehlstext, nicht in die Terminalprotokolle, nicht in den KI-Kontext.

• 🟢 Agent-Anbindungszentrum: Alle angebundenen KIs werden als Statusleuchten in Echtzeit angezeigt (online / offline / steuert gerade), jeder Agent hat einen eigenen Verbindungsschalter – Ausschalten gibt sofort die SSH-Steuerung und sudo-Autorisierung frei, ohne andere Agenten zu beeinflussen oder SSH zu trennen.

• 🧙 Ein-Klick-Anbindungsassistent: Erkennt und schreibt automatisch in sechs MCP-Konfigurationsformate: Codex TOML, OpenCode JSONC, ZCode, WorkBuddy sowie generisches JSON/JSONC. Vor dem Schreiben kann eine Vorschau angezeigt werden; automatisch wird eine zeitgestempelte Sicherung erstellt.

• ✍️ Ein-Schreib-Lizenz: Nur ein Agent kann gleichzeitig in den Terminal schreiben; andere sehen den belegten Status, können aber keine Befehle einfügen. Nur wenn du explizit „Übernehmen / Erzwingen" sagst, wechselt die Lizenz.

• 🫸 Sofortige Unterbrechung: „KI pausieren" blockiert sofort Aktionen, hält aber die SSH-Verbindung; „Verbindung trennen" entzieht gleichzeitig Autorisierung, Lizenz und sudo-Rechte.

• 🖥️ Lokale manuelle Befehle als Fallback: Wenn die KI sich weigert oder interaktive Eingaben benötigt, gibt es ein integriertes Eingabefeld – du tippst selbst.

• 🇨🇳 Komplett chinesische Oberfläche: Für chinesische Nutzer gestaltet, von Berechtigungsmodi bis Fehlermeldungen – kein englischer Begriff muss übersetzt werden.

• ✅ 29 Sicherheitstests: Kernaussagen wie Anmeldedaten-Isolation, Lizenz-Exklusivität, sudo-Lebenszyklus, Konfigurations-Maskierung sind alle durch automatisierte Tests abgesichert (npm test).

Schnellstart

Systemanforderungen

• Windows 10/11

• Node.js 20+ (mit npm)

Start

git clone https://github.com/tuweihuasheng/host-console.git
cd host-console
npm install
npm run desktop

Nach dem Schließen des Fensters bleibt die App im System-Tray; SSH-Sitzungen werden dadurch nicht getrennt.

Drei Schritte zum Start

1. Verbinden: Klicke auf „Neue Verbindung", wähle SSH-Passwort / privaten Schlüssel einfügen / Schlüsseldatei auswählen; beim ersten Verbinden wird der SHA-256-Fingerprint des Hosts geprüft und fixiert (TOFU).

2. Autorisieren: Wähle nach dem Verbinden rechts „Relativ sicher" oder „Vollzugriff".

3. KI rufen: Sage zu einer bereits angebundenen KI:

   Auf diesem Rechner ist die SSH-Verbindung zum „Heim-NAS" aktiv. Bitte prüfe den Festplattenstatus und die Docker-Container.

   Die KI entdeckt über MCP automatisch die autorisierte Sitzung, erhält die Steuerung und beginnt zu arbeiten.

KI anbinden

HostConsole stellt den MCP-Dienst über eine lokale Named Pipe bereit (\\.\pipe\host-console-mcp), ohne TCP-Port zu öffnen – Cloud-Agenten können nicht zugreifen.

Am einfachsten klickst du in HostConsole auf „Agent anbinden" und nutzt den integrierten Assistenten, der die Konfiguration automatisch schreibt (mit Backup und Vorschau). Hier die manuelle Konfigurationsreferenz:

Codex (~/.codex/config.toml)

[mcp_servers.host_console]
command = "node.exe 的完整路径"
args = ["C:\\path\\to\\host-console\\mcp\\server.mjs"]
startup_timeout_sec = 10
tool_timeout_sec = 60

OpenCode (~/.config/opencode/opencode.jsonc)

"mcp": {
  "host_console": {
    "type": "local",
    "command": ["node.exe 的完整路径", "C:\\path\\to\\host-console\\mcp\\server.mjs"],
    "enabled": true,
    "timeout": 60000,
    "environment": {
      "HOST_CONSOLE_AGENT_LABEL": "OpenCode",
      "HOST_CONSOLE_CLIENT_KIND": "opencode"
    }
  }
}

ZCode (~/.zcode/cli/config.json unter mcp.servers), WorkBuddy (~/.codebuddy/.mcp.json unter mcpServers) sowie jedes generische JSON/JSONC können nach demselben Muster angebunden werden, oder du nutzt den integrierten Assistenten.

Nach dem Schreiben der Konfiguration muss der jeweilige KI-Client vollständig beendet und neu gestartet werden (MCP-Clients laden die Konfiguration nur beim Start). Nach erfolgreicher Anbindung erscheint im „Agent-Anbindungszentrum" eine grüne Statusleuchte, und die Namen und Berechtigungsmodi der autorisierten Sitzungen werden an die KI synchronisiert.

Sicherheitsmodell

Was die KI sehen kann und was nicht

Mehrere Schutzschichten

1. Pipe-Isolation: MCP ist nur an die lokale Named Pipe gebunden, kein Netzwerkzugriff, kein Port; außerhalb desselben Computers kann niemand verbinden.

2. Ein-Schreib-Lizenz: Bei gleichzeitigen Agenten kann nur einer den Terminal bedienen; die Übernahme erfordert deine ausdrückliche Zustimmung.

3. Zwei-Faktor-Bestätigung: In Multi-Sitzungs-Szenarien muss die KI sowohl die Sitzungs-ID als auch den genauen Namen angeben, um die Steuerung zu erhalten; bei Nichtübereinstimmung wird abgelehnt.

4. sudo-Lebenszyklus: Die temporäre Autorisierung ist an die aktuelle Sitzung und den aktuell steuernden Agenten gebunden; sie erlischt sofort bei Pause, Trennung, Übernahme, Rechteentzug oder Ablauf – und kann jederzeit manuell vorzeitig beendet werden.

5. Anmeldedaten irreversibel: Beim Ändern der Anmeldedaten muss zuerst die SSH-Verbindung getrennt werden; alte Anmeldedaten werden nie wieder angezeigt, neue werden verschlüsselt überschrieben.

Bekannte Grenzen

• Ein bösartiger lokaler Prozess, der unter dem gleichen Windows-Benutzer wie HostConsole läuft, könnte theoretisch die Named Pipe verbinden – verwende den Modus „Vollzugriff" nicht in einer nicht vertrauenswürdigen lokalen Umgebung.

• Aktuell MVP, noch keine signierten Installationspakete und automatische Updates.

MCP-Werkzeugübersicht

Die 9 Werkzeuge, die die KI aufrufen kann:

Funktionsweise

主机台 (Electron)
├── src/                    全中文桌面界面（React 19）
├── electron/
│   ├── main.cjs            窗口、托盘、命名管道服务、IPC
│   ├── session-manager.cjs 加密保险箱、SSH 连接池、授权与租约、sudo 审批
│   ├── agent-config.cjs    6 种格式的 Agent 配置向导（预览 + 备份 + 原子写入）
│   └── policy.cjs          只读命令白名单、公开信息脱敏
├── mcp/server.mjs          MCP 桥接服务（stdio → 命名管道）
└── tests/                  29 项安全与行为测试

FAQ

F: Woher weiß die KI, dass sie HostConsole aufrufen soll? Nach der MCP-Anbindung synchronisiert HostConsole in der Initialisierungsbeschreibung die Namen und Berechtigungsmodi der autorisierten Sitzungen aktiv an die KI. Du musst nur wie gewohnt eine Aufgabe stellen: „Auf diesem Rechner ist die SSH-Verbindung zum Heim-NAS aktiv, bitte …".

F: Kann ich einen anderen KI-Client verwenden? Ja. Die Autorisierung ist an die SSH-Sitzung gebunden, nicht an den Agenten. Jede lokale KI, die an die HostConsole-MCP angebunden ist, kann dieselbe Sitzung entdecken und (wenn die Lizenz frei ist) übernehmen.

F: Was passiert bei mehreren gleichzeitigen SSH-Verbindungen? Die KI muss sowohl die Sitzungs-ID als auch den genauen Namen doppelt bestätigen, um Fehlbedienungen zu vermeiden.

F: Kann die KI das sudo-Passwort sehen? Nein. Das Passwort wird vom lokalen Tresor entschlüsselt und über SSH-Standardeingabe direkt an den entfernten sudo übergeben – es passiert nie die KI, erscheint nicht im Befehlstext oder in Terminalprotokollen (dafür gibt es spezielle Tests).

F: Gehen Anmeldedaten bei Stromausfall / Herunterfahren verloren? Nein. Die Tresordatei wird dauerhaft im Windows-Benutzerdatenverzeichnis gespeichert und durch die System-Anmeldeinformationsschutzfunktion verschlüsselt. Kopiere die Tresordatei jedoch nicht auf eine nicht vertrauenswürdige Maschine.

F: Unterstützt es Linux / macOS? Die Oberfläche und Logik sind plattformunabhängig, aber die Entwicklung und Verifizierung erfolgt derzeit unter Windows; safeStorage nutzt auf anderen Plattformen die jeweiligen System-Schlüsselbunde. Feedback ist willkommen.

Entwicklung

npm run dev      # 浏览器开发预览
npm run desktop  # 构建并启动 Electron 桌面版
npm test         # 29 项测试

Für die Teilnahme an der Entwicklung lies AGENTS.md für die Produktentscheidungskonventionen des Projekts.

Lizenz

MIT © 2026 host-console contributors