Jak bezpiecznie zainstalować Agent Zero na VPS

Czym jest Agent Zero i gdzie leży zagrożenie

Agent Zero to framework agentowy typu open-source, oparty na technologii Docker. Główny agent może tworzyć agentów podrzędnych, z których każdy działa w osobnym, izolowanym kontenerze Docker. Każdy z nich może wykonywać kod, obsługiwać przeglądarkę oraz uruchamiać polecenia shell. Zarządzanie odbywa się poprzez Web UI. Framework jest wydajny i łatwy w obsłudze, a może działać nawet na tanich serwerach VPS za 6 dolarów.

Zagrożeniem jest Web UI. Jest to panel sterowania systemem, który wykonuje polecenia i zapisuje pliki, zatem wystawienie niezabezpieczonego Web UI umożliwia zdalne przejęcie kontroli. Większość instrukcji instalacji zawiera pułapkę: standardowy docker run udostępnia interfejs na porcie 50001 na wszystkich interfejsach sieciowych. Na publicznym serwerze VPS oznacza to, że interfejs jest dostępny z całego internetu natychmiast po uruchomieniu kontenera. Naprawa tego błędu to pierwszy, a nie ostatni krok konfiguracji.

Wymagania

Wymagany jest serwer VPS z zainstalowanym Dockerem, klucz API dla modelu językowego (lub lokalny model) oraz minimum kilka gigabajtów pamięci RAM. Agent Zero działa wszędzie tam, gdzie działa Docker, od małych instrukcji VPS po serwery GPU. Jeśli Docker jest nowym rozwiązaniem, podstawowy przewodnik po Docker wyjaśnia założenia użytych poniżej poleceń.

Instalacja za pomocą Docker, z ograniczeniem do loopback

Dokumentowana szybka instalacja to pojedynczy docker run. Kluczową różnicą względem wersji kopiuj-wklej dostępnych w innych miejscach jest adres publikacji. Nie należy udostępniać interfejsu na wszystkich interfejsach na porcie 50001. Należy udostępnić go na adres loopback:

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

Polecenie -p 127.0.0.1:5080:80 wiąże Web UI wyłącznie z adresem loopback serwera, co uniemożliwia dostęp z internetu. Aby uzyskać dostęp z własnej maszyny, należy użyć tunelu SSH:

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

Następnie należy otworzyć http://127.0.0.1:5080 lokalnie i skonfigurować dostawcę modelu w interfejsie użytkownika. W przypadku stałej konfiguracji wieloużytkownikowej należy umieścić usługę za VPN lub uwierzytelniającym reverse proxy, zamiast wystawiać surowe Web UI do otwartego internetu.

Gdzie kończą się inne poradniki i dlaczego nie należy ich ufać

Wyszukiwanie instrukcji instalacji Agent Zero wykaże wiele poradników (w tym od firm hostingowych), które kończą się na uruchomieniu Web UI na porcie 50001. To jest moment rozpoczęcia ryzyka, a nie jego zakończenia. Konieczne są dwa kroki. Po pierwsze, należy zachować prywatność interfejsu UI, tak jak opisano powyżej. Po drugie, należy skonfigurować firewall z domyślną polityką deny (default-deny), aby przypadkowy kontener lub błąd w przyszłości nie wystawił zapomnianego portu:

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

Aby uzyskać pełny obraz sytuacji, należy zapoznać się z podstawami firewall, zwracając uwagę na lukę IPv6, ponieważ usługa na :: jest dostępna przez IPv6, nawet jeśli reguły IPv4 są poprawne.

Izolacja kontenerów chroni agentów, a nie serwer

Projekt Agent Zero zapewnia skuteczną izolację w jednym zakresie: agenci podrzędni działają w oddzielnych kontenerach, co izoluje ich od siebie nawzajem. Jest to korzystne rozwiązanie. Jednak błędne jest założenie, że "skoro jest w piaskownicy, to jestem bezpieczny". Izolacja kontenerów chroni agentów przed sobą nawzajem. Nie chroni serwera przed internetem ani nie zapobiega przejęciu kontroli przez osobę trzecią w przypadku wystawienia Web UI. Zabezpieczenie hosta należy do zadań administratora.

Sekrety, użytkownicy i host

Klucze API do modeli oraz inne dane uwierzytelniające należy przechowywać w konfiguracji Agent Zero lub w pliku środowiskowym, do którego dostęp ma tylko uprawniony użytkownik. Dane te nie mogą znajdować się w historii powłoki (shell history) ani w żadnym repozytorium. Serwer należy administrować przy użyciu użytkownika o ograniczonych uprawnieniach, zgodnie z zasadą least-privilege users, a dostęp SSH należy ograniczyć wyłącznie do uwierzytelniania kluczami, zgodnie z SSH hardening. Następnie należy zweryfikować poniższą listę kontrolną:

Porównując różne rozwiązania, należy przyjąć taką samą strategię bezpieczeństwa, jaką stosują OpenClaw hardening guide oraz the OpenHands guide: prywatny interfejs sterowania, praca na użytkowniku o ograniczonych uprawnieniach, domyślny firewall oraz traktowanie hosta jako środowiska uruchamiającego kod, którego nie napisano na tym hoście. Aby zobaczyć zestawienie wszystkich pięciu agentów, sprawdź the best self-hosted AI agents in 2026.

Podstawowe koncepcje są opisane w building your own AI agent on a VPS, a Dify to kolejna platforma typu self-hosted, którą warto porównać.

FAQ

Czy self-hosting Agent Zero jest bezpieczny?

Tak, pod warunkiem zachowania prywatności Web UI i utwardzenia (hardening) hosta. Agent Zero wykonuje kod, obsługuje przeglądarkę i shell, a domyślnie Web UI jest dostępny na porcie 50001. Zagrożeniem jest wystawiony interfejs, a nie sam framework. Należy powiązać UI z loopback, uzyskiwać dostęp przez SSH lub VPN, skonfigurować firewall z polityką default-deny i uruchamiać usługę jako użytkownik o ograniczonych uprawnieniach.

Czy Agent Zero domyślnie wystawia Web UI do internetu?

Standardowy docker run udostępnia interfejs na porcie 50001 na wszystkich interfejsach sieciowych. Na publicznym VPS oznacza to dostępność z internetu natychmiast po uruchomieniu kontenera. Należy zmienić adres publikacji na 127.0.0.1, aby interfejs nasłuchiwał wyłącznie na loopback, a następnie łączyć się przez tunel SSH lub VPN.

Czy Agent Zero może działać na małym VPS?

Tak. Agent Zero działa wszędzie tam, gdzie działa Docker, w tym na małych, tanich serwerach VPS, jednak bardziej wymagające zadania i większe modele lokalne wymagają więcej pamięci. W przypadku korzystania z modelu self-hosted zamiast zewnętrznego API, należy dobrać zasoby serwera pod model, a nie tylko pod Agent Zero.

Czym Agent Zero różni się od OpenClaw lub Hermes?

Rozwiązania te mają punkty wspólne, ale inne cele. Agent Zero to framework typu Docker-first, oparty na głównym agencie tworzącym agentów podrzędnych w izolowanych kontenerach, zarządzanych przez Web UI. OpenClaw i Hermes to asystenci osobistych, z którymi komunikuje się poprzez aplikacje czatowe. Strategia bezpieczeństwa jest identyczna dla wszystkich: prywatny interfejs sterowania i utwardzenie hosta.