Hermes-Agent per Smartphone sicher erreichen
Greifen Sie per Smartphone auf das Web-Dashboard Ihres Hermes-Agenten zu: über Tailscale ohne offenen Port, per HTTPS-Proxy oder SSH. Zugang bei Verlust widerrufen.
Drei Möglichkeiten, Ihren Hermes-Agenten vom Smartphone aus zu erreichen
Um Ihren Hermes-Agenten vom Smartphone aus zu erreichen, verwenden Sie dessen Web-Dashboard. Die eigentliche Entscheidung betrifft die Komponente vor diesem Dashboard. Option eins ist ein privates Mesh-Netzwerk. Dabei lauscht das Dashboard nur auf einer Tailscale-Adresse, und kein Port ist aus dem Internet erreichbar. Option zwei ist ein öffentlicher Endpunkt hinter einem Reverse Proxy mit TLS (Transport Layer Security) und einer Anmeldung. Diese Anmeldung ist dann der einzige Schutz für ein Terminal auf Ihrem Server. Option drei ist SSH (Secure Shell) über eine Terminal-App. Dafür ist die Einrichtung am einfachsten, gleichzeitig erhalten Sie damit den umfassendsten Zugriff.
Dieser Leitfaden beginnt dort, wo ein Hermes-Agent auf Ihrem eigenen VPS ausgeführt wird endet. Der Agent ist installiert, antwortet auf der Befehlszeile, und Sie möchten nun von unterwegs auf ihn zugreifen.
Die folgenden Befehle beziehen sich auf den Tag v2026.8.3, der am 3 August 2026 veröffentlicht und in den Release Notes als v0.20.0 bezeichnet wurde. Hermes veröffentlicht häufig neue Versionen. Fixieren Sie den Rechner daher auf einen Tag, statt main zu folgen. Der Installer akzeptiert einen Commit:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --versionVerwenden Sie für diese Fixierung den Installer aus diesem Tag. Der aktuelle Installer erwartet das neuere PM-Abhängigkeitssystem. hermes --version gibt aus, was tatsächlich installiert ist. Vergleichen Sie die Ausgabe mit dem Tag, bevor Sie einem Flag auf dieser Seite vertrauen.
Was das Repository bereitstellt und was nicht
Im Hermes-Repository gibt es keine iOS- oder Android-App. Der native Client ist hermes desktop (Alias hermes gui), eine Electron-Anwendung für macOS, Windows und Linux. Er kann eine Verbindung zu einem entfernten Agenten statt zu einem lokalen Agenten herstellen: Setzen Sie in den Einstellungen unter Gateway die Remote-URL auf http://<server-address>:9119 oder exportieren Sie HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119, bevor Sie die Anwendung starten. Damit lässt sich ein zweiter Laptop anbinden. Für ein Smartphone ist das nicht geeignet.
Die Oberfläche, die Sie mit einem Smartphone verwenden, ist hermes dashboard, die Browseroberfläche. Sie verwaltet Konfigurationen, Sitzungen, Cron-Jobs, Skills, Logs und Messaging-Plattformen. Außerdem enthält sie ein Terminal: Der Server startet hermes --tui hinter einem PTY (Pseudo-Terminal) und streamt die Ausgabe in die Seite. Auf einem schmalen Bildschirm wird der Sitzungsumschalter zu einem seitlich eingeblendeten Panel eingeklappt. Dadurch bleibt das Layout auch auf einem Smartphone nutzbar.
Neuere Releases bieten außerdem den Desktop-Arbeitsbereich über hermes webapp in einem Browser an. Das ist eine separate Gateway-Oberfläche mit eigenen Einstellungen für Port und öffentliche URL. Die folgenden Anweisungen behandeln das Dashboard.
Standardmäßig lauscht das Dashboard auf 127.0.0.1:9119 und öffnet auf dem Server selbst einen Browser-Tab. Das ist auf einem Headless-VPS (Virtual Private Server) nicht hilfreich. Starten Sie es ohne Browser und prüfen Sie den Socket:
hermes dashboard --no-open
ss -lntp | grep 9119Ein Listener auf 127.0.0.1:9119 ist nur vom Server aus erreichbar. Ein Listener auf 0.0.0.0:9119 ist aus jedem Netzwerk erreichbar, mit dem die Maschine verbunden ist, einschließlich des öffentlichen Netzwerks. Diese eine Zeile bestimmt, wie stark der Dienst exponiert ist. Lesen Sie sie daher, statt die Konfiguration vorauszusetzen.
Option 1: ein privates Mesh mit Tailscale
Wählen Sie diese Option, sofern kein Grund dagegenspricht. Tailscale ist ein Mesh-VPN (virtuelles privates Netzwerk) auf Basis von WireGuard. Jedes registrierte Gerät erhält eine stabile Adresse und verbindet sich direkt mit den anderen Geräten oder über ein verschlüsseltes Relay. Ihr Smartphone tritt demselben Mesh bei. Das Dashboard benötigt dadurch überhaupt keinen öffentlichen Port.
Auf dem Server:
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4Installieren Sie die Tailscale-App auf dem Smartphone und melden Sie sich mit demselben Konto an. tailscale status auf dem Server listet das Smartphone anschließend nach seinem Namen auf. Binden Sie das Dashboard nun an die von tailscale ip -4 ausgegebene Adresse:
hermes dashboard --host 100.101.102.103 --port 9119 --no-openWenn Sie die Mesh-Adresse statt 0.0.0.0 verwenden, akzeptiert der Socket nur Verbindungen, die an diese Mesh-IP adressiert sind. Ein Portscan Ihrer öffentlichen IP-Adresse findet auf 9119 nichts, weil an dieser Adresse kein Prozess lauscht. Der Socket wird dadurch jedoch nicht an das Tailscale-Interface gebunden. Die Linux-Kerndokumentation formuliert es eindeutig: IP-Adressen gehören zum gesamten Host und nicht zu bestimmten Interfaces. Ein an 100.101.102.103 adressiertes Paket, das über das öffentliche Interface eintrifft und von einem Rechner im selben Provider-Netzwerk gesendet wurde, kann das Dashboard daher weiterhin erreichen. Um zusätzlich das Interface zu erzwingen, lassen Sie ufw bei seiner standardmäßigen Sperre für eingehenden Datenverkehr und erlauben Sie den Port nur im Mesh mit sudo ufw allow in on tailscale0 to any port 9119 proto tcp. Prüfen Sie den Listener anschließend erneut mit ss -lntp | grep 9119.
Die Bind-Adresse bestimmt außerdem die Authentifizierung. Dieser Punkt wird häufig übersehen. In v2026.8.3 hat ein an 127.0.0.1 gebundenes Dashboard keine Anmeldung, selbst wenn public_url konfiguriert ist. Bei jeder anderen Adresse ist die Authentifizierung zwingend erforderlich. Wenn kein Provider konfiguriert ist, verweigert der Server den Start. Das Projekt bezeichnet dieses Verhalten als Fail-Closed. Starten Sie den Server beim ersten Mal interaktiv. Er bietet dann an, sofort einen Benutzernamen und ein Passwort einzurichten und als dashboard.basic_auth in ~/.hermes/config.yaml zu speichern. Sie können denselben Provider stattdessen auch über ~/.hermes/.env konfigurieren. So wird es im offiziellen Beispiel des Projekts umgesetzt:
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-stringErzeugen Sie dieses Secret mit openssl rand -base64 32. Dies ist der Befehl aus der Dashboard-Dokumentation des Projekts. Der Kommentar in der Konfiguration verlangt mindestens 32 zufällige Bytes, in Base64 oder Hex. Ändern Sie das Secret anschließend nicht mehr. Es signiert die Sitzungstokens des Passwort-Providers. Wenn Sie es ändern, werden alle Geräte abgemeldet, die diesen Provider verwenden. Dieselbe Datei enthält auch Ihre Model-API-Schlüssel. Schützen Sie sie daher mit chmod 600 ~/.hermes/.env.
Prüfen Sie den Authentifizierungsmechanismus von einem anderen Gerät im Mesh, bevor Sie ihm vertrauen:
curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'true gefolgt von ["basic"] bedeutet, dass der Authentifizierungsmechanismus aktiviert ist und der Passwort-Provider die Anfragen beantwortet. Die offizielle Dokumentation des Projekts äußert sich zu diesem Provider eindeutig: Er ist für ein vertrauenswürdiges Netzwerk oder ein VPN vorgesehen und nicht für ein Dashboard geeignet, das dem öffentlichen Internet ausgesetzt ist. In einem Mesh ist genau das Ihre Situation.
Für HTTPS innerhalb des Tailnets benötigt die nachfolgende Tailscale-Serve-Konfiguration eine neuere Version mit Unterstützung für public_url bei den Prüfungen von Host und WebSocket Origin. Mit dem v2026.8.3-Pin funktioniert sie nicht: Eine Bindung an Loopback akzeptiert unabhängig von public_url nur Loopback-Hostnamen. Verwenden Sie bei diesem Pin weiterhin die direkte Mesh-IP aus dem vorherigen Beispiel. Nach dem Upgrade und der Überprüfung dieser Prüfungen leitet Serve hier an die Loopback-Adresse weiter. Starten Sie das Dashboard für diese Konfiguration daher auf 127.0.0.1 statt auf der Mesh-Adresse und führen Sie anschließend Folgendes aus:
sudo tailscale serve --bg localhost:9119
sudo tailscale serve statusDie aktuelle Hermes-Dashboard-Dokumentation weist anschließend an, den von tailscale serve status ausgegebenen HTTPS-Ursprung als öffentliche URL zu verwenden:
dashboard:
public_url: "https://vps.tail1234.ts.net"Ohne diese Zeile weist das Dashboard den MagicDNS-Namen im Header Host zurück. Da der Name kein Loopback-Host ist, bleibt der Authentifizierungsmechanismus außerdem aktiviert, obwohl das Backend auf Loopback lauscht. Tailscale beendet TLS mit einem Zertifikat, das für den MagicDNS-Namen des Rechners ausgestellt ist. Der Browser zeigt dadurch keine Warnung mehr an, und das Sitzungscookie erhält sein Secure-Flag. Aktivieren Sie zunächst MagicDNS und HTTPS Certificates auf der DNS-Seite der Tailscale-Administrationskonsole. Lesen Sie dort auch den Hinweis: Ihre Rechnernamen und der DNS-Name Ihres Tailnets werden im öffentlichen Certificate-Transparency-Register veröffentlicht, das jeder einsehen kann.
Der ehrliche Nachteil ist der Koordinationsserver. Der Datenverkehr zwischen Ihrem Smartphone und Ihrem VPS ist Ende-zu-Ende-verschlüsselt, auch wenn er über ein Tailscale-DERP-Relay läuft. Das Konto, das festlegt, welche Geräte zum Mesh gehören, liegt jedoch nicht auf Ihrer Hardware. Wenn das relevant ist, betreiben Sie die Steuerungsebene selbst mit Headscale, dem selbst gehosteten Tailscale-Steuerungsserver, und verweisen Sie die Clients mit tailscale up --login-server https://headscale.example.com darauf. Wenn Sie das Mesh nicht verwenden und Peers stattdessen manuell konfigurieren möchten, erklärt der Vergleich zwischen einfachem WireGuard und Tailscale, worauf Sie verzichten.
Option 2: ein öffentlicher HTTPS-Endpunkt und die darin liegende Falle
Manchmal ist kein Mesh verfügbar. Auf einem Arbeitsgerät lässt sich möglicherweise kein VPN-Client installieren. Dann wird das Dashboard hinter einen Reverse Proxy gestellt. Diese HTTPS-Konfiguration über Loopback erfordert ebenfalls die oben beschriebene Unterstützung für öffentliche Hostnamen; public_url funktioniert damit unter v2026.8.3 nicht. Lassen Sie das Dashboard auf Loopback und überlassen Sie Caddy die Zertifikatsverwaltung:
hermes.example.com {
reverse_proxy 127.0.0.1:9119
}Caddy ruft das Zertifikat selbst ab und erneuert es automatisch. Sein reverse_proxy leitet WebSocket-Upgrades ohne zusätzliche Direktiven weiter. Das benötigt das eingebettete Terminal des Dashboards. Bei nginx müssen Sie die Header Upgrade und Connection selbst hinzufügen. Ein Let's-Encrypt-Zertifikat mit Certbot unter nginx ausstellen beschreibt die TLS-Seite dieser Konfiguration. Teilen Sie Hermes seinen öffentlichen Namen mit, damit die Login-Callbacks auf den richtigen Host verweisen:
dashboard:
public_url: "https://hermes.example.com"Nun zur Falle. Die Authentifizierungsprüfung richtet sich nach der Bind-Adresse, nicht nach der Adresse, von der die Anfrage stammt. Aktuelle Releases aktivieren die Prüfung außerdem, wenn dashboard.public_url (oder HERMES_DASHBOARD_PUBLIC_URL) einen Nicht-Loopback-Host angibt, auch wenn das Backend auf Loopback läuft. Die Einstellung oben aktiviert daher die Prüfung, und das Dashboard startet erst, wenn ein Provider konfiguriert ist. Lassen Sie public_url nicht gesetzt. Dann bleibt die Prüfung deaktiviert. Der Proxy allein bestimmt jedoch nicht, wer Zugriff erhält. Das Dashboard prüft außerdem den Header Host. In dieser Loopback-Konfiguration akzeptieren aktuelle Releases Loopback-Namen und den Host, den public_url angibt. Für jeden anderen Wert antworten sie mit 400. Das festgelegte v2026.8.3 akzeptiert hier nur Loopback-Namen und prüft public_url nie. Caddy leitet den Host des Browsers unverändert weiter. Der Block oben ohne public_url wird daher abgewiesen und nicht ausgeliefert. Gefährlich ist ein Proxy, der Host auf die Backend-Adresse umschreibt. nginx macht das standardmäßig und sendet das Ziel proxy_pass, sofern Sie proxy_set_header Host nicht selbst setzen. Eine solche Anfrage besteht die Prüfung und erreicht ein Dashboard ohne Login. Das WebSocket des Terminals fügt eine weitere Origin-Prüfung hinzu: Beim festgelegten Stand muss ein vorhandener HTTP- oder HTTPS-Header Origin auf den gebundenen Host verweisen. Dadurch wird ein Browser auf Ihrem öffentlichen Hostnamen blockiert. Ein Skript, das überhaupt kein Origin sendet, passiert diese Prüfung jedoch. Prüfen Sie unabhängig von Ihrer Konfiguration, was Sie tatsächlich veröffentlicht haben:
curl -s https://hermes.example.com/api/status | jq '.auth_required'Wenn dabei false ausgegeben wird, ist ein Terminal auf Ihrem Server aus dem Internet nur eine URL entfernt. Es ist kein Exploit erforderlich, und in den Logs wird nichts darauf hinweisen. Wenn die Anfrage stattdessen mit 400 fehlschlägt, hat die Host-Prüfung sie abgewiesen. Bei einem Release mit Unterstützung für öffentliche Hostnamen beheben Sie das, indem Sie public_url und einen Login-Provider konfigurieren, nicht indem Sie Header um die Prüfung herum umschreiben. Verwenden Sie unter v2026.8.3 die direkte Route über die Mesh-IP oder führen Sie zuerst ein Upgrade durch. Für ein offenes Dashboard gibt es zwei Lösungen. Mindestens eine davon sollte umgesetzt werden. Entweder verlagern Sie die Authentifizierung in den Proxy und schalten Authentik als selbst gehosteten Single-Sign-On-Provider per Forward Auth davor, oder konfigurieren Sie den eigenen OIDC-Provider (OpenID Connect) des Dashboards:
HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"Auch bei korrekter Umsetzung gibt es eine Grenze, die Sie nicht unterschreiten können. Eine öffentliche Login-Seite ist für jeden erreichbar und angreifbar. Dahinter befindet sich eine Shell auf Ihrem VPS. Benutzername und Passwort bieten dafür nur einen schwachen Schutz. Deshalb empfehlen die Dokumentationen OAuth oder OIDC für öffentliche Bindings. Begrenzen Sie die Login-Rate, halten Sie ufw für alles außer den Proxy-Ports und SSH geschlossen, und prüfen Sie das Access-Log gelegentlich.
Option 3: SSH und mosh von einem mobilen Terminal
Der Weg mit dem geringsten Aufwand: Installieren Sie eine Terminal-App auf dem Smartphone, laden Sie einen SSH-Schlüssel in die App und verwenden Sie die Textoberfläche des Agenten.
ssh you@vps.example.com
tmux new -A -s phone
hermes --tuitmux new -A -s phone verbindet Sie mit einer Sitzung namens phone oder erstellt sie, falls keine vorhanden ist. Dadurch läuft der Agent weiter, wenn die Verbindung abbricht, und Sie landen beim nächsten Mal wieder an derselben Stelle. Dieses Muster wird auch verwendet, um Claude Code von einem Smartphone aus zu steuern.
Reines SSH über ein mobiles Netzwerk ist unpraktisch, weil die Verbindung jedes Mal abbricht, wenn das Smartphone seine Adresse wechselt oder in den Ruhezustand geht. mosh behebt dieses Problem. Es verwendet UDP (user datagram protocol) und synchronisiert den Terminalstatus statt eines Bytestroms. Dadurch bleibt eine Sitzung beim Wechsel von WLAN zu Mobilfunk bestehen:
sudo apt install -y mosh
sudo ufw allow 60000:61000/udpFühren Sie auf dem Smartphone mosh you@vps.example.com aus. mosh startet mosh-server über Ihre bestehende SSH-Anmeldung und verschiebt die Sitzung anschließend auf einen UDP-Port zwischen 60000 und 61000. Deshalb muss dieser Bereich geöffnet werden. Jede Sitzung benötigt nur ihren eigenen Port. Auf einem Server mit wenigen gleichzeitigen Sitzungen können Sie daher stattdessen einen kleineren Bereich öffnen, beispielsweise 60000 bis 60010.
Die Auswirkungen auf die Sicherheit sind eindeutig. Eine SSH-Sitzung ist eine Shell, und eine Shell kann alles ausführen, wozu dieses Konto berechtigt ist. Die Bestätigungsabfragen des Agenten sind dann das letzte Hindernis zwischen einem gestohlenen, entsperrten Smartphone und Ihren Dateien. Verwenden Sie dafür ein dediziertes Konto ohne root-Berechtigungen und ausschließlich Schlüssel. Arbeiten Sie außerdem die Absicherung von SSH auf einem VPS durch, bevor Sie einen Schlüssel auf einem Gerät hinterlegen, das Sie mit sich führen.
Was in einem Mobilfunknetz nicht funktioniert
Vier Dinge funktionieren nicht. Keines davon lässt sich konfigurativ beheben.
Das Dashboard meldet Sie ab, während Sie es nicht beobachten. Wie schnell das geschieht, hängt vom Login-Provider ab. Der Provider für Benutzername und Passwort stellt standardmäßig ein Zugriffstoken mit einer Gültigkeit von 12 Stunden aus. Dieser Wert wird durch session_ttl_seconds unter dashboard.basic_auth festgelegt. Er steuert jedoch nur, wie oft das Dashboard im Hintergrund aktualisiert wird, nicht, wie lange Sie angemeldet bleiben. Bei jeder Aktualisierung wird ein neues 30-Tage-Refresh-Token ausgestellt. Eine Anmeldung per Passwort bleibt daher gültig, bis 30 Tage ohne Aktualisierung vergangen sind. Ein Neustart des Backends beendet die Anmeldung ebenfalls, wenn über HERMES_DASHBOARD_BASIC_AUTH_SECRET oder dashboard.basic_auth.secret kein dauerhaftes Signaturgeheimnis konfiguriert ist. Hermes erzeugt dann bei jedem Start einen neuen Signaturschlüssel. Der Nous Portal OAuth-Provider stellt Zugriffstoken mit einer TTL (time to live) von 15 Minuten aus und erneuert sie im Hintergrund mit einem Refresh-Token, das bei jeder Verwendung rotiert. Ein abgelaufenes Zugriffstoken allein führt Sie daher nicht zurück zu /login. Das geschieht, wenn die Refresh-Sitzung verloren geht. In Releases vor v0.21.3 (Tag v2026.9.14, veröffentlicht am 14. September 2026) konnte ein Telefon beim Zurückkehren aus dem Hintergrund mehrere Anfragen gleichzeitig senden. Dabei wurde das gerade rotierte Refresh-Token erneut verwendet. Die Wiederverwendungserkennung des Providers löste aus, und die gesamte Sitzung wurde widerrufen. Beim Zurückkehren wurde der Login-Bildschirm angezeigt, und Ihre bisherige Eingabe war verloren. v0.21.3 sorgt dafür, dass diese Anfragen einen gemeinsamen Refresh-Vorgang verwenden. Auf der Seite des Nous Portal verlängert eine Refresh-Sitzung nun ihr 30-Tage-Fenster bei jeder Rotation. 30 Tage ohne Aktivität beenden die Sitzung weiterhin. Wenn Sie den v2026.8.3-Pin am Anfang dieser Seite verwenden, müssen Sie mit gelegentlichen erzwungenen Logins rechnen. Es ist nichts defekt. Melden Sie sich erneut an.
Das eingebettete Terminal bleibt standardmäßig nicht erhalten, wenn ein Tab im Hintergrund ist. Die dokumentierte Terminalverbindung des Dashboards startet die TUI (text user interface) hinter einer PTY und beendet sie sauber, wenn der Tab geschlossen wird. Beim erneuten Öffnen wird eine neue Sitzung gestartet. Mobile Browser verwerfen Hintergrund-Tabs, um Speicher freizugeben. Wenn Sie lange genug zu einer anderen Anwendung wechseln, wird das Terminal daher beendet. Ihr Chatverlauf ist sicher, weil die Sitzungen auf dem Server gespeichert werden und hermes sessions list sie weiterhin anzeigt. Der angeheftete Server unterstützt außerdem optional eine Keep-Alive-Verbindung mit einem Attachment-Token. Diese hält eine getrennte PTY 30 Minuten lang offen. Wenn Sie eine Sitzung benötigen, die erhalten bleibt, verwenden Sie tmux über SSH.
Inaktive Verbindungen werden unbemerkt beendet. Mobilfunkanbieter verwerfen inaktive TCP-Verbindungen, um Einträge in der NAT-Tabelle (network address translation) freizugeben. Sobald der Bildschirm ausgeschaltet ist, verarbeitet das Telefon Netzwerkverkehr außerdem kaum noch. Ein WebSocket, der eine Zeit lang keine Daten übertragen hat, ist beim Entsperren in der Regel bereits beendet. Die Seite stellt die Verbindung erst wieder her, nachdem Sie sie berühren. Deshalb fühlt sich mosh auf einem Telefon besser an als SSH: mosh hatte nie eine Verbindung, die verloren gehen konnte.
Keine Anwendung sendet eine Benachrichtigung. Weder das Dashboard noch eine SSH-Sitzung kann Ihr Telefon aufwecken. Auf dem Gerät gibt es keine Hermes-App. Daher besteht kein Pfad zum Push-Dienst der Plattform. Ein langer Agent-Lauf wird beendet, und Sie erfahren davon erst beim nächsten Nachsehen.
Benachrichtigungen treffen über das Messaging-Gateway ein
Die Lösung für den letzten Punkt ist das Gateway. Es bietet einen grundsätzlich anderen Zugriffsweg auf den Agent. hermes gateway verbindet den Agent mit Messaging-Plattformen wie Telegram, Discord, Slack, WhatsApp, Signal und E-Mail. Sie kommunizieren dann innerhalb einer App mit Ihrem Agent. Diese App verfügt bereits über einen Push-Kanal auf Ihrem Telefon, übernimmt die Zustellung im Hintergrund und kommt auch mit einer unterbrochenen Netzwerkverbindung zurecht.
hermes gateway setup
hermes gateway install
hermes gateway statushermes gateway install registriert das Gateway als systemd-Dienst. Dadurch wird es nach einem Reboot wieder gestartet. Die Gateway-Phase des Installers kann diesen Schritt für Sie ausführen. Der Installer legt jedoch keine Unit für hermes dashboard an. Das Dashboard wird daher nach einem Neustart nicht automatisch wieder verfügbar. Erstellen Sie für alle benötigten Komponenten eine Unit. Systemd-Dienste und Timer auf einem VPS erstellen beschreibt die Unit-Datei.
Ein geplanter Job kann ein Ergebnis auf dieselbe Weise senden, ohne dass eine Unterhaltung erforderlich ist:
hermes send -t telegram -s "Backup report" -f /home/you/report.txtDie Autorisierung verweigert standardmäßig jeden Zugriff. Wenn keine Allowlist und keine genehmigte Kopplung vorhanden sind und GATEWAY_ALLOW_ALL_USERS nicht gesetzt ist, wird jeder Benutzer abgewiesen. Das ist der richtige Ausgangspunkt. Tragen Sie die gewünschten Konten in ~/.hermes/.env ein:
TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789Alternativ können Sie eine Kopplung per Code verwenden, statt numerische IDs einzufügen. Dies ist die Standardeinstellung für Chat-Plattformen mit Direktnachrichten. Sie können sie mit unauthorized_dm_behavior: pair in ~/.hermes/config.yaml explizit festlegen. Ein unbekanntes Konto, das dem Agent eine Nachricht sendet, erhält einen achtstelligen Code. Bis Sie ihn genehmigen, geschieht nichts weiter:
hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789Codes laufen nach einer Stunde ab. Ein Benutzer kann alle zehn Minuten einen Code anfordern. Nach fünf fehlgeschlagenen Versuchen wird das Konto gesperrt.
Den Schaden eines gestohlenen Telefons begrenzen
Ein Telefon, das Ihren Agenten erreichen kann, kann Befehle auf Ihrem Server ausführen. Telefone gehen verloren. Legen Sie daher jetzt fest, was die Person mit dem Telefon tun kann.
Lassen Sie Genehmigungen aktiviert. approvals.mode ist standardmäßig auf smart gesetzt. Dabei bewertet ein zusätzliches Modell das Risiko und genehmigt nur Befehle mit geringem Risiko automatisch. Wenn Sie off setzen, ist das gleichbedeutend damit, alles mit --yolo auszuführen. HERMES_YOLO_MODE=1 setzt diese Einstellung über die Umgebung. Tragen Sie kein Telefon bei sich, das in diesem Zustand mit einem Agenten kommuniziert. Setzen Sie approvals.cron_mode: deny, damit geplante Jobs sich nicht selbst genehmigen können, während Sie schlafen.
approvals:
mode: smart
cron_mode: denyGeben Sie dem Agenten einen kleineren Bereich, in dem er Schaden anrichten kann. terminal.backend: docker führt Befehle in einem Container aus, der bis auf eine kurze Liste alle Linux-Capabilities entfernt, no-new-privileges setzt und die Prozessanzahl begrenzt. Dadurch wird der Container zur Sicherheitsgrenze und nicht die Eingabeaufforderung. terminal.cwd legt das Arbeitsverzeichnis fest. HERMES_WRITE_SAFE_ROOT beschränkt write_file und patch auf die von Ihnen angegebenen Verzeichnisse. Schreibzugriffe außerhalb dieser Verzeichnisse werden blockiert und können nicht durch eine Genehmigung freigegeben werden.
export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermesHermes blockiert bereits Schreibzugriffe auf ~/.ssh, ~/.aws, ~/.kube und /etc/sudoers sowie auf eigene geheime Speicher wie ~/.hermes/.env. Projektdateien in .env an anderen Stellen auf der Festplatte dürfen nicht gelesen werden, bleiben aber beschreibbar. Außerdem weist Hermes eine feste Liste destruktiver Befehle unabhängig von Ihren Genehmigungseinstellungen zurück. Betrachten Sie dies als Mindestschutz und nicht als Ihren Sicherheitsplan. Führen Sie den Agenten als gewöhnlicher Benutzer aus, niemals als root. Die gleiche Überlegung gilt für jeden Coding-Agenten, der unbeaufsichtigt läuft. Claude Code sicher auf einem VPS ausführen beschreibt dies ausführlicher.
Dokumentieren Sie anschließend die Schritte zum Widerrufen des Zugriffs, bevor Sie sie benötigen. Wenn Sie das Gerät in der Tailscale-Administrationskonsole entfernen, wird der Mesh-Zugriff sofort unterbrochen. Wenn Sie HERMES_DASHBOARD_BASIC_AUTH_SECRET ändern und den Dienst neu starten, werden alle Sitzungen der Passwortanbieter-Dashboards auf allen Geräten ungültig, weil dieser Wert die Sitzungstokens des Anbieters signiert. Wenn Sie den öffentlichen Schlüssel des Telefons aus ~/.ssh/authorized_keys löschen, werden neue SSH-Anmeldungen mit diesem Schlüssel blockiert. Bestehende SSH- und mosh-Sitzungen müssen Sie separat beenden. hermes pairing revoke telegram <user-id> entfernt ein Messaging-Konto. Wenn das Gerät Zugriff auf etwas hatte, mit dem Ihre Provider-Schlüssel gelesen werden konnten, widerrufen Sie diese mit hermes auth logout <provider> und stellen Sie beim Anbieter neue Schlüssel aus.
Prüfen Sie das Ergebnis, statt es vorauszusetzen. Dies sind Befehle, die Sie auf Ihrem eigenen System ausführen. Die Ausgabe hängt von Ihrer Konfiguration ab:
tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deepDie Logs befinden sich unter ~/.hermes/logs/. Lesen Sie sie nach einem Sicherheitsvorfall und gelegentlich auch dann, wenn kein Vorfall aufgetreten ist.
FAQ
Gibt es eine offizielle Hermes-App für iOS oder Android?
Nein. Das Hermes-Repository enthält eine Befehlszeilenschnittstelle, ein Web-Dashboard und einen Electron-Desktop-Client für macOS, Windows und Linux. Es gibt keinen offiziellen iOS- oder Android-Build. Auf einem Smartphone verwenden Sie das Web-Dashboard in einem Browser, einen SSH-Client oder eine Messaging-Plattform, die über hermes gateway angebunden ist. Es gibt auch mobile Clients von Drittanbietern. Dabei handelt es sich um Code von Drittanbietern, der Zugriffsdaten für Ihren Agenten enthält. Lesen Sie daher den Quellcode, bevor Sie einen solchen Client installieren.
Warum meldet mich das Hermes-Dashboard auf meinem Smartphone ab?
Das hängt vom Anmeldeanbieter ab. Der Nous-Portal-OAuth-Anbieter stellt Zugriffstoken mit einer TTL von 15 Minuten aus und erneuert sie im Hintergrund mit einem rotierenden Refresh-Token. Ein abgelaufenes Zugriffstoken allein leitet Sie daher nicht zu /login weiter. In Releases vor v0.21.3 (Tag v2026.9.14) konnte ein Smartphone beim Zurückkehren aus dem Hintergrund mehrere Anfragen gleichzeitig senden, das gerade rotierte Refresh-Token erneut verwenden und dadurch die gesamte Sitzung widerrufen. Das erzwingt eine erneute Anmeldung. v0.21.3 behebt dieses Problem. Eine Refresh-Sitzung, die 30 Tage lang nicht verwendet wird, läuft weiterhin ab. Beim Anbieter für Benutzername und Passwort gilt standardmäßig ein Zugriffstoken von 12 Stunden. Dieser Wert wird über session_ttl_seconds festgelegt und steuert nur, wie häufig das Dashboard im Hintergrund eine Aktualisierung durchführt. Die Erneuerung erfolgt über ein 30-Tage-Refresh-Token, das bei jeder Aktualisierung neu ausgestellt wird. Eine Anmeldung mit Passwort endet daher nicht nach 12 Stunden. Verwenden Sie bei diesem Anbieter für HERMES_DASHBOARD_BASIC_AUTH_SECRET einen stabilen Zufallswert. Ohne ein stabiles Secret in dieser Variable oder in dashboard.basic_auth.secret erzeugt Hermes bei jedem Start einen neuen Signaturschlüssel. Dadurch werden Sie bei jedem Neustart abgemeldet.
Kann ich das Hermes-Dashboard sicher im öffentlichen Internet bereitstellen?
Nur mit einer Authentifizierung, die Sie selbst überprüft haben. Das Authentifizierungs-Gate wird abhängig von der Bind-Adresse aktiviert. In aktuellen Releases wird es außerdem aktiviert, wenn dashboard.public_url einen Host außerhalb des Loopback-Bereichs angibt. Ein Dashboard, das an 127.0.0.1 gebunden ist und hinter einem Reverse Proxy ohne gesetzte öffentliche URL läuft, fordert daher keine Anmeldung an. Beim v2026.8.3-Pin aktiviert das Setzen von public_url weder das Loopback-Authentifizierungs-Gate noch erlaubt es einen öffentlichen Hostnamen über die Prüfungen von Host und WebSocket Origin. Verwenden Sie die direkte Route über die Mesh-IP oder aktualisieren Sie auf ein Release mit Unterstützung für öffentliche Hostnamen, bevor Sie die Einrichtung des HTTPS-Proxy durchführen. Die Prüfung von Host weist einen Proxy zurück, der Ihren öffentlichen Hostnamen weiterleitet. Ein Proxy, der Host an die Backend-Adresse umschreibt, wird dagegen nicht zurückgewiesen. Das ist beispielsweise bei nginx die Standardeinstellung. Führen Sie curl -s https://your-host/api/status | jq '.auth_required' aus und prüfen Sie die Ausgabe. Verwenden Sie OAuth oder OIDC statt Benutzername und Passwort, da die Projektdokumentation den Passwortanbieter für vertrauenswürdige Netzwerke und VPNs vorsieht. Ein privates Mesh vermeidet diese Frage vollständig und ist deshalb die bessere Standardeinstellung.
Benötige ich ein Tailscale-Konto, oder kann ich die Steuerungsebene selbst hosten?
Sie können sie selbst hosten. Headscale ist eine offene Implementierung des Tailscale-Koordinationsservers. Offizielle Tailscale-Clients verbinden sich damit über tailscale up --login-server https://headscale.example.com. Sie verwalten dann selbst die Liste der Geräte, die dem Mesh beitreten dürfen. Dafür müssen Sie diesen Server betreiben und sichern. Solange er nicht verfügbar ist, können Sie kein Gerät registrieren oder erneut authentifizieren.
Wie erhalte ich auf meinem Smartphone eine Benachrichtigung, wenn der Agent einen Auftrag abgeschlossen hat?
Verwenden Sie das Messaging-Gateway. Das Dashboard und SSH können ein Smartphone nicht aufwecken, da auf dem Gerät keine Hermes-App Push-Benachrichtigungen empfangen kann. Verbinden Sie den Agenten mit Telegram, Signal, Discord oder einer anderen unterstützten Plattform über hermes gateway setup. Anschließend stellt die eigene App dieser Plattform die Benachrichtigung zu. Ein Cronjob kann mit hermes send -t telegram -s "Job done" -f /path/to/report.txt ebenfalls eine einzelne Nachricht senden. Dabei wird das Modell nicht aufgerufen.