4

Rozdział 4 z 11

Serwer VPS — zakup i konfiguracja

Opublikowany

Czym jest VPS, jaki wybrać, jak dodać klucz SSH w kreatorze i jak potwierdzić logowanie.

Czego się nauczysz

  • Czym jest VPS
  • Wybór planu i systemu (Ubuntu LTS)
  • Hasło root i klucz SSH
  • Test logowania SSH

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.

Narzędzia / paczki

VPS (Hostinger KVM 2) Ubuntu 24.04 SSH

Spis treści