Paddock: samodzielnie hostowany sandbox agentów AI

Do czego służy Paddock? Proste wyjaśnienie

Paddock udostępnia agentowi AI osobny komputer Linux na serwerze VPS, którym zarządzasz. Każdy box ma pliki, narzędzia oraz pulpit Ubuntu XFCE. Agent może uruchamiać polecenia, budować aplikację i otworzyć ją, aby sprawdzić wynik. Środowisko można zachować na później albo usunąć po jednej pracy.

Publiczna witryna opisuje projekt do samodzielnego wdrożenia. Samo wejście na stronę nie tworzy gotowego komputera w chmurze. Paddock zapewnia miejsce wykonywania zadań, a wybrany agent i model realizują polecenie.

Instalacja i pierwsze uruchomienie testów

Oficjalna instrukcja wymaga VPS z Ubuntu lub Debianem, uprawnień root, amd64 lub arm64, otwartych portów 80 i 443 oraz nazwy hosta wskazującej serwer. Po instalacji użyj jednorazowego odnośnika do utworzenia konta właściciela. Następnie zainstaluj lokalne CLI i zaloguj je do serwera.

Dla przygotowanego projektu Node możesz przesłać pliki i wykonać testy:

paddock new --type small --ttl 3600
paddock push current . --to /config/project
paddock exec current -- bash -lc 'cd /config/project && npm test'
paddock stop current

Sprawdź wynik w wyjściu polecenia. Zależności i skrypt testowy muszą być dostępne; pobieranie pakietów wymaga odpowiednich reguł sieci. Zatrzymanie boxa tworzy migawkę systemu plików. Przed usunięciem środowiska pobierz potrzebne rezultaty przez pull. Skill Paddock umożliwia obsługiwanym agentom korzystanie z CLI.

Kod, testy i kontrola interfejsu

W boxie działa Docker przez Sysbox. Claude Code, Codex, OpenCode, Pi, Prime i Kimi są zainstalowane, ale trzeba skonfigurować uwierzytelnianie wybranej usługi. Zadania przekazuje paddock prompt. Można też korzystać z CLI, panelu przeglądarkowego, API HTTP oraz SDK TypeScript i Python.

Polecenie paddock desktop otwiera pulpit. Aplikację graficzną uruchamia się przez exec --desktop, a paddock screenshot zapisuje obraz do sprawdzenia. Przydaje się to podczas oceny rzeczywistego interfejsu aplikacji zbudowanej przez agenta.

Kontrola sieci i granice prywatności

Dostępne są allow-all, deny-all oraz lista dozwolonych domen i zakresów IPv4. Nowe boxy domyślnie używają allow-all. Deny-all blokuje nowe połączenia wychodzące, ale istniejące mogą się zakończyć. Dostęp do metadanych chmury jest blokowany zawsze.

Lista musi uwzględniać potrzebne API modeli, repozytoria i rejestry pakietów. Własny VPS daje kontrolę nad serwerem wykonującym kod, jednak dane wysłane do zewnętrznego modelu podlegają również zasadom jego dostawcy. Nie jest to obietnica pełnej odporności na każdy typ ucieczki z izolacji.

Co zachowuje migawka, a co dysk?

Box można zatrzymać, wznowić, sklonować przez fork i przywrócić do migawki. Nazwane dyski pod /mnt zachowują dane po usunięciu boxa, więc nadają się do pamięci podręcznej lub wspólnych materiałów.

Dokumentacja migawek wyklucza pamięć RAM, działające procesy, /var/lib/docker oraz podłączone dyski. Migawka obejmuje system plików, nie zamrożoną sesję procesu. Kopie danych na dyskach trzeba planować osobno.

Licencja i rzeczywiste koszty

Stan na 29 października 2026 r.: projekt jest udostępniany na licencji MIT. W sprawdzonych materiałach nie ma oficjalnego abonamentu na hostowaną usługę Paddock. VPS, przestrzeń dyskowa i użycie modeli mogą kosztować oddzielnie. Liczba równoległych boxów zależy od zasobów serwera.

To rozwiązanie dla programistów gotowych zarządzać Linuksem, aktualizacjami, dostępem i kopiami zapasowymi.

Najczęstsze pytania

Czy Paddock jest darmowy?

Kod MIT jest dostępny bez abonamentu na oprogramowanie w zweryfikowanych źródłach. Nie obejmuje to darmowego VPS ani wywołań modeli.

Czy mogę używać Windows lub macOS?

Tak, jako komputera z CLI. Sam serwer wymaga opisanej infrastruktury Linux.

Czy nowy sandbox nie ma internetu?

Nie. Domyślnie obowiązuje allow-all; deny-all lub listę dozwoloną ustawiasz samodzielnie.

Oficjalne zasoby

• Repozytorium projektu: kod i dokumentacja techniczna.
• Wydania i pliki do pobrania: dostępne programy klienckie i informacje o wersjach.