HarnessRouter self-hosted: API unica per gli agenti
Scopri il deployment Docker di HarnessRouter, il bind su loopback, il login iniziale da modificare e l’accesso TLS per Codex, Claude Code e Hermes.
Cosa elimina HarnessRouter
Esegui HarnessRouter Community Edition in modalità self-hosted per mettere un’unica API davanti a diversi harness per agenti su un server di tua proprietà. Un harness per agenti è il programma a riga di comando che gestisce un modello in un ciclo continuo: mantiene una sessione, modifica file, esegue comandi e trasmette l’avanzamento al componente che ha richiesto il lavoro. Codex, Claude Code e Hermes svolgono tutti questo compito, ma ciascuno ha una propria procedura di installazione, un proprio formato per le credenziali e una propria gestione delle sessioni. HarnessRouter li esegue tutti all’interno di un unico container e mette davanti un endpoint HTTP, un unico accesso e un unico archivio dei secret.
Questa è l’idea principale, ma è importante esplicitarne il costo. Aggiungi un container, un accesso, un volume e una procedura di aggiornamento al server affinché diversi componenti diventino uno solo. Se oggi esegui un solo harness, questa configurazione è peggiore rispetto all’installazione diretta di quell’harness. Questo compromesso viene esaminato nell’ultima sezione, quindi leggila prima di eseguire il deployment.
Tutto quanto segue è stato verificato rispetto al tag dell’immagine 0.5.5, scaricata il 19 agosto 2026. Il progetto pubblica nuovi tag quasi ogni giorno, quindi controlla il tag effettivamente in esecuzione invece di fare affidamento su questa pagina tra un mese. L’8 novembre 2026 questa pagina è stata verificata nuovamente rispetto alla documentazione e al codice sorgente correnti del progetto: in quel momento latest puntava a 0.38.5 e i punti in cui le versioni correnti si comportano diversamente lo indicano esplicitamente. I comandi provengono dal repository del progetto, disponibile all’indirizzo github.com/HarnessRouter/harnessrouter. Si trovavano nel README alla versione 0.5.5; i dettagli della configurazione si trovano ora in docs/self-hosting-guide.md nello stesso repository.
Che cos'è realmente l'Unified Harness Protocol
HarnessRouter implementa l'Unified Harness Protocol (UHP), pubblicato su unifiedharnessprotocol.org. UHP descrive come un prodotto avvia un'attività su un harness, la segue durante l'esecuzione, gestisce sessioni e file e segnala gli errori. La specifica è versionata in base alla data. La versione in vigore al 19 agosto 2026 era datata 2026-08-11. All'8 novembre 2026 il sito indica 2026-10-19 come versione corrente e la definisce ancora uno standard in bozza, «abbastanza stabile per costruirci sopra e versionato in modo da poter cambiare senza rischi».
Qui è importante interpretare con attenzione l'espressione «standard aperto». La stessa azienda scrive la specifica, l'implementazione di riferimento e la suite di conformità che stabilisce chi è conforme; inoltre, le regole di governance del progetto prevedono che nessuna modifica venga integrata se tutti e tre questi elementi non vengono aggiornati insieme. Al 9 novembre 2026 la home page del protocollo descrive la suite come composta da 110 controlli eseguibili, mentre la pagina sulla conformità ne indica 101 e l'esecuzione di riferimento registrata nella guida per il self-hosting, datata 4 settembre 2026, ne ha superati 64. I conteggi pubblicati quindi non coincidono. Il changelog del progetto data al 4 novembre 2026 i sei controlli aggiuntivi per i branching. È una situazione normale per un protocollo così recente e la licenza Apache-2.0 consente di creare un fork di qualsiasi sua parte. Significa anche che UHP non è ancora uno standard multi-vendor. Consideratelo un protocollo emergente: utile, in evoluzione e tale per cui il vostro codice dovrebbe poter smettere di usarlo senza richiedere una riscrittura.
Prerequisiti
Docker e circa 4 GB di spazio libero su disco. Serve anche una chiave API di un provider di modelli per cui si dispone già di un abbonamento. Il download dell’immagine richiede circa 700 MB; lo spazio restante viene utilizzato dalle CLI degli agenti e dai workspace in cui scrivono. Nell’immagine non sono inclusi modelli né chiavi di prova, quindi le attività falliscono finché non si collega un provider. HarnessRouter è distribuito con licenza Apache-2.0. Le CLI degli agenti restano soggette alle rispettive licenze e condizioni d’uso, che la licenza del repository non sostituisce; vengono scaricate al primo avvio e non sono incluse nell’immagine.
Self-host HarnessRouter con un solo docker run
docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter \
-p 127.0.0.1:3000:3000 \
-v harnessrouter:/data \
harnessrouter/harnessrouterQuindi monitora l'avvio del container. Il primo avvio è lento e i log spiegano il motivo.
docker logs -f harnessrouterDurante l'avvio vedrai righe simili a queste:
installing Claude Code (Anthropic's terms apply)…
installing Codex (Apache-2.0)…
installing Hermes (check its upstream license before use)…Attendi ready on :3000. La guida attuale misura circa mezzo minuto da quando docker run restituisce il prompt, non da quella riga; se http://localhost:3000 non risponde subito dopo la riga che indica che il servizio è pronto, riprova dopo alcuni secondi. Le CLI installate vengono memorizzate nel volume, quindi gli avvii successivi sono in genere molto più rapidi. Tuttavia, un backend aggiunto in seguito, oppure uno la cui installazione precedente non è riuscita, può ancora richiedere attività di installazione.
Da questo download derivano due aspetti, entrambi importanti su un VPS. Primo: il primo avvio richiede l'accesso alla rete in uscita. L'immagine non è autosufficiente. Un sistema protetto da un filtro sul traffico in uscita, o privo di una route verso l'esterno, non può scaricare le CLI degli agenti. Sia 0.5.5 sia le versioni attuali trattano le installazioni non riuscite come errori non bloccanti e le indicano nei log. Controlla quindi quali backend la riga backends available: non elenca. Secondo: stai installando software di terze parti soggetto a condizioni di licenza di terze parti. Claude Code è distribuito secondo le condizioni di Anthropic, mentre Hermes è soggetto alle condizioni indicate dal relativo progetto upstream. Verifica entrambe prima di utilizzare il software per scopi commerciali.
-v harnessrouter:/data crea un volume Docker denominato. Tutti i dati persistenti si trovano in /data: i database SQLite, i file memorizzati, l'archivio dei secret e gli workspace degli agenti. Se elimini il volume, elimini l'istanza, incluse le chiavi dei provider e tutte le trascrizioni. Esegui il backup con il container arrestato. La copia di un database SQLite durante una scrittura può produrre un file che non si apre. La stessa procedura, basata prima sull'arresto e poi sulla copia, vale per tutti i container con stato presenti sul sistema. I dettagli variano in base al servizio, perché PhotoPrism e Immich richiedono ciascuno i propri comandi di backup.
docker stop harnessrouter
docker run --rm -v harnessrouter:/data -v "$PWD":/backup alpine \
tar czf /backup/harnessrouter-data.tgz -C / data
docker start harnessrouterLa variante Compose e la riga da modificare
Il repository include un file Compose. Ora pubblica "127.0.0.1:3000:3000", associando la porta dell'host all'interfaccia loopback. Il file 0.5.5 pubblicava "3000:3000"; modificate quella riga se usate il file precedente su un server pubblico.
services:
harnessrouter:
image: harnessrouter/harnessrouter:0.5.5
ports:
- "127.0.0.1:3000:3000"
env_file:
- .env
volumes:
- harnessrouter-data:/data
restart: unless-stopped
volumes:
harnessrouter-data:Un elemento differisce dall'upstream corrente: è presente un tag di versione fissato invece di latest. Il pinning è importante perché le release cambiano rapidamente: al controllo dell'8 novembre 2026, Docker Hub indicava che sia 0.38.4 sia 0.38.5 erano state pubblicate nel giorno precedente. Un runtime per agenti che cambia senza preavviso è difficile da diagnosticare. Fissate la release corrente invece di copiare 0.5.5 da questa pagina; il 9 novembre 2026 era 0.40.0. Copiate quindi il file dell'ambiente, proteggetene i permessi e avviate il servizio.
cp .env.example .env
chmod 600 .env
docker compose up -d
docker compose logs -f.env contiene la chiave del provider in testo normale, quindi la modalità 600 è il minimo necessario. Se il sottocomando docker compose non vi è familiare, la scheda di riferimento dei comandi Docker Compose descrive le operazioni quotidiane.
Perché la porta è pubblicata su 127.0.0.1 e non su 0.0.0.0
-p 3000:3000 pubblica la porta su tutte le interfacce dell'host per impostazione predefinita. -p 127.0.0.1:3000:3000 pubblica la porta dell'host sull'interfaccia loopback. Le versioni di Docker precedenti a 28.0.0 consentono agli host dello stesso segmento L2 di raggiungere le porte pubblicate su localhost; inoltre, il routing diretto abilitato esplicitamente può esporre la porta del container nonostante la mappatura della porta dell'host sulla loopback. Il container resta in ascolto sulla porta 3000 al suo interno per impostazione predefinita; puoi configurarla tramite PORT. Modifica quindi il numero della porta a sinistra per evitare conflitti con una porta dell'host. Verifica il risultato:
docker port harnessrouter
sudo ss -ltnp | grep 3000L'output di ss che mostra 127.0.0.1:3000 è corretto. 0.0.0.0:3000 indica che la console è associata a tutte le interfacce IPv4; l'accesso da Internet dipende comunque dal routing e dal filtraggio. In questo caso è un rischio maggiore rispetto alla maggior parte delle applicazioni self-hosted, perché la console crea harness, legge ogni trascrizione, esegue agenti e fornisce a tali agenti una shell e un filesystem reale nella relativa workspace. Inoltre contiene la chiave del provider che hai collegato. Chiunque raggiunga una console non protetta può leggere il tuo lavoro, eseguire comandi e utilizzare la tua chiave.
Una regola di negazione ufw non è sufficiente. Docker devia il traffico dei container pubblicati attraverso regole proprie prima delle chain gestite da ufw; pertanto, il fatto che sudo ufw status mostri una porta come negata non dimostra che la porta pubblicata sia bloccata. Esegui il test da un'altra macchina, non dal VPS, altrimenti non verificherai nulla. È lo stesso principio illustrato in eseguire dsh senza interfaccia su port 3080: associa il servizio alla loopback, quindi stabilisci consapevolmente come raggiungerlo.
Modificare l'accesso predefinito prima di procedere
Accedi a http://localhost:3000 con il nome utente harnessrouter e la password iniziale generata dall'istanza. Leggila con:
docker exec harnessrouter cat /data/selfhost-initial-passwordLa password condivisa harnessrouter funzionava in 0.5.5; le installazioni attuali non accettano quel valore predefinito pubblicato.
Modificala dalla pagina Profile oppure impostala all'avvio per una distribuzione tramite script. HR_AUTH_USER e HR_AUTH_PASSWORD forniscono le credenziali iniziali; le credenziali salvate da Profile hanno la precedenza.
docker run -d --name harnessrouter \
-p 127.0.0.1:3000:3000 \
-v harnessrouter:/data \
-e HR_AUTH_USER='you' \
-e HR_AUTH_PASSWORD='the-password-you-chose' \
harnessrouter/harnessrouterPer l'accesso locale alla Console non esiste un messaggio email per reimpostare la password. Se perdi la password, elimina il file di autenticazione nel volume e riavvia. Accedi quindi con HR_AUTH_USER e HR_AUTH_PASSWORD configurati oppure, se non hai specificato credenziali personalizzate, con la password iniziale generata.
docker stop harnessrouter
docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json
docker start harnessrouterHR_AUTH_DISABLED=1 rimuove completamente il controllo di accesso. La guida per il self-hosting lo definisce «accettabile soltanto su una macchina non raggiungibile da nessun altro». Un VPS con un indirizzo IP pubblico non è quella macchina. Lascia quindi attivo il controllo di accesso, a meno che tu non stia eseguendo il servizio su un laptop.
Verifica la versione: quelle meno recenti non hanno alcuna protezione
Questa è la parte da prendere sul serio. Le versioni 0.1.x e 0.2.0 sono state rilasciate senza alcun meccanismo di autenticazione: chiunque potesse raggiungere la porta 3000 aveva già accesso alla console. 0.3.0 è stata la prima release con accesso tramite login. In questa pagina, il 12 ottobre 2026, questi tag meno recenti risultavano pubblicati e disponibili per il pull; la loro disponibilità attuale non è stata verificata l'8 novembre 2026.
Al 19 agosto 2026, il tag pubblicato più recente era 0.5.5, datato 18 agosto 2026. L'8 novembre 2026 latest indicava 0.38.5. Verifica quale versione stai usando, quindi confrontala con l'elenco dei tag su Docker Hub:
docker image ls harnessrouter/harnessrouterQualsiasi versione precedente a 0.3.0 deve essere sostituita subito, non pianificata per un secondo momento. Nelle release meno recenti con la password predefinita condivisa è ancora necessario cambiarla; le installazioni attuali generano una password iniziale e chiedono di sceglierne una personalizzata. Non considerare aggiornati i numeri di versione riportati in questa pagina. Erano validi alle date indicate e questo progetto rilascia nuove versioni rapidamente.
Collegare un provider
Nulla viene eseguito finché non viene collegato un provider di modelli. Aggiungetene uno dalla sezione Bring your own key del menu dell'account oppure passatelo a docker run nell'ambiente. Il valore è in formato JSON, quindi racchiudetelo tra virgolette nella shell:
-e HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC='{"name":"anthropic","provider":"anthropic","api_key":"sk-ant-…"}'.env.example assegna una variabile di connessione a ogni famiglia di provider: HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC per il backend claude-code, HR_SECRET_GLOBAL_HARNESS_CONN_OPENAI per il backend codex, HR_SECRET_GLOBAL_HARNESS_CONN_GOOGLE per il backend gemini e HR_SECRET_GLOBAL_HARNESS_CONN_CUSTOM per qualsiasi endpoint compatibile con OpenAI, cioè il punto in cui si colloca un aggregatore o il vostro server di inferenza. Le variabili HR_SECRET_GLOBAL_HARNESS_POLICY_CLAUDE, HR_SECRET_GLOBAL_HARNESS_POLICY_CODEX e HR_SECRET_GLOBAL_HARNESS_POLICY_HERMES corrispondenti indicano quale connessione usa per impostazione predefinita ciascun backend; inoltre esiste una variabile di policy per ogni backend. HR_SECRET_KEY è un elemento distinto. Le release correnti cifrano le credenziali memorizzate usando questo valore e generano una chiave in /data/secret-key quando non ne fornite una. Mantenete la stessa chiave tra riavvii e aggiornamenti; per conservarla separatamente dai dati di un'istanza esistente, impostate HR_SECRET_KEY sul valore contenuto in quel file ed eliminate il file.
HR_BACKENDS seleziona i backend da installare e caricare, come nell'esempio HR_BACKENDS=claude,codex,hermes. Se lasciata non impostata, nelle release correnti viene installato un elenco predefinito molto più lungo, composto da 30 backend, tra cui claude, codex e hermes, oltre a opencode, gemini, goose e altri. Ridurre l'elenco consente quindi di risparmiare spazio su disco e tempo al primo avvio. La guida corrente per il self-hosting indica di «escludere da HR_BACKENDS quelli che non si intende usare» e il relativo esempio minimale è HR_BACKENDS=opencode, che esclude completamente Hermes. Se un backend non viene installato, il problema non è fatale: gli altri continuano a funzionare e un'attività assegnata a un backend non installato viene rifiutata con il messaggio «not installed», mentre il log del container indica quale installazione non è riuscita. Il README di 0.5.5 riportava un problema noto: escludendo hermes il container usciva immediatamente con stato 1 senza messaggi di errore. Tuttavia, l'entrypoint di quel tag corregge già il problema; i relativi commenti descrivono l'implementazione precedente. Se volete usare soltanto l'harness Hermes, eseguire l'agente Hermes sul proprio VPS è la soluzione con il deployment più semplice.
Chiamare l’API senza la console
La console è facoltativa. La stessa API serve entrambi i componenti e utilizza un contratto in stile Responses. Eseguire prima l’accesso per ottenere un cookie di sessione:
curl -c hr.cookies http://localhost:3000/api/selfhost/login \
-H 'content-type: application/json' \
-d '{"username":"harnessrouter","password":"your-password"}'Inviare quindi un’attività, specificando l’harness in metadata.harness_id e un modello effettivamente fornito dal provider collegato:
curl -s -b hr.cookies http://localhost:3000/api/harness/v1/responses \
-H 'content-type: application/json' \
-d '{"input":"Reply with exactly this and nothing else: it works.",
"metadata":{"harness_id":"codex"},
"model":"gpt-5.4-mini",
"stream":false}'Un oggetto JSON che contiene un blocco di output e un conteggio dei token indica che l’harness è stato eseguito. Modificando harness_id da codex a claude-code, la stessa richiesta viene inviata a un harness diverso. Questo scambio è l’intero motivo per cui esiste questo software. L’ID è claude-code, anche se il nome del backend è HR_BACKENDS e la variabile di policy è claude. La connessione personalizzata configurata sopra consente di indirizzare un harness verso un endpoint compatibile con OpenAI già ospitato, come nel caso di un harness DeepSeek self-hosted su un VPS.
Il flusso basato sul cookie di sessione resta supportato per il debug locale. Per un backend di prodotto, la documentazione attuale consiglia di creare una chiave API HarnessRouter in API Keys e inviarla come token Bearer invece di mantenere una sessione della console.
Accedervi dal laptop senza pubblicare una porta
Esistono due modalità e nessuna delle due espone direttamente una porta su 0.0.0.0.
Un tunnel SSH è la soluzione più semplice e non richiede software installato sul server. Inoltra una porta locale del computer al loopback sul VPS.
ssh -N -L 3000:127.0.0.1:3000 you@your-vpsLasciate il tunnel attivo e aprite http://localhost:3000 nel browser. Se SSH visualizza bind: Address already in use, sul laptop è già in uso la porta 3000. Scegliete quindi un’altra porta locale con -L 3100:127.0.0.1:3000 e accedete alla porta 3100.
Un reverse proxy con terminazione TLS è la soluzione adatta quando devono accedere anche altre persone. Il proxy gestisce il certificato TLS (transport layer security) e inoltra le richieste al loopback. La guida per il self-hosting include una configurazione Caddy:
console.example.com {
encode zstd gzip
reverse_proxy 127.0.0.1:3000 {
flush_interval -1 # agent turns stream for minutes; never buffer them
}
}flush_interval -1 disabilita esplicitamente il buffering delle risposte di Caddy. Caddy invia già immediatamente le risposte text/event-stream senza questa impostazione. Agent trasmette i token dello stream per diversi minuti. Un proxy che esegue il buffering della risposta trattiene questi token fino al termine del turno. Di conseguenza, la console sembra bloccata e poi visualizza tutto in una volta. L’impostazione equivalente in Nginx è proxy_buffering off; all’interno del blocco location. Qualunque soluzione scegliate, mantenete il nome DNS puntato al proxy e il container in ascolto sul loopback. La guida Confronto tra Nginx, Caddy e Traefik come reverse proxy illustra quale soluzione è più adatta al vostro server.
Eseguilo con un utente dedicato, non come root
Il demone Docker viene eseguito come root e appartenere al gruppo docker equivale ad avere privilegi root, perché un membro può avviare un container che monta il filesystem dell’host. Quindi, «aggiungere il team al gruppo docker» concede l’accesso root al server che contiene la chiave del provider.
La versione più semplice consiste nel creare un account di servizio proprietario del file Compose e di .env, mantenendo questi file fuori da qualsiasi directory home condivisa.
sudo adduser --disabled-password --gecos "" harness
sudo install -d -o harness -g harness -m 750 /srv/harnessrouterNon cercare di ottenere questo risultato aggiungendo --user a docker run o user: al file Compose. La guida attuale indica che il container deve essere avviato come root e, da 0.8.2, rifiuta di avviarsi in qualsiasi altro modo, registrando un’unica riga nel log che lo indica.
L’opzione più sicura è Docker rootless, in cui lo stesso demone viene eseguito dall’utente non privilegiato. Richiede il pacchetto uidmap per newuidmap e newgidmap e almeno 65536 UID subordinati in /etc/subuid e /etc/subgid per l’utente. uidmap è disponibile nell’archivio Ubuntu, mentre docker-ce-rootless-extras non lo è: viene distribuito tramite il repository apt di Docker all’indirizzo download.docker.com, aggiunto dall’installazione del motore Docker. Se il motore non è stato installato da quel repository, grep -rl download.docker.com /etc/apt/sources.list.d/ non restituisce alcun output e l’installazione seguente non troverà il pacchetto.
sudo apt install -y uidmap docker-ce-rootless-extras
sudo loginctl enable-linger harness
sudo -iu harness
dockerd-rootless-setuptool.sh install
export DOCKER_HOST=unix:///run/user/$(id -u)/docker.sock
systemctl --user enable --now dockerloginctl enable-linger mantiene in esecuzione l’istanza systemd dell’utente dopo il logout e la avvia al boot. Verifica il risultato con docker info, che elenca rootless nella sezione Security Options. La modalità rootless non può associare porte inferiori a 1024 senza una configurazione aggiuntiva. In questo caso non è un problema, perché la porta 3000 è superiore a tale limite. La configurazione dell’account è descritta in creare utenti con privilegi minimi su un VPS.
Cosa non funziona e cosa vedrai
Il container si arresta un secondo dopo l'avvio e i log sono vuoti. docker ps -a mostra Exited (1). Un entrypoint precedente non funzionava quando HR_BACKENDS ometteva hermes, ma 0.5.5 contiene già la correzione, anche se il relativo README continua a riportare il problema. Non diagnosticare l'errore basandoti solo sullo stato di uscita. In un tag recente, leggi l'ultima riga di docker logs: a partire da 0.8.2, un container avviato con --user si arresta e mostra una riga che indica che deve essere avviato come root.
Il primo avvio non termina mai. Il log si interrompe dopo una riga installing e ready on :3000 non compare mai. Verifica che il server possa raggiungere la rete per scaricare le CLI degli agenti, perché non sono incluse nell'immagine. Sia 0.5.5 sia le release attuali tollerano gli errori di installazione conclusi, indicano nel log le installazioni non riuscite e le escludono dalla riga backends available:. Correggi il routing in uscita o le impostazioni del proxy, quindi riavvia.
La console viene caricata, ma ogni attività non riesce. Non è connesso alcun provider. L'immagine non include alcun modello e alcun piano gratuito, quindi una nuova istanza può consentire l'accesso senza eseguire nulla.
La console si blocca a metà della risposta dietro un proxy. L'output viene visualizzato in un unico blocco al termine dell'elaborazione. Si tratta del buffering della risposta. Imposta flush_interval -1 in Caddy oppure proxy_buffering off; in Nginx.
Non riesci a raggiungerla dal laptop, anche se il tunnel è attivo. Esegui docker port harnessrouter sul server. Se non visualizza nulla, il container non pubblica alcuna porta; controlla quindi la mappatura delle porte e la modalità di rete.
Vale la pena eseguirlo?
Vale la pena eseguirlo se usi realmente più di un harness e vuoi un solo endpoint e un solo archivio delle credenziali, invece di tre endpoint e tre archivi. Vale anche la pena eseguirlo se stai sviluppando un prodotto basato su questa soluzione e vuoi che l’harness sia un valore di configurazione, anziché richiedere una riscrittura. È questo il vantaggio offerto da UHP, tenendo conto della precedente avvertenza sul fatto che il protocollo è ancora recente.
Non vale la pena eseguirlo se usi un solo harness. Installare la relativa CLI sul server comporta meno componenti, e nessun login si interpone tra te e il servizio. Non è inoltre la soluzione adatta se vuoi più agenti che collaborano alla stessa attività invece di una singola API davanti a più harness: si tratta di uno strumento diverso. Per questo modello, vedi un harness multi-agent come Omnigent. In ogni caso, le regole di deployment non cambiano: bind su loopback, password modificata, release corrente fissata e un utente dedicato.
FAQ
È sicuro pubblicare HarnessRouter sulla porta 3000?
No. La console crea harness, legge ogni trascrizione, esegue agent con accesso alla shell e al filesystem e conserva la chiave del provider collegato. Una console non protetta espone quindi tutti questi elementi. Pubblicala sul loopback con -p 127.0.0.1:3000:3000 e raggiungila tramite un tunnel SSH o un reverse proxy con terminazione TLS. Una regola di deny ufw non è sufficiente da sola: Docker devia il traffico pubblicato dal container prima delle chain gestite da ufw. Verifica con sudo ss -ltnp | grep 3000, che dovrebbe stampare 127.0.0.1:3000, quindi prova l’accesso da un altro computer. Usa Docker 28.0.0 o versioni successive per evitare la precedente esposizione del loopback sulla stessa rete L2 e verifica che il routing diretto non sia stato abilitato.
Quale versione di HarnessRouter ha aggiunto il controllo di accesso?
0.3.0. Le versioni 0.1.x e 0.2.0 sono state rilasciate senza alcuna autenticazione, quindi chi le esegue si affida al fatto che nessuno individui la porta. Questa pagina ha registrato per l’ultima volta quei tag come pubblicati e disponibili per il pull il 12 ottobre 2026; la loro disponibilità attuale non è stata verificata l’8 novembre 2026. Al 19 agosto 2026 il tag più recente era 0.5.5, datato 18 agosto 2026; l’8 novembre 2026 latest puntava a 0.38.5. Esegui docker image ls harnessrouter/harnessrouter per vedere quale versione è installata, confrontala con l’elenco dei tag su Docker Hub anziché con questa pagina e scegli una password personale. Le installazioni attuali generano una password iniziale invece di accettare il vecchio valore predefinito condiviso.
Perché il container termina subito dopo che imposto HR_BACKENDS?
In una release attuale non dovrebbe accadere. La guida per il self-hosting indica di omettere i backend che non si intende usare e specifica che l’installazione non riuscita di un backend non è fatale. Un’implementazione precedente terminava con lo stato 1 e senza messaggi di errore quando hermes era omesso, ma il codice sorgente 0.5.5 corregge già questo problema, anche se il relativo README lo indica ancora. In un tag recente, leggi docker logs: a partire da 0.8.2, un container avviato con --user termina visualizzando una riga che indica che deve essere avviato come root.
HarnessRouter deve avere accesso a Internet al primo avvio?
Sì. Le CLI degli agent vengono scaricate al primo avvio invece di essere incluse nell’immagine e ciascuna resta soggetta alla propria licenza e ai relativi termini. Sia 0.5.5 sia le release attuali registrano nel log le installazioni non riuscite e consentono l’avvio degli altri backend. Le CLI installate vengono memorizzate nella cache del volume, quindi gli avvii successivi sono generalmente più rapidi. Tuttavia, gli strumenti dei backend e le attività eseguite possono comunque richiedere l’accesso alla rete e un backend nuovo o la cui installazione era fallita può avviare una nuova installazione.
Ho perso la password della console. Come posso accedere di nuovo?
Non esiste un’e-mail per reimpostare l’accesso locale alla Console. Arresta il container, elimina /data/selfhost-auth.json dal volume, riavvialo, quindi accedi con HR_AUTH_USER e HR_AUTH_PASSWORD configurati oppure con la password iniziale generata se non ne hai specificata una. Imposta quindi una nuova password dalla pagina Profile. Se il container e il volume hanno entrambi il nome harnessrouter, la procedura consiste nell’eseguire docker stop harnessrouter, poi docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json e infine docker start harnessrouter. Leggi la password generata con docker exec harnessrouter cat /data/selfhost-initial-password.