Rozdział 5: Izolacja Docker i test bezpieczeństwa
Agent potrafi wykonywać polecenia w systemie — to jego siła, ale i odpowiedzialność. W tym rozdziale włączamy izolację Docker: komendy agenta będą się wykonywać w osobnym kontenerze-piaskownicy, a nie na Twoim serwerze. To jest to, co realnie chroni Twoją stronę i bazę. Na końcu udowodnimy, że działa.
Po tym rozdziale agent jest odcięty od Twojego serwera — jego akcje nie dotykają strony.
Po co izolacja
Domyślnie agent mógłby uruchamiać polecenia wprost na serwerze (backend „local"). Na maszynie z produkcyjną stroną i bazą to ryzyko — agent (albo źle sformułowana prośba) mógłby coś zepsuć.
Backend „docker" to rozwiązuje: agent dostaje własny, izolowany kontener (system tylko-do-odczytu, bez uprawnień, z limitami). Nie widzi plików Twojej strony, bazy ani ustawień serwera.
Krok 1 — Włącz backend „docker" i ustaw limity 🖥️
To lekkie komendy (tylko zapis konfiguracji). Na serwerze:
hermes config set terminal.backend docker
hermes config set terminal.docker_image python:3.11-slim # mały obraz piaskownicy
hermes config set terminal.container_cpu 1
hermes config set terminal.container_memory 2048 # limit 2 GB na piaskownicę
Co ustawiamy:
| Ustawienie | Po co |
|---|---|
terminal.backend docker |
agent wykonuje polecenia w osobnym kontenerze |
docker_image python:3.11-slim |
mały obraz (~150 MB) — lekkie, szybkie pobranie |
container_cpu 1 |
piaskownica dostaje max 1 rdzeń |
container_memory 2048 |
piaskownica dostaje max 2 GB RAM |
Oczekiwany rezultat: każda komenda z ✓ Set terminal... in /root/.hermes/config.yaml.
Krok 2 — (opcjonalnie) pobierz obraz piaskownicy z góry 🖥️
Żeby pierwszy test nie zaskoczył Cię pobieraniem, pobierz mały obraz w kontrolowany sposób:
docker pull python:3.11-slim
To ~150 MB — szybkie i lekkie.
Krok 3 — Test izolacji (dowód, że działa) 🖥️
Teraz udowodnimy, że komenda agenta wykonuje się w kontenerze, a nie na Twoim serwerze. Uruchom czat w klatce:
systemd-run --scope -p CPUQuota=100% -p MemoryMax=4G hermes
W czacie poproś agenta:
Wykonaj w terminalu polecenia: hostname oraz cat /etc/os-release. Pokaż mi dokładny wynik.
Agent może zapytać o zgodę na wykonanie polecenia (bo mamy włączone zatwierdzanie) → zatwierdź.
Co ma wyjść (dowód izolacji)
hostname→ losowy identyfikator kontenera (np.2b2a105102a9), a NIE nazwa Twojego serwera.cat /etc/os-release→ Debian (bo obrazpython:3.11-slimjest na Debianie), a NIE system Twojego serwera (np. Ubuntu 24.04).
Jeśli widzisz inny system i inną nazwę hosta niż Twój serwer — izolacja działa. Agent fizycznie nie dotyka Twojej maszyny ani strony. 🛡️
Wyjście z czatu: /quit (albo /exit).
Weryfikacja rozdziału
-
config.yamlmaterminal.backend = dockeri limity (sprawdzisz:hermes config get terminal.backend). - Test pokazał inny hostname i inny system niż Twój serwer.
- Rozumiesz, że to izolacja chroni stronę — i że trzeba ją utrzymać (patrz niżej).
⚠️ Ważne zasady, żeby izolacja działała dalej
- Nie zmieniaj
terminal.backendzdockernalocal. „Local" wykonywałby komendy wprost na serwerze — niebezpieczne. Zostawdocker. - Zostaw włączone zatwierdzanie poleceń — agent pyta, zanim coś wykona.
Podsumowanie
- ✅ Włączyłeś izolację Docker z małym obrazem i limitami piaskownicy.
- ✅ Udowodniłeś izolację: komenda poszła w kontenerze (Debian, losowy host), nie na serwerze.
- ✅ Wiesz, że to główne zabezpieczenie strony — i czego nie zmieniać.
W następnym rozdziale zaczniesz normalnie używać agenta: rozmowa i codzienne komendy.
Dalej: Rozdział 6 — Pierwsza rozmowa i codzienne używanie.