5

Rozdział 5 z 11

Izolacja Docker i test bezpieczeństwa

Opublikowany

To, co realnie chroni Twoją stronę: agent wykonuje polecenia w osobnym kontenerze, nie na serwerze. Konfigurujemy backend „docker" z małym obrazem i limitami, a potem udowadniamy izolację prostym testem.

Czego się nauczysz

  • Po co izolacja (ochrona strony i bazy)
  • Konfiguracja terminal.backend docker + limity
  • Mały obraz piaskownicy (python:3.11-slim)
  • Test: komenda wykonana w kontenerze, nie na hoście

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 obraz python:3.11-slim jest 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.yaml ma terminal.backend = docker i 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.backend z docker na local. „Local" wykonywałby komendy wprost na serwerze — niebezpieczne. Zostaw docker.
  • 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.

Narzędzia / paczki

hermes config set Docker Docker sandbox

Spis treści