Rozdział 2: Bezpieczeństwo na serwerze ze stroną
To najważniejszy rozdział, jeśli stawiasz Hermesa obok produkcyjnej strony na tym samym VPS-ie. Nauczysz się trzech rzeczy, które sprawią, że instalacja i praca agenta nigdy nie zawieszą serwera: swap, limit zasobów („klatka") i tmux.
Lekcja z praktyki: podczas naszego wdrożenia sama instalacja Hermesa (ciężki build + dociąganie narzędzi) dwa razy zawiesiła maszynę i położyła stronę. Na 2 rdzeniach, bez swapa, skok obciążenia potrafi zatkać cały system. Poniższe trzy zabezpieczenia to rozwiązują — zrób je, zanim zainstalujesz Hermesa.
Dlaczego ciężka operacja wiesza serwer
VPS KVM 2 ma 2 rdzenie i często zero swapa. Gdy ciężki proces (build, dociąganie zależności) nagle:
- zajmie całą pamięć → brak swapa → system się dławi,
- albo obłoży oba rdzenie w 100% → nie starcza mocy dla strony i nawet dla SSH → serwer przestaje odpowiadać.
Efekt: strona offline, a Ty nie możesz się nawet zalogować. Zabezpieczamy się na dwóch frontach: pamięć (swap) i moc CPU/dysku (limit).
1. Dodaj swap (poduszkę pamięci) 🖥️
Swap to „zapas" pamięci na dysku — gdy RAM się kończy, system odkłada tam nieaktywne dane zamiast się wieszać. 4 GB w zupełności wystarczy. Robisz to raz. Na serwerze:
fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab # swap zostaje po restarcie
sysctl -w vm.swappiness=10
echo 'vm.swappiness=10' >> /etc/sysctl.conf
free -h
Oczekiwany rezultat: w free -h zobaczysz Swap: 4.0Gi zamiast 0B. swappiness=10 sprawia, że system sięga po swap dopiero pod presją (nie spowalnia niepotrzebnie).
Swap przyda się Twojemu serwerowi niezależnie od Hermesa — to dobra praktyka na każdym produkcyjnym VPS-ie bez swapa.
2. Uruchamiaj Hermesa „w klatce" (limit CPU i RAM) 🖥️
To najważniejsze zabezpieczenie. Każde cięższe uruchomienie Hermesa poprzedzisz komendą systemd-run z limitem. Ogranicza ona proces do 1 rdzenia i 4 GB RAM — drugi rdzeń i reszta pamięci zawsze zostają dla strony i SSH, więc serwer fizycznie nie może się zawiesić:
systemd-run --scope -p CPUQuota=100% -p MemoryMax=4G nice -n 19 ionice -c3 KOMENDA
Gdzie KOMENDA to to, co chcesz uruchomić — np. bash hermes-install.sh, hermes setup --portal, hermes model albo hermes.
Co znaczą poszczególne części:
| Fragment | Działanie |
|---|---|
CPUQuota=100% |
maksymalnie 1 rdzeń (100% = jeden rdzeń); drugi zostaje dla strony |
MemoryMax=4G |
limit RAM; po przekroczeniu system ubije sam proces Hermesa, nie całą maszynę |
nice -n 19 |
najniższy priorytet CPU (strona/SSH mają pierwszeństwo) |
ionice -c3 |
najniższy priorytet dysku (nie dławi operacji dyskowych) |
To Twój nawyk na zawsze: zawsze uruchamiaj Hermesa przez
systemd-run …. Dzięki temu nawet ciężkie zadanie nie zagłodzi strony.
3. Uruchamiaj w tmux 🖥️
tmux to „sesja", która żyje na serwerze niezależnie od Twojego połączenia SSH. Jeśli łącze padnie w trakcie długiej operacji, proces leci dalej (bez tmux — zginąłby razem z sesją).
tmux new -s hermes
Ekran „mrugnie" — jesteś w tmux. Po rozłączeniu wrócisz do podglądu:
tmux attach -t hermes
Gdyby mimo to serwer się zawiesił
Jeśli kiedyś strona przestanie odpowiadać (np. uruchomiłeś coś bez klatki):
- Zrestartuj VPS z panelu Hostingera (hPanel → VPS → Restart / Force reboot) — serwer nie odpowiada na SSH, więc tylko tak.
- Poczekaj 1–3 min. Strona wróci sama, jeśli Twoje kontenery mają
restart: unless-stopped. - Potem dokończ pracę z klatką jak wyżej.
Weryfikacja rozdziału
-
free -hpokazujeSwap: 4.0Gi. - Rozumiesz komendę
systemd-run --scope -p CPUQuota=100% -p MemoryMax=4G …. - Wiesz, jak wejść w tmux (
tmux new -s hermes) i wrócić (tmux attach -t hermes). - Wiesz, co zrobić, gdy serwer się zawiesi (restart z panelu).
Podsumowanie
- ✅ Dodałeś swap — poduszkę pamięci (koniec z wieszaniem od braku RAM).
- ✅ Znasz „klatkę" (
systemd-run) — twardy limit 1 rdzeń + 4 GB, żeby nie zagłodzić strony. - ✅ Wiesz, że ciężkie operacje robimy w tmux (przeżyją zerwanie SSH).
- ✅ Masz plan awaryjny (restart z panelu).
Serwer zabezpieczony. W następnym rozdziale zainstalujemy Hermesa — bezpiecznie, w klatce i w tmux.
Dalej: Rozdział 3 — Instalacja na VPS.