SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

Accedere all'agente Hermes dal telefono in sicurezza

Scopri tre modi per usare Hermes dal telefono: rete Tailscale privata, endpoint HTTPS pubblico con autenticazione o SSH, con revoca dell'accesso.

I tre modi per raggiungere il tuo agente Hermes dal telefono

Per raggiungere il tuo agente Hermes dal telefono utilizzi la sua dashboard web. La decisione effettiva riguarda ciò che viene posto davanti alla dashboard. La prima opzione è una rete mesh privata, in cui la dashboard è in ascolto solo su un indirizzo Tailscale e nessuna porta è esposta a Internet. La seconda opzione è un endpoint pubblico dietro un reverse proxy con TLS (sicurezza del livello di trasporto) e un login. In questo caso, il login è l'unica protezione per un terminale che consente di accedere al server. La terza opzione è SSH (secure shell) da un'app terminale. Richiede la configurazione minima e concede il livello di accesso più ampio.

Questa guida riprende da eseguire un agente Hermes sul proprio VPS. L'agente è installato, risponde sulla riga di comando e ora vuoi averlo sempre disponibile sul telefono.

I comandi riportati di seguito fanno riferimento al tag v2026.8.3, pubblicato il 3 agosto 2026 e indicato come v0.20.0 nelle note di rilascio. Hermes rilascia frequentemente nuove versioni. Per questo, blocca la macchina su un tag invece di seguire main. L'installer accetta un commit:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --version

Per questo blocco, utilizza l'installer del tag indicato. L'installer attuale si aspetta il sistema di dipendenze PM più recente. hermes --version mostra ciò che è effettivamente installato. Confrontalo con il tag prima di usare un flag riportato in questa pagina.

Cosa include il repository e cosa non include

Nel repository Hermes non esiste un'app per iOS o Android. Il client nativo è hermes desktop (alias hermes gui), un'applicazione Electron per macOS, Windows e Linux. Può collegarsi a un agent remoto invece che a uno locale: nelle impostazioni, alla voce Gateway, imposta l'URL remoto su http://<server-address>:9119 oppure esporta HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119 prima di avviarlo. Questo risolve il caso di un secondo laptop. Non offre alcuna funzionalità per un telefono.

L'interfaccia utilizzabile da un telefono è hermes dashboard, cioè l'interfaccia nel browser. Consente di gestire la configurazione, le sessioni, i cron job, le skill, i log e le piattaforme di messaggistica; include anche un terminale: il server avvia hermes --tui dietro un PTY (pseudo-terminal) e trasmette l'output alla pagina. Su uno schermo stretto, il selettore delle sessioni si chiude in un pannello laterale a comparsa, quindi il layout resta utilizzabile anche da telefono.

Le release più recenti offrono anche l'area di lavoro Desktop in un browser tramite hermes webapp. Si tratta di un'interfaccia gateway separata, con una propria porta e impostazioni per l'URL pubblico; le istruzioni seguenti riguardano il dashboard.

Per impostazione predefinita, il dashboard è in ascolto su 127.0.0.1:9119 e apre una scheda del browser direttamente sul server, cosa inutile su un VPS headless (virtual private server). Avvialo senza il browser e controlla il socket:

hermes dashboard --no-open
ss -lntp | grep 9119

Un listener su 127.0.0.1:9119 è raggiungibile solo dal server. Un listener su 0.0.0.0:9119 è raggiungibile da ogni rete a cui è collegata la macchina, compresa la rete pubblica. Questa singola riga determina il livello di esposizione del server, quindi leggila invece di dare per scontato il comportamento.

Opzione 1: una mesh privata con Tailscale

Scegli questa opzione, salvo esigenze specifiche. Tailscale è una VPN mesh (rete privata virtuale) basata su WireGuard. Ogni dispositivo che registri riceve un indirizzo stabile e si connette direttamente agli altri dispositivi oppure tramite un relay crittografato. Anche il telefono entra nella stessa mesh, quindi la dashboard non deve esporre alcuna porta pubblica.

Sul server:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4

Installa l'app Tailscale sul telefono e accedi con lo stesso account. tailscale status sul server elenca quindi il telefono in base al nome. Ora associa la dashboard all'indirizzo restituito da tailscale ip -4:

hermes dashboard --host 100.101.102.103 --port 9119 --no-open

L'associazione all'indirizzo della mesh, invece che a 0.0.0.0, fa sì che il socket accetti soltanto connessioni indirizzate a quell'IP della mesh. Una scansione delle porte sull'indirizzo IP pubblico non trova nulla sulla porta 9119, perché su quell'indirizzo non è in ascolto alcun servizio. Tuttavia, questa configurazione non vincola il socket all'interfaccia Tailscale. La documentazione del kernel Linux lo afferma chiaramente: gli indirizzi IP appartengono all'host nel suo complesso, non a interfacce specifiche. Un pacchetto indirizzato a 100.101.102.103 che arriva sull'interfaccia pubblica, inviato da una macchina sulla stessa rete del provider, può comunque raggiungere la dashboard. Per vincolare anche l'interfaccia, mantieni ufw con il criterio predefinito di rifiuto del traffico in ingresso e consenti la porta soltanto sulla mesh con sudo ufw allow in on tailscale0 to any port 9119 proto tcp. Verifica nuovamente il listener con ss -lntp | grep 9119.

L'indirizzo di bind determina anche l'autenticazione, ed è questo il punto che spesso viene trascurato. In v2026.8.3, una dashboard associata a 127.0.0.1 non richiede alcun login, anche quando public_url è configurato. Su qualsiasi altro indirizzo il controllo di autenticazione è obbligatorio e, se non è configurato alcun provider, il server rifiuta di avviarsi. Il progetto definisce questo comportamento come chiusura sicura in caso di errore. Esegui il programma in modo interattivo la prima volta: proporrà di impostare subito un nome utente e una password, salvati come dashboard.basic_auth in ~/.hermes/config.yaml. Puoi configurare lo stesso provider anche tramite ~/.hermes/.env, come nell'esempio funzionante della documentazione del progetto:

HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-string

Genera il secret con openssl rand -base64 32, il comando usato dalla documentazione della dashboard del progetto. Il commento nella configurazione richiede almeno 32 byte casuali, in formato base64 o esadecimale. Poi non modificarlo. Il secret firma i token di sessione del provider delle password, quindi cambiarlo disconnette tutti i dispositivi che usano quel provider. Lo stesso file contiene le chiavi API del modello, quindi proteggilo con chmod 600 ~/.hermes/.env.

Verifica il controllo da un'altra macchina nella mesh prima di considerarlo affidabile:

curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'

true seguito da ["basic"] indica che il controllo è attivo e che sta rispondendo il provider delle password. La documentazione del progetto è esplicita su questo provider: è destinato a una rete considerata attendibile o a una VPN e non è adatto a una dashboard esposta su Internet. In una mesh, questa è esattamente la situazione in cui ti trovi.

Per usare HTTPS all'interno della tailnet, la configurazione Tailscale Serve riportata di seguito richiede una release più recente con supporto public_url nei controlli Host e WebSocket Origin. Non funziona con il pin v2026.8.3: un bind su loopback accetta soltanto nomi Host di loopback, indipendentemente da public_url. Con quel pin, continua a usare direttamente l'IP della mesh indicato sopra. Dopo l'aggiornamento e la verifica di questi controlli, Serve inoltra le richieste all'indirizzo loopback indicato qui. Per questa configurazione, avvia quindi la dashboard su 127.0.0.1 invece che sull'indirizzo della mesh, quindi:

sudo tailscale serve --bg localhost:9119
sudo tailscale serve status

La documentazione attuale della dashboard Hermes indica di usare come URL pubblico l'origine HTTPS restituita da tailscale serve status:

dashboard:
  public_url: "https://vps.tail1234.ts.net"

Senza quella riga la dashboard rifiuta il nome MagicDNS nell'header Host. Poiché il nome non è un host di loopback, il controllo di autenticazione rimane attivo anche se il backend è in ascolto su loopback. Tailscale termina TLS con un certificato emesso per il nome MagicDNS della macchina, quindi il browser non visualizza più avvisi e il cookie di sessione riceve il flag Secure. Prima abilita MagicDNS e HTTPS Certificates nella pagina DNS della console di amministrazione Tailscale. Leggi anche l'avviso riportato nella stessa pagina: i nomi delle macchine e il nome DNS della tailnet vengono pubblicati nel registro pubblico di trasparenza dei certificati, che chiunque può consultare.

Il costo reale di questa soluzione è il server di coordinamento. Il traffico tra il telefono e il tuo VPS è crittografato end-to-end, anche quando passa attraverso un relay Tailscale DERP, ma l'account che decide quali dispositivi appartengono alla mesh non risiede sul tuo hardware. Se questo aspetto è importante, esegui autonomamente il control plane con Headscale, il server di controllo Tailscale self-hosted, quindi configura i client per usarlo tramite tailscale up --login-server https://headscale.example.com. Se preferisci abbandonare la mesh e configurare manualmente i peer, il confronto tra WireGuard semplice e Tailscale descrive ciò a cui rinunci.

Opzione 2: un endpoint HTTPS pubblico e la trappola al suo interno

A volte una mesh non è disponibile. Un telefono aziendale potrebbe non consentire l'installazione di un client VPN. In questo caso il dashboard passa dietro un reverse proxy. Questa configurazione HTTPS su loopback richiede anche il supporto più recente per gli hostname pubblici descritto sopra; public_url non la abilita su v2026.8.3. Mantieni il dashboard in ascolto sul loopback e lascia che sia Caddy a gestire il certificato:

hermes.example.com {
  reverse_proxy 127.0.0.1:9119
}

Caddy recupera e rinnova autonomamente il certificato. Il suo reverse_proxy inoltra gli upgrade WebSocket senza direttive aggiuntive, necessarie per il terminale integrato nel dashboard. Con nginx devi aggiungere manualmente gli header Upgrade e Connection. Emettere un certificato Let's Encrypt con Certbot su nginx descrive la parte TLS della procedura. Comunica a Hermes il nome pubblico, in modo che i callback di login puntino all'host corretto:

dashboard:
  public_url: "https://hermes.example.com"

Ed ecco la trappola. Il controllo di autenticazione utilizza l'indirizzo di bind, non l'indirizzo da cui proviene la richiesta. Le release attuali attivano il controllo anche quando dashboard.public_url o HERMES_DASHBOARD_PUBLIC_URL specifica un host non di loopback, persino se il backend è in ascolto sul loopback. L'impostazione precedente attiva quindi il controllo e il dashboard rifiuta di avviarsi finché non configuri un provider. Lascia public_url non impostato per mantenere disattivato il controllo, ma il proxy da solo non stabilisce chi può accedere. Il dashboard controlla anche l'header Host. In questa configurazione su loopback, le release attuali accettano i nomi di loopback e l'host dichiarato da public_url, e rispondono con 400 a qualsiasi altro valore. La v2026.8.3 fissata accetta qui soltanto i nomi di loopback e non controlla mai public_url. Caddy inoltra Host del browser senza modificarlo, quindi il blocco precedente senza public_url viene rifiutato e non servito. Il rischio è un proxy che riscrive Host con l'indirizzo del backend. nginx lo fa esattamente per impostazione predefinita: invia il target proxy_pass, a meno che tu non imposti manualmente proxy_set_header Host. Una richiesta di questo tipo supera il controllo e raggiunge un dashboard privo di login. Il WebSocket del terminale aggiunge un controllo Origin: nella Origin fissata, un header HTTP o HTTPS, se presente, deve avere come destinazione l'host associato al bind. Questo blocca un browser che usa il tuo hostname pubblico, ma uno script che non invia affatto Origin supera il controllo. Qualunque sia la configurazione, verifica ciò che hai realmente pubblicato:

curl -s https://hermes.example.com/api/status | jq '.auth_required'

Se l'output è false, Internet è a una sola URL di distanza da un terminale sul server. Non è necessario alcun exploit e nei log non comparirà alcun errore. Se invece la richiesta fallisce con 400, il controllo Host l'ha rifiutata. In una release con supporto per gli hostname pubblici, risolvi impostando public_url e un provider di login, non riscrivendo gli header per aggirare il controllo. Su v2026.8.3, usa il percorso diretto tramite l'IP della mesh oppure esegui prima l'upgrade. Per un dashboard esposto esistono due correzioni e devi applicarne almeno una. Puoi inserire l'autenticazione nel proxy, usando Authentik come provider single sign-on self-hosted tramite forward auth, oppure configurare il provider OIDC (OpenID Connect) del dashboard:

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"

Anche se configurata correttamente, questa opzione ha un limite minimo che non puoi ridurre. Una pagina di login pubblica è raggiungibile e attaccabile da chiunque, e dietro di essa c'è una shell sul tuo VPS. Un nome utente e una password offrono una protezione debole in questo scenario. Per questo la documentazione raccomanda OAuth o OIDC per i bind pubblici. Applica un rate limiting al login, mantieni ufw chiuso a tutto tranne le porte del proxy e SSH e consulta periodicamente il log degli accessi.

Opzione 3: SSH e mosh da un terminale mobile

Il percorso con il minor impegno: installa un'app terminale sul telefono, carica al suo interno una chiave SSH e usa l'interfaccia testuale dell'agent.

ssh you@vps.example.com
tmux new -A -s phone
hermes --tui

tmux new -A -s phone si collega a una sessione denominata phone oppure la crea se non esiste. In questo modo l'agent continua a essere eseguito quando la connessione cade e, alla connessione successiva, torni nello stesso punto. Il modello è lo stesso usato per gestire Claude Code da un telefono.

Usare SSH direttamente su una rete mobile è scomodo, perché la connessione cade ogni volta che il telefono cambia indirizzo o entra in sospensione. Mosh risolve il problema. Usa UDP (user datagram protocol) e sincronizza lo stato del terminale invece di un flusso di byte. Per questo la sessione resta attiva quando passi dal wifi alla rete cellulare:

sudo apt install -y mosh
sudo ufw allow 60000:61000/udp

Dal telefono, esegui mosh you@vps.example.com. Mosh avvia mosh-server tramite la sessione SSH esistente, quindi sposta la sessione su una porta UDP compresa tra 60000 e 61000. Per questo devi aprire questo intervallo. Ogni sessione richiede una porta dedicata. Su un server con poche sessioni simultanee puoi quindi aprire un intervallo più ristretto, ad esempio da 60000 a 60010.

Il costo in termini di sicurezza è diretto. Una sessione SSH è una shell, e una shell può eseguire tutto ciò che l'account può fare. Le richieste di approvazione dell'agent sono quindi l'ultima barriera tra un telefono sbloccato e rubato e i tuoi file. A questo scopo usa un account dedicato non-root, consenti esclusivamente l'autenticazione tramite chiave e completa la procedura per rendere più sicuro SSH su un VPS prima di installare una chiave su un dispositivo che porti con te.

Cosa si interrompe su una rete mobile

Ci sono quattro problemi, e nessuno si risolve modificando una configurazione.

La dashboard termina la sessione mentre non la stai guardando. Il tempo dipende dal provider di autenticazione. Il provider con nome utente e password emette un token di accesso valido per 12 ore per impostazione predefinita, configurato da session_ttl_seconds in dashboard.basic_auth, ma questo valore controlla soltanto la frequenza con cui la dashboard si aggiorna in background, non la durata della sessione autenticata. Ogni aggiornamento genera un nuovo refresh token valido 30 giorni, quindi un accesso con password resta attivo finché non trascorrono 30 giorni senza un aggiornamento. Anche il riavvio del backend termina la sessione se non è configurato un secret di firma persistente tramite HERMES_DASHBOARD_BASIC_AUTH_SECRET o dashboard.basic_auth.secret, perché Hermes genera una nuova signing key a ogni avvio. Il provider OAuth Nous Portal emette access token con un TTL (time to live) di 15 minuti e li rinnova in background tramite un refresh token che ruota a ogni utilizzo, quindi la sola scadenza dell'access token non ti riporta a /login. A farlo è la perdita della sessione di refresh. Nelle release precedenti a v0.21.3 (tag v2026.9.14, pubblicato il 14 September 2026), quando un telefono tornava dall'esecuzione in background poteva inviare più richieste contemporaneamente, riutilizzare il refresh token appena ruotato, attivare il rilevamento del riutilizzo da parte del provider e revocare l'intera sessione. Al ritorno trovavi la schermata di accesso e perdevi tutto ciò che stavi digitando. v0.21.3 fa condividere alle richieste un unico refresh e, sul lato Nous Portal, una sessione di refresh estende ora la propria finestra di 30 giorni a ogni rotazione, anche se 30 giorni di inattività continuano a terminarla. Se mantieni il pin v2026.8.3 indicato all'inizio di questa pagina, aspettati qualche accesso richiesto nuovamente. Non c'è alcun problema. Accedi di nuovo.

Il terminale integrato non sopravvive per impostazione predefinita a una scheda in background. La connessione al terminale documentata dalla dashboard avvia la TUI (text user interface) dietro un PTY e la termina correttamente quando la scheda viene chiusa; alla riapertura ne avvia una nuova. I browser mobili eliminano le schede in background per recuperare memoria, quindi il passaggio a un'altra applicazione per un tempo sufficiente termina quel terminale. La cronologia della chat è al sicuro, perché le sessioni sono memorizzate sul server e hermes sessions list continua a mostrarle. Il server fissato supporta inoltre una connessione keep-alive opzionale tramite un attachment token, che mantiene un PTY scollegato per 30 minuti. Se ti serve una sessione persistente, usa tmux tramite SSH.

Le connessioni inattive terminano senza messaggi. Gli operatori mobili eliminano le connessioni TCP inattive per recuperare le voci nelle tabelle NAT (network address translation), e quando lo schermo è spento il telefono interrompe quasi completamente la gestione della rete. Un WebSocket rimasto inattivo per un certo periodo è di solito già terminato quando sblocchi il telefono, e la pagina si riconnette soltanto dopo che la tocchi. Per questo mosh funziona meglio di SSH su un telefono: non aveva mai una connessione da perdere.

Non viene inviata alcuna notifica. Né la dashboard né una sessione SSH possono riattivare il telefono. Sul dispositivo non è presente alcuna app Hermes, quindi non esiste un percorso verso il servizio di push della piattaforma. Un'esecuzione lunga dell'agent termina e te ne accorgi soltanto la volta successiva in cui controlli.

Le notifiche arrivano tramite il gateway di messaggistica

La soluzione per quest'ultimo problema è il gateway, che offre un modo completamente diverso per raggiungere l'agente. hermes gateway collega l'agente a piattaforme di messaggistica come Telegram, Discord, Slack, WhatsApp, Signal ed email. In questo modo puoi interagire con l'agente direttamente da un'app che dispone già di un canale push sul telefono, gestisce già la consegna in background e gestisce già le interruzioni della rete.

hermes gateway setup
hermes gateway install
hermes gateway status

hermes gateway install registra il gateway come servizio systemd, quindi il servizio torna attivo dopo un riavvio. La fase gateway dell'installer può eseguire questo passaggio al posto tuo, ma l'installer non crea alcuna unit per hermes dashboard. Di conseguenza, il dashboard non torna attivo automaticamente dopo un riavvio. Crea una unit per ogni componente da cui dipendi. La guida creazione di servizi e timer systemd su un VPS descrive il file da creare.

Un job pianificato può inviare un risultato nello stesso modo, senza alcuna conversazione:

hermes send -t telegram -s "Backup report" -f /home/you/report.txt

L'autorizzazione segue qui il principio del diniego predefinito. Se non esistono una allowlist o un pairing approvato e GATEWAY_ALLOW_ALL_USERS non è impostato, ogni utente viene rifiutato. Questo è il punto di partenza corretto. Indica in ~/.hermes/.env gli account autorizzati:

TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789

In alternativa, usa il pairing basato su codice invece di incollare gli ID numerici. È il metodo predefinito per le piattaforme DM di tipo chat e puoi impostarlo esplicitamente con unauthorized_dm_behavior: pair in ~/.hermes/config.yaml. Un account sconosciuto che invia un messaggio all'agente riceve un codice di otto caratteri. Non accade altro finché non lo approvi:

hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789

I codici scadono dopo un'ora, ogni utente può richiederne uno ogni dieci minuti e cinque tentativi non riusciti bloccano l'account.

Limitare l'impatto di un telefono rubato

Un telefono che può raggiungere il tuo agent può eseguire comandi sul server, e i telefoni possono essere smarriti. Decidi subito che cosa può fare la persona che lo possiede.

Mantieni attive le approvazioni. approvals.mode è impostato per impostazione predefinita su smart, che chiede a un modello ausiliario di valutare il rischio e approva automaticamente soltanto i comandi a basso rischio. Impostarlo su off equivale a eseguire tutto con --yolo, mentre HERMES_YOLO_MODE=1 applica la stessa impostazione tramite l'ambiente. Non portare con te un telefono che comunica con un agent quando si trova in quello stato. Imposta approvals.cron_mode: deny, in modo che i job pianificati non possano approvare autonomamente i comandi mentre dormi.

approvals:
  mode: smart
  cron_mode: deny

Riduci lo spazio operativo che l'agent può danneggiare. terminal.backend: docker esegue i comandi all'interno di un container che rimuove tutte le capability Linux, tranne un breve elenco, imposta no-new-privileges e limita il numero di processi. In questo modo il container diventa il confine di sicurezza, invece del prompt. terminal.cwd fissa la directory di lavoro. HERMES_WRITE_SAFE_ROOT limita write_file e patch alle directory specificate, e un tentativo di scrittura al di fuori di esse viene bloccato senza possibilità di ignorare il blocco tramite un'approvazione.

export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermes

Hermes blocca già le scritture in ~/.ssh, ~/.aws, ~/.kube e /etc/sudoers, oltre che nei propri archivi di secret, come ~/.hermes/.env. I file .env del progetto che si trovano altrove sul disco non possono essere letti, ma restano scrivibili. Inoltre rifiuta un elenco rigido di comandi distruttivi, indipendentemente dalle impostazioni di approvazione. Considera queste protezioni come il livello minimo, non come il tuo piano di sicurezza. Esegui l'agent come utente ordinario, mai come root. Lo stesso ragionamento vale per qualunque coding agent lasciato in esecuzione senza supervisione; eseguire Claude Code in sicurezza su un VPS descrive più dettagliatamente questa procedura.

Scrivi quindi i passaggi per revocare l'accesso prima di averne bisogno. Rimuovere il dispositivo dalla console di amministrazione di Tailscale interrompe immediatamente l'accesso alla rete mesh. Cambiare HERMES_DASHBOARD_BASIC_AUTH_SECRET e riavviare invalida tutte le sessioni delle dashboard dei password provider su ogni dispositivo, perché quel valore firma i token di sessione del provider. Eliminare la chiave pubblica del telefono da ~/.ssh/authorized_keys blocca i nuovi accessi SSH con quella chiave; le sessioni SSH e mosh già attive devono essere terminate separatamente. hermes pairing revoke telegram <user-id> rimuove un account di messaggistica. Se il dispositivo conteneva elementi in grado di leggere le chiavi del provider, revocale con hermes auth logout <provider> e generane di nuove presso il provider.

Verifica il risultato invece di darlo per scontato. Questi sono comandi da eseguire sul tuo server; l'output dipende dalla configurazione:

tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deep

I log si trovano in ~/.hermes/logs/. Consultali dopo un incidente e leggili periodicamente anche quando non si è verificato alcun incidente.

FAQ

Esiste un'app mobile ufficiale di Hermes per iOS o Android?

No. Il repository di Hermes include un'interfaccia a riga di comando, una dashboard web e un client desktop Electron per macOS, Windows e Linux. Non esiste una build ufficiale per iOS o Android. Da un telefono puoi usare la dashboard web in un browser, un client SSH oppure una piattaforma di messaggistica collegata tramite hermes gateway. Esistono anche client mobili di terze parti. Si tratta di codice di terze parti che conserva le credenziali del tuo agent, quindi leggi il codice sorgente prima di installarne uno.

Perché la dashboard di Hermes mi disconnette dal telefono?

Dipende dal provider di accesso. Il provider OAuth Nous Portal rilascia token di accesso con un TTL di 15 minuti e li rinnova in background tramite un refresh token a rotazione. La sola scadenza del token di accesso, quindi, non ti reindirizza a /login. Nelle release precedenti a v0.21.3 (tag v2026.9.14), quando un telefono tornava dall'esecuzione in background poteva inviare più richieste contemporaneamente, riutilizzare il refresh token appena ruotato e revocare l'intera sessione. In questo caso era necessario effettuare nuovamente l'accesso. v0.21.3 risolve il problema, ma una sessione di refresh lasciata inattiva per 30 giorni scade comunque. Il provider con nome utente e password usa per impostazione predefinita un token di accesso di 12 ore, configurato tramite session_ttl_seconds. Questa impostazione controlla soltanto la frequenza con cui la dashboard esegue il refresh in background. Il rinnovo avviene tramite un refresh token di 30 giorni, che viene riemesso a ogni refresh. L'accesso con password, quindi, non termina dopo 12 ore. Con questo provider, imposta HERMES_DASHBOARD_BASIC_AUTH_SECRET su un valore casuale stabile. Se questa variabile o dashboard.basic_auth.secret non contiene un secret stabile, Hermes genera una nuova chiave di firma a ogni avvio e ogni riavvio termina la sessione.

Posso pubblicare in sicurezza la dashboard di Hermes su Internet?

Soltanto dopo aver verificato personalmente l'autenticazione. Il gate di autenticazione viene attivato in base all'indirizzo di bind e, nelle release attuali, anche quando dashboard.public_url specifica un host non di loopback. Di conseguenza, una dashboard associata a 127.0.0.1 e pubblicata dietro un reverse proxy senza un URL pubblico configurato non richiede l'accesso. Nel pin v2026.8.3, l'impostazione di public_url non attiva il gate di autenticazione sul loopback e non consente neppure un hostname pubblico nei controlli Host e WebSocket Origin. Usa il percorso diretto tramite l'indirizzo IP della mesh oppure esegui l'upgrade a una release che supporta gli hostname pubblici prima di seguire la configurazione del proxy HTTPS. Il controllo Host rifiuta un proxy che inoltra il tuo hostname pubblico, ma non uno che riscrive Host con l'indirizzo del backend, come nginx fa per impostazione predefinita. Esegui curl -s https://your-host/api/status | jq '.auth_required' e leggi il risultato. Usa OAuth o OIDC invece di nome utente e password, perché la documentazione del progetto indica che il provider con password è destinato a reti attendibili e VPN. Una mesh privata evita del tutto il problema ed è quindi l'impostazione predefinita migliore.

Ho bisogno di un account Tailscale o posso gestire autonomamente il control plane?

Puoi gestirlo autonomamente. Headscale è un'implementazione open del server di coordinamento Tailscale e i client ufficiali Tailscale vi si connettono tramite tailscale up --login-server https://headscale.example.com. In questo modo sei tu a gestire l'elenco dei dispositivi autorizzati ad accedere alla mesh. Devi però eseguire il server e crearne i backup. Quando il server è inattivo, non puoi effettuare l'enrollment o riautenticare un dispositivo.

Come ricevo una notifica sul telefono quando l'agent termina un'attività?

Usa il gateway di messaggistica. La dashboard e SSH non possono riattivare un telefono, perché sul dispositivo non esiste un'app Hermes in grado di ricevere notifiche push. Collega l'agent a Telegram, Signal, Discord o a un'altra piattaforma supportata tramite hermes gateway setup, quindi lascia che sia l'app della piattaforma a consegnare la notifica. Un cron job può anche inviare un singolo messaggio tramite hermes send -t telegram -s "Job done" -f /path/to/report.txt, senza chiamare il modello.

Questo articolo ti è stato utile?