Hermes Agent auf einem VPS im Browser bedienen
Hermes Agent läuft normalerweise im Terminal. Für alles, was man nicht per SSH tippen will – Konfiguration ändern, Sessions durchsuchen, Logs lesen, direkt im Browser chatten – bringt Hermes zwei Weboberflächen mit. Dieser Artikel zeigt, wie man sie auf einem VPS erreichbar macht, ohne sich dabei ein Sicherheitsloch zu bauen.
Was man im Browser bekommt
| Oberfläche | Start | Standard-Port | Inhalt |
|---|---|---|---|
| Web-Dashboard | hermes dashboard | 9119 | Status, Config-Editor, API-Keys, Sessions, Logs, Cron, Skills, MCP, Webhooks – plus Chat-Tab mit der echten TUI |
| Webapp (Desktop-Arbeitsfläche) | hermes webapp | 9120 | Sessions, Capabilities, Messaging, Artefakte, Dateibaum, Git-Review, Terminal-Leiste – das Desktop-App-Layout im Browser |
| Beides sind normale Webseiten: ein Browser, die Adresse, fertig. Kein Client, keine App-Installation – das gilt auch für Tablet oder Smartphone. | |||
| Wichtig zu verstehen: Das Dashboard ist eine Administrationsoberfläche mit voller Kontrolle über die Installation. Wer da drin ist, kann API-Keys lesen, die Config ändern und im Chat-Tab Befehle auf dem Server ausführen. Der Zugriffsschutz ist deshalb kein Nebenschauplatz. |
Voraussetzungen
- VPS mit Linux (Debian/Ubuntu), Hermes installiert (hermes --version antwortet)
- SSH-Zugang zum Server
- Optional: eine Domain, wenn der Zugriff nicht nur über die IP laufen soll Kurz prüfen, ob das Dashboard überhaupt startet:
hermes dashboard --status hermes dashboard --no-open # startet auf http://127.0.0.1:9119
Der Standard-Bind ist 127.0.0.1 – also nur vom Server selbst erreichbar. Und das ist gut so, denn genau daraus ergeben sich die folgenden vier Wege.
Weg 1: SSH-Tunnel (empfohlen für den eigenen Zugang)
Der einfachste und sicherste Weg, wenn nur Sie selbst zugreifen. Der Dienst bleibt lokal, der Tunnel erledigt den Rest. Auf dem VPS:
hermes dashboard --no-open
Auf dem eigenen Rechner:
ssh -N -L 9119:127.0.0.1:9119 benutzer@203.0.113.10
Dann im Browser http://127.0.0.1:9119 öffnen. Vorteile:
- kein offener Port, keine Firewall-Regel, kein Zertifikat
- keine Auth-Konfiguration nötig, weil der Dienst auf Loopback lauscht
- der Verkehr ist durch SSH verschlüsselt Der Nachteil: Auf einem Tablet braucht man einen SSH-Client (Termius, Blink, JuiceSSH) oder man nimmt gleich Weg 4.
Weg 2: Über die IP-Adresse mit Passwort-Login
Wenn der Zugriff ohne Tunnel klappen soll – etwa aus dem eigenen Netz, über ein VPN oder von einem Gerät ohne SSH-Client – bindet man das Dashboard an alle Interfaces. Sobald der Bind nicht mehr Loopback ist, schaltet Hermes automatisch eine Login-Schranke davor. Ohne konfigurierten Auth-Provider startet der Dienst dann gar nicht (fail closed), statt ungeschützt zu lauschen. 1. Zugangsdaten setzen in ~/.hermes/.env:
cat >> ~/.hermes/.env <<EOF HERMES_DASHBOARD_BASIC_AUTH_USERNAME=admin HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=<IhrPasswort> HERMES_DASHBOARD_BASIC_AUTH_SECRET=$(openssl rand -base64 32) EOF chmod 600 ~/.hermes/.env
Das SECRET ist der Schlüssel, mit dem die Session-Cookies signiert werden. Lässt man es weg, erzeugt Hermes bei jedem Start einen zufälligen Schlüssel – dann fliegt man nach jedem Neustart aus der Session. Optional statt Klartext-Passwort ein scrypt-Hash (kein Passwort im Klartext auf der Platte):
cd ~/.hermes/hermes-agent
python -c "from plugins.dashboard_auth.basic import hash_password; print(hash_password('IhrPasswort'))"
Den ausgegebenen Wert als HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH eintragen. 2. Dashboard auf allen Interfaces starten:
hermes dashboard --host 0.0.0.0 --port 9119 --no-open
3. Firewall aufmachen – am besten nur für die eigene IP, nicht für die ganze Welt:
sudo ufw allow from 198.51.100.7 to any port 9119 proto tcp
4. Aufrufen: http://203.0.113.10:9119 – es erscheint eine Login-Maske, keine "Mit X anmelden"-Schaltfläche. Nach dem Login landet man im Dashboard. Prüfen, ob die Schranke wirklich aktiv ist (von einem beliebigen Rechner):
curl -s http://203.0.113.10:9119/api/status | jq '.auth_required, .auth_providers' # true # ["basic"]
Zwei Einschränkungen sollte man kennen:
- Es gibt ein gemeinsames Konto – keine Benutzerverwaltung, kein MFA. Für ein geteiltes oder gar öffentlich erreichbares System ist das zu wenig.
- Über blankes HTTP gehen Benutzername und Passwort im Klartext über die Leitung. Für den Zugriff über die offene IP also nur im VPN oder im vertrauenswürdigen LAN sinnvoll, sonst Weg 3. Der frühere Schalter --insecure ist übrigens ein No-op: Er schaltet die Authentifizierung nicht mehr ab. Wer ohne Login arbeiten will, bleibt auf Loopback plus Tunnel.
Weg 3: Eigene Domain mit HTTPS und OAuth (öffentlich erreichbar)
Für den Zugriff aus dem Internet ist der richtige Aufbau: Dashboard bleibt lokal, ein Reverse-Proxy macht TLS, und die Anmeldung läuft über OAuth statt über ein Passwort. 1. Dashboard mit Nous-Portal-Anmeldung registrieren:
hermes dashboard register # schreibt HERMES_DASHBOARD_OAUTH_CLIENT_ID in ~/.hermes/.env
2. Dashboard lokal starten und öffentliche URL deklarieren:
hermes config set dashboard.public_url "https://hermes.example.com" hermes dashboard --host 127.0.0.1 --port 9119 --no-open
3. Reverse-Proxy davor (Beispiel Caddy, TLS automatisch):
hermes.example.com {
reverse_proxy 127.0.0.1:9119
}
Läuft der Proxy in einem Container oder auf einem anderen Host, muss seine IP in dashboard.trusted_proxies stehen, damit die X-Forwarded-*-Header akzeptiert werden:
hermes config set dashboard.trusted_proxies '["172.20.0.5"]'
4. Aufrufen: https://hermes.example.com → "Sign in with Nous Research" → zurück im Dashboard. Zwei Details, die beim Debuggen Zeit sparen:
- Eine gesetzte public_url aktiviert die Login-Schranke auch bei Loopback-Bind. Ohne Auth-Provider startet der Dienst nicht.
- Der Hostname aus public_url wird exakt als erlaubter Host- und Origin-Wert akzeptiert. Deshalb muss die URL im Browser genau dieser Domain entsprechen – sonst greift der Schutz gegen DNS-Rebinding.
Weg 4: Tailscale (mobil, ohne offenen Port)
Wenn der Zugriff auch vom Handy oder Tablet klappen soll, ohne Ports zu öffnen: Tailscale auf VPS und Endgerät installieren, dann lauscht das Dashboard weiterhin lokal und ist im Tailnet erreichbar.
# VPS sudo tailscale up tailscale serve --bg 9119 # HTTPS im Tailnet auf das lokale Dashboard
Aufruf dann über die https://<host>.<tailnet>.ts.net-Adresse – auf jedem Gerät im Tailnet, ohne Firewall-Regel. Der Name dieser Adresse gehört in dashboard.public_url, und es braucht weiterhin einen Auth-Provider (Passwort oder OAuth), weil Hermes den Tailnet-Host als nicht-lokalen Browser-Ursprung wertet. Das ist der bequemste Weg für "ich will das auch am iPad öffnen": keine öffentliche IP, kein Portscan-Rauschen, TLS inklusive.
Variante: die Webapp statt des Dashboards
Das Dashboard ist Verwaltung. Wer die Desktop-App-Oberfläche im Browser will (Sessions links, Chat rechts, Dateibaum, Terminal-Leiste), nimmt die Webapp:
hermes config set webapp.enabled true hermes gateway restart hermes webapp # baut das Bundle, startet das Gateway, öffnet einen Einmal-Login-Link
Das Gateway serviert sie auf http://127.0.0.1:9120. Für andere Geräte gibt es zwei Wege: in der Desktop-App unter Settings → Web Access die Freigabe per Nous-Konto einschalten, oder webapp.public_url setzen und einen Reverse-Proxy davorschalten. Angemeldet wird man sich mit dem Dashboard-Konto.
Dauerbetrieb mit systemd
Ein hermes dashboard in einer SSH-Sitzung stirbt mit der Sitzung. Für den dauerhaften Betrieb eine Unit anlegen (/etc/systemd/system/hermes-dashboard.service):
[Unit]
Description=Hermes Dashboard
After=network-online.target
Wants=network-online.target
[Service]
User=benutzer
WorkingDirectory=/home/benutzer
EnvironmentFile=/home/benutzer/.hermes/.env
ExecStart=/home/benutzer/.hermes/hermes-agent/.hermes/bin/hermes dashboard --host 0.0.0.0 --port 9119 --no-open
Restart=always
RestartSec=10
# Exit 78 = bewusste Verweigerung ("dieser Host wird schon von PID … bedient")
RestartPreventExitStatus=78
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload sudo systemctl enable --now hermes-dashboard sudo systemctl status hermes-dashboard --no-pager
Den ExecStart-Pfad mit command -v hermes prüfen, der kann je nach Installation anders aussehen.
Fehlersuche
| Symptom | Ursache / Lösung |
|---|---|
| Connection refused von außen | Dienst lauscht auf 127.0.0.1. Mit --host 0.0.0.0 starten oder Tunnel nutzen. |
| Start bricht sofort ab, Log sagt "auth" / exit 78 | Nicht-lokaler Bind ohne Auth-Provider → Zugangsdaten setzen. Exit 78 kann auch heißen: Host wird bereits von einem anderen Dashboard-Prozess bedient (hermes dashboard --status). |
| Login-Seite erscheint, Passwort wird abgelehnt | Variablen nicht geladen: Hermes liest ~/.hermes/.env. Prüfen mit curl … /api/status, dort muss "basic" in auth_providers stehen. |
| Nach jedem Neustart neu anmelden | HERMES_DASHBOARD_BASIC_AUTH_SECRET fehlt. |
| Seite lädt, Chat-Tab verbindet nicht | WebSocket blockiert. Reverse-Proxy muss Upgrade/Connection weiterreichen, und der Host muss zur konfigurierten public_url passen (Close-Codes 4401/4403 im Proxy-Log). |
| Chat bricht nach ~30 Sekunden ab | Manche Tunnel/Proxies kappen Verbindungen unabhängig vom Verkehr. Die Seite verbindet sich neu und hängt sich an dieselbe Session; dauerhaft hilft ein Proxy ohne Gesamt-Laufzeitlimit. |
| Zu viele Login-Versuche | Pro IP sind 10 Versuche pro Minute erlaubt, danach HTTP 429. |
Sicherheits-Checkliste
- Dashboard nicht unnötig öffentlich. Loopback + SSH-Tunnel oder Tailscale deckt die meisten Fälle ab.
- Kein --host 0.0.0.0 ohne Auth-Provider – Hermes verweigert es, aber verlass dich nicht auf Zufälle: Zertifikat bzw. VPN gehört dazu.
- Für öffentliche Erreichbarkeit OAuth (Nous-Portal) oder eigenes OIDC, nicht das gemeinsame Passwort-Konto.
- Firewall-Regel auf die eigene Quell-IP begrenzen, statt den Port für alle zu öffnen.
- ~/.hermes/.env bleibt chmod 600 – dort liegen API-Keys und das Session-Secret.
- Zugriff regelmäßig prüfen: hermes dashboard --status und die Audit-Logs im Dashboard.
Spickzettel
# lokal, ohne Login (Standard) hermes dashboard --no-open # http://127.0.0.1:9119 # von zu Hause über Tunnel ssh -N -L 9119:127.0.0.1:9119 benutzer@VPS_IP # dann http://127.0.0.1:9119 # über die IP mit Login hermes dashboard --host 0.0.0.0 --port 9119 --no-open # http://VPS_IP:9119 # Zustand prüfen hermes dashboard --status curl -s http://VPS_IP:9119/api/status | jq '.auth_required, .auth_providers' # stoppen hermes dashboard --stop
Wer die Oberfläche einmal im Browser gesehen hat, will sie nicht mehr missen – vor allem die Session-Suche und der Chat-Tab. Der Aufwand bleibt gering, solange man den Grundsatz beibehält: Dashboard lokal, Zugang über Tunnel, VPN oder TLS-Proxy.