Fernzugriff

Erreichen Sie SimpliGen von einem Agent aus, der auf einem VPS oder einer anderen Maschine läuft, über einen sicheren Tunnel.

View as Markdown Open in ChatGPT Open in Claude

Standardmäßig verbindet sich ein Agent mit SimpliGen auf derselben Maschine. Falls Sie Ihren Agent woanders betreiben, z. B. auf einem VPS, können Sie SimpliGen dennoch über einen sicheren Tunnel erreichen, ohne Änderungen an der App vorzunehmen.

Die Idee

SimpliGen's Kontrolldienst läuft nur auf localhost, aus Sicherheitsgründen. Der Trick besteht darin, den localhost der Remote-Maschine zum localhost Ihrer SimpliGen-Maschine zu tunneln. Ein SSH-Reverse-Tunnel macht genau das, und SSH kümmert sich um die gesamte Verschlüsselung und Authentifizierung.

Was Sie benötigen

SimpliGen läuft auf Ihrer Heimmaschine mit einem Pairing-Token (erstellen Sie einen unter Settings -> Connect an agent -> Manual setup).
Der Control-API-Port. Unter Windows ist er in %APPDATA%\simpligen\agent-api.json, z. B. 48199.
SSH-Zugriff von Ihrer Heimmaschine zur Remote-Maschine.

Öffnen Sie den Tunnel

Von Ihrer Heimmaschine (wo SimpliGen läuft) öffnen Sie einen Reverse-Tunnel zur Remote-Maschine. Ersetzen Sie 48199 mit Ihrem Port und user@your-vps mit Ihrem Server:

ssh -N -R 48199:localhost:48199 user@your-vps

Dies bewirkt, dass sich localhost:48199 auf der Remote-Maschine zu localhost:48199 auf Ihrer Heimmaschine forwarded. Lassen Sie ihn laufen, während der Agent arbeitet.

Weisen Sie den Agent darauf hin

Auf der Remote-Maschine konfigurieren Sie den MCP-Server Ihres Agents mit Ihrem Token und dem Port:

{
  "mcpServers": {
    "simpligen": {
      "command": "npx",
      "args": ["-y", "@simpligen/mcp"],
      "env": {
        "SIMPLIGEN_TOKEN": "sg-agent-...",
        "SIMPLIGEN_API_PORT": "48199"
      }
    }
  }
}

SIMPLIGEN_API_PORT teilt dem Connector mit, welcher Port verwendet werden soll, da die Remote-Maschine keine SimpliGen-Installation hat, um ihn zu erkennen. Jede Anfrage wird durch den Tunnel zu SimpliGen auf Ihrer Heimmaschine geleitet.

Beide müssen laufen

SimpliGen muss auf Ihrer Heimmaschine offen bleiben, und der Tunnel muss aktiv sein. Falls eines von beiden stoppt, verliert der Agent die Verbindung, bis Sie ihn neu starten.

Mit Tailscale oder einem privaten Netzwerk

Falls Sie ein privates Mesh-Netzwerk wie Tailscale verwenden, führen Sie den gleichen SSH-Reverse-Tunnel darüber aus, um eine stabile Verbindung ohne geöffnete Ports auf Ihrem Home-Router zu haben. Die Mechanik ist identisch: der localhost der Remote-Maschine leitet immer noch zu Ihrem localhost weiter.

Ein Wort zur Sicherheit

Da der Tunnel an beiden Enden bei localhost endet, setzen Sie SimpliGen nicht dem öffentlichen Internet aus. SSH verschlüsselt und authentifiziert die Verbindung, und Ihr Pairing-Token autorisiert den Agent. Sie können diesen Token jederzeit unter Connected agents widerrufen, um den Zugriff zu unterbinden.