Installare Agent Zero su VPS in sicurezza

Cos'è Agent Zero e dove risiede il pericolo

Agent Zero è un framework di agenti open-source basato su Docker. Un agente primario può generare agenti subordinati, ognuno in esecuzione in un proprio container Docker isolato; ogni agente può eseguire codice, controllare un browser ed eseguire comandi shell. Il controllo avviene tramite una Web UI. È uno strumento potente e funzionale, eseguibile anche su hardware limitato come un VPS da sei dollari.

Il pericolo è la Web UI. È il pannello di controllo di un sistema che esegue comandi e scrive file; pertanto, una Web UI esposta e senza autenticazione rappresenta un punto di accesso remoto per tali operazioni. Molte guide di configurazione contengono un errore critico: il docker run standard pubblica l'interfaccia sulla porta 50001 su ogni interfaccia di rete. Su un VPS pubblico, ciò significa che l'interfaccia è raggiungibile da tutta la rete internet non appena il container viene avviato. Risolvere questo problema è la priorità assoluta.

Requisiti

È necessario un VPS con Docker installato, una chiave API per un modello linguistico (o un modello locale) e almeno un paio di gigabyte di RAM. Agent Zero è eseguibile ovunque sia presente Docker, da un piccolo VPS a un server con GPU. Se non hai esperienza con Docker, consulta la guida ai concetti base di Docker per comprendere i comandi riportati di seguito.

Installazione con Docker, vincolata al loopback

La procedura di avvio rapido documentata consiste in un singolo docker run. La modifica fondamentale rispetto alle versioni standard trovate altrove riguarda l'indirizzo di pubblicazione. Non pubblicare l'interfaccia su tutte le interfacce sulla porta 50001. Pubblica solo sull'indirizzo di loopback:

docker run -d --name agent-zero \
  -p 127.0.0.1:5080:80 \
  -v a0_usr:/a0/usr \
  agent0ai/agent-zero

-p 127.0.0.1:5080:80 vincola la Web UI solo all'indirizzo di loopback del server, rendendola irraggiungibile da internet. Accedila dalla tua macchina tramite un tunnel SSH:

ssh -L 5080:127.0.0.1:5080 you@your-vps

Successivamente, apri http://127.0.0.1:5080 localmente e configura il provider del modello nella UI. Per una configurazione multi-utente permanente, utilizza una VPN o un reverse proxy con autenticazione; non pubblicare mai la UI senza protezione su internet.

Dove si fermano le altre guide e perché non devi farlo

Cercando come installare Agent Zero troverai molte guide, incluse quelle dei provider di hosting, che si limitano a configurare una Web UI funzionante sulla porta 50001. Il rischio inizia proprio in quel punto. Sono necessari due passaggi aggiuntivi. Primo, mantieni la UI privata come descritto sopra. Secondo, installa un firewall con politica di default-deny per evitare che un container errato o un errore futuro esponga una porta dimenticata:

sudo ufw default deny incoming
sudo ufw allow 22/tcp
sudo ufw enable

Consulta le basi del firewall per una panoramica completa e presta attenzione al gap IPv6, poiché un servizio su :: è raggiungibile via IPv6 anche se le regole IPv4 sono configurate correttamente.

L'isolamento dei container protegge gli agenti, non il server

Il design di Agent Zero è efficace per un tipo di isolamento: gli agenti subordinati operano in container separati, rimanendo isolati tra loro. Questo è un vantaggio. Tuttavia, non confondere questo aspetto con la sicurezza totale del sistema. L'isolamento dei container protegge gli agenti l'uno dall'altro. Non protegge il server da internet e non impedisce a una Web UI esposta di cedere il controllo a un utente esterno. La sicurezza dell'host è responsabilità dell'amministratore.

Segreti, utenti e host

Mantieni la chiave API del modello e qualsiasi altra credenziale nei file di configurazione di Agent Zero o in un file di ambiente accessibile solo all'account autorizzato. Non salvare queste informazioni nella cronologia della shell o in repository. Gestisci il server utilizzando un utente non privilegiato invece di root, seguendo le linee guida per utenti con privilegi minimi, e configura SSH per l'autenticazione tramite chiave, come indicato in hardening di SSH. Segui la checklist seguente per garantire la massima sicurezza:

Se stai confrontando diversi agenti, la postura di sicurezza è la stessa utilizzata da la guida all'hardening di OpenClaw e la guida di OpenHands: mantieni la superficie di controllo privata, esegui i processi come utente non privilegiato, usa un firewall di default e tratta l'host come un sistema che esegue codice non scritto dall'utente. Per un confronto tra tutti e cinque gli agenti, consulta i migliori agenti AI self-hosted nel 2026.

I concetti alla base di questi strumenti sono trattati in costruire il proprio agente AI su un VPS; Dify è un'altra piattaforma self-hostable degna di confronto.

FAQ

L'auto-hosting di Agent Zero è sicuro?

Sì, a condizione di mantenere la Web UI privata e proteggere l'host. Agent Zero esegue codice, un browser e una shell, ed è controllato da una Web UI che di default pubblica sulla porta 50001; il pericolo è quindi l'interfaccia esposta, non il framework. Vincola la UI al loopback, accedi tramite SSH o VPN, imposta un firewall con policy default-deny ed esegui il servizio come utente non privilegiato.

Agent Zero espone una Web UI su internet di default?

Il docker run standard pubblica l'interfaccia sulla porta 50001 su ogni interfaccia di rete. Su un VPS pubblico, questo rende l'interfaccia raggiungibile da internet non appena il container viene avviato. Modifica l'indirizzo di pubblicazione in 127.0.0.1 per far sì che la UI risponda solo sul loopback, quindi accedi tramite tunnel SSH o VPN.

Agent Zero può essere eseguito su un piccolo VPS?

Sì. Agent Zero è eseguibile ovunque sia presente Docker, inclusi i VPS economici, sebbene i carichi di lavoro intensi e i modelli locali di grandi dimensioni richiedano più memoria. Se utilizzi un modello self-hosted invece di un'API esterna, dimensiona il server in base alle necessità del modello, non solo di Agent Zero.

Qual è la differenza tra Agent Zero, OpenClaw o Hermes?

I prodotti presentano sovrapposizioni ma obiettivi diversi. Agent Zero è un framework basato su Docker che utilizza un agente primario per generare agenti subordinati in container isolati, controllati tramite Web UI. OpenClaw e Hermes sono assistenti personali accessibili tramite app di messaggistica. La postura di sicurezza è identica per tutti: mantenere la superficie di controllo privata e proteggere l'host.