Rozdział 4: Serwer VPS — zakup i konfiguracja
Mamy automat testujący kod. Teraz potrzebujemy miejsca, gdzie aplikacja będzie działać dla użytkowników — serwera. W tym rozdziale kupujemy i wstępnie konfigurujemy VPS. To czynność 🔁 jednorazowa.
Po tym rozdziale masz działający serwer z Ubuntu, znasz jego adres IP i potrafisz się na niego zalogować przez SSH.
Czym jest VPS (prostym językiem)
VPS (Virtual Private Server) to wynajęty w chmurze komputer z Linuksem, dostępny tylko dla Ciebie, 24/7. Masz na nim pełną władzę (uprawnienia administratora — root): instalujesz, co chcesz, uruchamiasz Dockera, serwujesz stronę.
VPS vs hosting współdzielony: na zwykłym hostingu masz tylko miejsce na pliki PHP. Na VPS masz cały system — dlatego możemy uruchomić Dockera, własnego Nginxa i bazę. Dla aplikacji w Dockerze VPS to naturalny wybór.
Jaki VPS wybrać 🎯
⚠️ Do weryfikacji: oferty i nazwy planów zmieniają się. Poniżej konkret dla FactoryCode (Hostinger, stan z tego wdrożenia). U innego dostawcy (np. OVH, Mikr.us, DigitalOcean) nazwy będą inne — kieruj się parametrami.
Dla aplikacji w Dockerze z bazą i generowaniem PDF (headless Chromium) sensowne minimum to 2 vCPU / 8 GB RAM:
| Parametr | Wartość (FactoryCode) | Dlaczego |
|---|---|---|
| Plan | Hostinger KVM 2 | 2 vCPU / 8 GB / 100 GB NVMe |
| System | Ubuntu 24.04 LTS | wymagany przez nasz skrypt provisioningu |
| Lokalizacja | Litwa (lub Niemcy) | najbliżej odbiorców z Polski |
Dlaczego 8 GB, nie 4 GB: build obrazu Dockera + ewentualny headless Chromium (eksport PDF) potrafią chwilowo zjeść dużo RAM. Na 4 GB łatwiej o zabicie procesu przez brak pamięci.
🧩 Uniwersalnie: wybierz plan z zapasem RAM, system Ubuntu LTS (nasze skrypty są pod Ubuntu), lokalizację blisko użytkowników.
Krok 1: Zakup i uruchomienie serwera 🖥️🔁
Co robisz: kupujesz VPS i uruchamiasz kreator konfiguracji. Dlaczego: bez serwera nie ma gdzie wdrożyć aplikacji.
W kreatorze (u Hostingera: „Konfiguracja KVM") ustaw:
- System operacyjny: wybierz „Zwykły system operacyjny" → Ubuntu → 24.04 LTS.
- ⚠️ Nie wybieraj paneli (np. hPanel/CyberPanel) ani gotowych aplikacji — chcemy czysty system, bo własny stack stawiamy w Dockerze. Panel tylko by przeszkadzał i zjadał RAM.
- ⚠️ Nie włączaj „Menedżera Docker" dostawcy — Dockera zainstaluje nasz skrypt w kontrolowany sposób (inaczej ryzyko konfliktu).
- Lokalizacja: najbliższa odbiorcom.
- Nazwa hosta (hostname): dowolna, np. nazwa projektu.
Oczekiwany rezultat: po kilku minutach serwer jest postawiony, a panel pokazuje jego adres IP (np. 203.0.113.10). Zapisz go jako <VPS_IP>.
🎯 Dla FactoryCode
<VPS_IP>=203.0.113.10(adres przykładowy, zarezerwowany do dokumentacji; prawdziwego IP serwera nie publikujemy).
Krok 2: Dostęp — hasło root i klucz SSH 🖥️🔁
W kreatorze pojawi się ekran zabezpieczenia dostępu. Zrób obie rzeczy:
a) Hasło root — ustaw mocne hasło (możesz wygenerować) i zapisz je w menedżerze haseł. To awaryjne wejście na serwer.
b) Klucz SSH (publiczny) — tu wkładasz publiczną część klucza z Rozdziału 2. Dzięki temu zalogujesz się bez hasła, a później zrobi to też automat.
Najpierw skopiuj klucz publiczny do schowka:
# 💻 lokalnie
pbcopy < ~/.ssh/<KLUCZ_LOKALNY>.pub # macOS
# Linux: xclip -sel clip < ~/.ssh/<KLUCZ_LOKALNY>.pub
Następnie w kreatorze wklej go w pole „Dodaj klucz SSH" (treść zaczyna się od ssh-ed25519 AAAA...).
🎯 Dla FactoryCode wkleiliśmy publiczny
~/.ssh/factorycode_deploy.pub.
⚠️ Jeśli kreator nie pyta o klucz SSH, nic nie szkodzi — klucz dodasz później w panelu VPS (sekcja „SSH keys").
Oczekiwany rezultat: serwer zna Twój klucz publiczny; masz zapisane hasło root.
Krok 3: Test logowania przez SSH 💻
Co robisz: sprawdzasz, że możesz się zalogować kluczem. Dlaczego: jeśli logowanie działa teraz, to zadziała też automatowi w Rozdziale 8. Lepiej wykryć problem z kluczem od razu.
# 💻 lokalnie — podmień <VPS_IP>
ssh -i ~/.ssh/<KLUCZ_LOKALNY> root@<VPS_IP> "echo POLACZENIE_OK && lsb_release -d"
Przy pierwszym połączeniu zobaczysz pytanie:
Are you sure you want to continue connecting (yes/no/[fingerprint])?
Wpisz yes i Enter (to zapisuje serwer jako „znany").
Oczekiwany rezultat:
POLACZENIE_OK
Description: Ubuntu 24.04.x LTS
🎯 Dla FactoryCode komenda to:
ssh -i ~/.ssh/factorycode_deploy root@203.0.113.10 "echo POLACZENIE_OK && lsb_release -d"
Jeśli zobaczyłeś POLACZENIE_OK i wersję Ubuntu — logowanie kluczem działa. 🎉
Częste problemy
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
Permission denied (publickey) |
serwer nie zna Twojego klucza publicznego | dodaj klucz publiczny w panelu VPS (SSH keys) lub przez hasło root wpisz go do ~/.ssh/authorized_keys |
| pyta o hasło zamiast wpuścić kluczem | zły plik klucza w -i albo klucz nie dodany |
sprawdź ścieżkę -i ~/.ssh/<KLUCZ_LOKALNY>; upewnij się, że publiczny jest na serwerze |
Connection timed out |
zły IP / serwer jeszcze się stawia / firewall | sprawdź <VPS_IP>; poczekaj, aż panel pokaże „uruchomiony" |
| komunikat o zmianie „host key" | serwer postawiony od nowa pod tym IP | usuń stary wpis: ssh-keygen -R <VPS_IP> i połącz ponownie |
⚠️ Do weryfikacji: jeśli po zalogowaniu widzisz komunikat o nowej wersji systemu (np. „New release available"), nie uruchamiaj
do-release-upgrade. Zostajemy na Ubuntu 24.04 (nasze skrypty są pod nią).
Podsumowanie
- ✅ Masz działający VPS z Ubuntu 24.04 i jego adres IP (
<VPS_IP>). - ✅ Serwer zna Twój klucz publiczny; masz zapisane hasło root.
- ✅ Potwierdziłeś logowanie:
ssh -i ~/.ssh/<KLUCZ_LOKALNY> root@<VPS_IP>działa. - ✅ Wiesz, co jest 🧩 uniwersalne (Ubuntu LTS, czysty system, klucz SSH), a co 🎯 zależne od dostawcy.
Serwer jest, ale użytkownicy wpisują domenę, nie IP. W następnym rozdziale skierujemy domenę na serwer.
Dalej: Rozdział 5: Domena i DNS.