Rozdział 5: Domena i DNS
Serwer działa, ale ma tylko surowy adres IP (<VPS_IP>). Użytkownicy wpisują domenę (factorycode.pl), nie cyfry. W tym rozdziale kierujemy domenę na serwer — przez DNS. Czynność 🔁 jednorazowa, wykonywana 💻/🐙 w panelu domeny.
Po tym rozdziale wpisanie Twojej domeny prowadzi do serwera (potwierdzone komendą
dig). To warunek kolejnego rozdziału — certyfikat SSL nie wystawi się bez działającego DNS.
Co to jest DNS (prostym językiem)
DNS (Domain Name System) to „książka telefoniczna internetu". Zamienia nazwę (factorycode.pl) na adres IP serwera (203.0.113.10). Gdy ktoś wpisuje domenę, przeglądarka pyta DNS: „pod jakim IP to jest?" — i łączy się z tym IP.
Najważniejsze typy wpisów (rekordów):
| Rekord | Rola |
|---|---|
| A | „ta domena → ten adres IPv4" (najważniejszy dla nas) |
| CNAME | „ta subdomena to alias innej nazwy" (np. www → domena główna) |
| AAAA | jak A, ale dla IPv6 |
| MX / TXT | poczta i weryfikacje (nie ruszamy ich tutaj) |
Krok 1: Zdobądź domenę 🧩🔁
Co robisz: kupujesz domenę (albo używasz już posiadanej). Dlaczego: to publiczny adres Twojej aplikacji.
🎯 Dla FactoryCode używamy
factorycode.pl(kupiona osobno; można też skorzystać z darmowej domeny dołączanej czasem do VPS).
Gdzie zarządzasz DNS: tam, gdzie domena jest zarejestrowana (u nas: panel Hostingera → Domeny). Jeśli kupiłeś domenę u innego rejestratora (OVH, nazwa.pl, home.pl…), rekordy ustawiasz w jego panelu.
Krok 2: Ustaw rekordy DNS 🐙🔁
Co robisz: dodajesz dwa wpisy, które kierują domenę na <VPS_IP>.
Dlaczego: bez rekordu A domena „nie wie", gdzie jest serwer.
W panelu DNS swojej domeny ustaw:
| Typ | Nazwa | Wartość | TTL |
|---|---|---|---|
| A | @ |
<VPS_IP> |
300 |
| CNAME | www |
<DOMENA> |
300 |
Wyjaśnienie:
@oznacza „gołą" domenę (factorycode.pl),wwwto subdomena (www.factorycode.pl).CNAME www → <DOMENA>sprawia, żewwwprowadzi tam samo co domena główna.- TTL (Time To Live, w sekundach) mówi, jak długo DNS może trzymać odpowiedź w pamięci. Na czas wdrożenia dajemy niskie 300 (5 min), żeby zmiany łapały się szybko. ⚠️ Minimalna dozwolona wartość bywa różna (często 60) — jeśli panel odrzuci za niską, podaj 300.
🎯 Dla FactoryCode: | A |
@|203.0.113.10| 300 | | CNAME |www|factorycode.pl| 300 |
Dodatkowo: jeśli w tabeli jest stary rekord A lub AAAA wskazujący na „parking" dostawcy — zmień/usuń go, żeby nie kierował na starą stronę. Rekordów NS i MX nie ruszaj.
Oczekiwany rezultat: w tabeli DNS widać rekord A (@ → <VPS_IP>) i CNAME (www → <DOMENA>).
Krok 3: Zweryfikuj propagację 💻
Co robisz: sprawdzasz, czy świat widzi już nowy adres. Dlaczego: zmiany DNS nie są natychmiastowe (tzw. propagacja). Certyfikat SSL (Rozdział 6) wymaga, żeby domena już wskazywała na serwer.
# 💻 lokalnie
dig +short <DOMENA>
Oczekiwany rezultat: komenda zwraca <VPS_IP>.
🎯 Dla FactoryCode:
dig +short factorycode.pl→203.0.113.10.
Jeśli zwraca stary adres albo nic — poczekaj kilka minut i powtórz. Przy świeżej domenie zwykle łapie szybko (minuty); czasem trwa do kilku godzin.
Nie przechodź do Rozdziału 6, dopóki
dignie pokaże<VPS_IP>. Inaczej certbot nie zweryfikuje domeny.
Częste problemy
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
dig zwraca stary IP (parking) |
propagacja w toku / nie usunięto starego rekordu | poczekaj; sprawdź, czy rekord A ma <VPS_IP>, usuń stary A/AAAA |
dig nie zwraca nic |
brak rekordu A / zła domena | sprawdź, czy rekord A istnieje i dotyczy @ |
| panel nie przyjmuje TTL | za niska wartość | ustaw 300 (lub minimum dozwolone, np. 60) |
strona działa, www nie |
brak CNAME dla www |
dodaj CNAME www → <DOMENA> |
⚠️ Do weryfikacji: jeśli domena jest u innego rejestratora niż VPS, upewnij się, że używa serwerów nazw (NS) tego rejestratora, w którego panelu edytujesz rekordy. Inaczej zmiany nie zadziałają.
Podsumowanie
- ✅ Rozumiesz, czym jest DNS i rekordy A / CNAME.
- ✅ Domena
<DOMENA>wskazuje na<VPS_IP>(A@+ CNAMEwww). - ✅ Potwierdziłeś to komendą
dig +short <DOMENA>. - ✅ Wiesz, że DNS musi działać przed wystawieniem SSL.
Domena prowadzi na serwer, ale serwer jest jeszcze „pusty". W następnym rozdziale zainstalujemy na nim Dockera, Nginx i certyfikat SSL — jednym skryptem.
Dalej: Rozdział 6: Provisioning serwera — Docker, Nginx, SSL.