GitHub Pages: własna domena, DNS, CNAME i HTTPS

Jak ustawić własną domenę w GitHub Pages: rekordy DNS dla domeny głównej i www, rola pliku CNAME, weryfikacja domeny i włączenie HTTPS.

Najczęściej zadawane pytania

Jakich adresów IP użyć dla domeny głównej (apex) w GitHub Pages?

Dokumentacja GitHuba (sprawdzona w listopadzie 2026) podaje cztery rekordy A dla hosta głównego (@): 185.199.108.153, 185.199.109.153, 185.199.110.153 i 185.199.111.153. Jeśli chcesz mieć też IPv6, dodaj cztery rekordy AAAA: 2606:50c0:8000::153, 2606:50c0:8001::153, 2606:50c0:8002::153 i 2606:50c0:8003::153. GitHub zaleca zachowanie rekordów A obok rekordów AAAA. Przed wklejeniem porównaj wartości z dokumentacją, bo GitHub może je zmienić.

Czy potrzebuję pliku CNAME w repozytorium?

Tylko wtedy, gdy publikujesz z gałęzi. W takim przypadku zapisanie własnej domeny w Settings > Pages (Ustawienia > Pages) automatycznie zatwierdza plik CNAME w katalogu głównym gałęzi źródłowej. Jeśli publikujesz za pomocą własnego workflow GitHub Actions, GitHub informuje, że plik CNAME nie jest tworzony, a istniejący jest ignorowany i niepotrzebny.

Dlaczego pole wyboru Enforce HTTPS jest wyszarzone?

GitHub podaje, że po dodaniu domeny opcja może pojawić się dopiero po upływie do 24 godzin. Certyfikat jest wystawiany automatycznie, więc najczęstsze przyczyny zablokowanego pola to niezakończona propagacja DNS albo nadmiarowe rekordy, np. dodatkowe rekordy A, AAAA, ALIAS lub ANAME na domenie głównej albo rekord CNAME dla www wskazujący gdzie indziej niż na GitHub. GitHub zaznacza też, że domena musi mieć mniej niż 64 znaki. Jeśli nic się nie zmienia, kliknij Remove (Usuń) przy domenie, wpisz ją ponownie i zapisz jeszcze raz.

Wybrać domenę główną czy www?

GitHub zaleca www. Według dokumentacji subdomeny www są najbardziej stabilnym typem własnej domeny, ponieważ nie wpływają na nie zmiany adresów IP serwerów GitHuba. Którąkolwiek ustawisz jako własną domenę, GitHub przekieruje na nią drugą, o ile DNS obu wskazuje na GitHub Pages.

Ile czasu trwa uruchomienie własnej domeny w GitHub Pages?

GitHub podaje, że propagacja zmian DNS może potrwać do 24 godzin. W praktyce wiele rekordów zaczyna działać szybciej, ale zanim uznasz, że coś jest zepsute, zaplanuj całą dobę.

Czy można używać rekordu DNS z wildcardem w GitHub Pages?

GitHub stanowczo odradza rekordy wildcard, takie jak *.example.com. Według dokumentacji narażają Cię one na natychmiastowe ryzyko przejęcia domeny, nawet jeśli domena jest zweryfikowana. Zamiast tego utwórz rekordy dla konkretnych subdomen, z których korzystasz.

Krótka odpowiedź: w repozytorium przejdź do Settings > Pages (Ustawienia > Pages), wpisz domenę w polu Custom domain (Własna domena) i zapisz. Następnie u dostawcy DNS skieruj www na <username>.github.io rekordem CNAME, a domenę główną (example.com) na GitHub czterema rekordami A. Gdy GitHub wystawi certyfikat, zaznacz Enforce HTTPS. Całość to jedno ustawienie w repozytorium i kilka rekordów DNS. Większość opóźnień wynika z propagacji DNS, która według GitHuba może zająć do 24 godzin.

Wszystko poniżej sprawdziliśmy w dokumentacji GitHuba w listopadzie 2026. Wartości DNS są tym, co najczęściej się zmienia, więc przed wklejeniem potwierdź je w dokumentacji GitHub Pages o własnej domenie.

Najpierw wybierz typ domeny

Gdzie mają trafiać odwiedzający	Własna domena do ustawienia	Potrzebne rekordy DNS	Uwagi
`www.example.com`	`www.example.com`	CNAME dla `www` na `<username>.github.io` oraz rekordy A na domenie głównej	Konfiguracja zalecana przez GitHub. `example.com` przekierowuje na www.
`example.com`	`example.com`	Rekordy A na domenie głównej (lub jeden ALIAS/ANAME) oraz CNAME dla `www`	`www.example.com` przekierowuje na domenę główną.
`blog.example.com`	`blog.example.com`	CNAME dla `blog` na `<username>.github.io`	Rekordy dla domeny głównej nie są potrzebne.

Zgodnie z dokumentacją GitHuba subdomeny www to najstabilniejszy wybór, bo nie zależą od zmian adresów IP serwerów GitHuba. Jeśli nie masz mocnego powodu, by użyć domeny głównej, wybierz www. Jeśli dopiero szukasz rejestratora, nasze porównanie rejestratorów domen omawia dostępne opcje, a artykuł ile kosztuje domena wyjaśnia ceny odnowień.

Krok po kroku: podłączanie domeny

Dodaj domenę w GitHubie. Otwórz repozytorium, kliknij Settings (Ustawienia), potem Pages (w sekcji „Code, planning, and automation”). Jeśli karta Settings jest ukryta, poszukaj jej w rozwijanym menu „More”. Wpisz domenę w polu Custom domain i kliknij Save (Zapisz).
Sprawdź, co GitHub zmienił w repozytorium. Jeśli publikujesz z gałęzi, GitHub zatwierdza plik CNAME w katalogu głównym tej gałęzi. Jeśli publikujesz za pomocą własnego workflow GitHub Actions, plik CNAME nie powstaje, a istniejący jest ignorowany.
Usuń domyślne rekordy DNS. Jeśli Twój dostawca DNS automatycznie utworzył rekord parkingowy lub domyślny dla hosta, którego zamierzasz użyć, najpierw go usuń.
Utwórz rekordy DNS u dostawcy DNS (zobacz następną sekcję).
Poczekaj na propagację. GitHub podaje do 24 godzin. Postęp sprawdzisz w terminalu poleceniem dig www.example.com +noall +answer.
Wymuś HTTPS, gdy opcja stanie się dostępna (patrz niżej).

Kolejność ma mniejsze znaczenie, niż się wydaje

Rekordy DNS możesz utworzyć przed zapisaniem domeny w GitHubie lub po nim. Ryzyko polega na tym, że DNS wskazuje na GitHub Pages, a domena nie jest przypisana do żadnego repozytorium. GitHub ostrzega, że skonfigurowanie DNS bez dodania domeny w GitHubie może pozwolić komuś innemu hostować stronę na jednej z Twoich subdomen. Najpierw zapisz domenę w GitHubie, potem zajmij się DNS.

Rekordy DNS

www lub dowolna subdomena: jeden rekord CNAME

Typ	Host	Wartość
CNAME	`www`	`<username>.github.io`

Użyj nazwy użytkownika lub organizacji, bez nazwy repozytorium. GitHub wyraźnie zaznacza, żeby nie kierować CNAME na unikalny adres *.pages.github.io widoczny w ustawieniach repozytorium.

Domena główna: cztery rekordy A (sprawdzone w listopadzie 2026)

Typ	Host	Wartość
A	`@`	`185.199.108.153`
A	`@`	`185.199.109.153`
A	`@`	`185.199.110.153`
A	`@`	`185.199.111.153`

Opcjonalnie IPv6, jeśli go potrzebujesz, jako rekordy AAAA dla @:

Typ	Host	Wartość
AAAA	`@`	`2606:50c0:8000::153`
AAAA	`@`	`2606:50c0:8001::153`
AAAA	`@`	`2606:50c0:8002::153`
AAAA	`@`	`2606:50c0:8003::153`

GitHub zaleca dodanie rekordów A nawet wtedy, gdy dodajesz rekordy AAAA, ponieważ IPv6 nie jest jeszcze wszędzie dostępne. Jeśli Twój dostawca DNS obsługuje rekordy ALIAS lub ANAME, możesz zamiast rekordów A i AAAA użyć jednego rekordu wskazującego na <username>.github.io.

Dwa błędy, których warto unikać:

Dodatkowe rekordy na domenie głównej. GitHub podaje, że dodatkowe rekordy A, AAAA, ALIAS lub ANAME dla @ albo rekord CNAME dla www wskazujący gdzie indziej mogą uniemożliwić wygenerowanie certyfikatu HTTPS.
Kierowanie subdomeny na domenę główną. GitHub ostrzega, że powoduje to problemy z wymuszeniem HTTPS i może całkiem odciąć subdomenę od Twojej strony. Kieruj subdomeny na <username>.github.io.

Niektórzy dostawcy używają @ dla hosta głównego, inni każą zostawić pole puste albo wpisać pełną domenę. To cecha dostawcy, a nie ustawienie GitHuba.

Włącz HTTPS

GitHub wystawia certyfikaty dla własnych domen przez Let's Encrypt. Gdy DNS rozwiązuje się poprawnie:

Wróć do Settings > Pages.
Poszukaj znacznika wyboru przy swojej domenie, który oznacza, że kontrola DNS zakończyła się powodzeniem.
Zaznacz Enforce HTTPS.

GitHub podaje, że udostępnienie tej opcji może potrwać do 24 godzin. Jeśli nie pojawi się kilka minut po zapisaniu, GitHub sugeruje kliknąć Remove przy własnej domenie, wpisać ją ponownie i znów kliknąć Save. Żeby certyfikat mógł powstać, domena musi też mieć mniej niż 64 znaki.

Jeśli pole wyboru nadal jest wyszarzone, przejdź przez tę listę:

[ ] DNS hosta wskazuje na GitHub (dig pokazuje cztery adresy IP lub Twój CNAME <username>.github.io)
[ ] Brak dodatkowych rekordów A, AAAA, ALIAS lub ANAME na domenie głównej
[ ] CNAME dla www wskazuje na <username>.github.io, a nie na domenę główną ani adres pages.github.io
[ ] Domena w Settings > Pages dokładnie odpowiada temu, co wpisałeś(-aś) w DNS
[ ] Raz usunąłeś(-aś) i ponownie dodałeś(-aś) domenę

Zweryfikuj domenę (zdecydowanie zalecane)

Weryfikacja uniemożliwia innym kontom GitHub przejęcie Twojej domeny, jeśli Twoja strona w Pages zostanie kiedyś odłączona. GitHub wymienia przejęcia domen jako możliwe, gdy usuniesz repozytorium, gdy Twój plan rozliczeniowy zostanie obniżony albo po każdej zmianie odłączającej domenę, która nadal jest skonfigurowana dla GitHub Pages i niezweryfikowana.

Otwórz ustawienia swojego profilu (nie ustawienia repozytorium), a następnie Pages na pasku bocznym.
Kliknij Add a domain, wpisz domenę i potwierdź.
Utwórz rekord TXT, który pokaże GitHub. Host będzie wyglądał tak: _github-pages-challenge-USERNAME.example.com.
Sprawdź, czy jest widoczny, poleceniem dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT.
Wróć do GitHuba, użyj menu przy domenie, wybierz Continue verifying, a potem Verify.

GitHub podaje, że może to nastąpić od razu albo zająć do 24 godzin. Rekord TXT zostaw na miejscu także po weryfikacji. Unikaj też rekordów wildcard, takich jak *.example.com: GitHub twierdzi, że grożą przejęciem nawet wtedy, gdy domena jest zweryfikowana.

Typowe problemy

404 na własnej domenie, a strona działa pod adresem github.io. Domena nie została zapisana w Settings > Pages albo DNS jeszcze się nie rozpropagował. Sprawdź jedno i drugie.
Domena resetuje się po każdym wdrożeniu. Jeśli publikujesz z gałęzi, plik CNAME w gałęzi źródłowej musi zawierać Twoją domenę. Build, który czyści katalog główny gałęzi, albo wdrożenie pomijające ten plik może go usunąć. Przejście na własny workflow Actions sprawia, że plik przestaje być potrzebny.
Domena główna działa, a www nie (lub odwrotnie). Oba hosty potrzebują rekordów. Pamiętaj, że GitHub przekierowuje drugi host tylko wtedy, gdy jego DNS również wskazuje na GitHub Pages.
Certyfikat nie pojawia się. Przejdź przez powyższą listę kontrolną, zaczynając od zbędnych rekordów.

Jeśli wolisz nie zajmować się DNS samodzielnie

GitHub Pages dobrze sprawdza się przy statycznych stronach, które i tak trzymasz w repozytorium. Jeśli zależy Ci głównie na tym, by strona z własną domeną działała w sieci, własne domeny w We.Inc prowadzą Cię przez ten sam krok DNS w samym kreatorze, a przewodnik po podłączaniu domeny opisuje to dla dowolnego dostawcy. Darmowy plan We.Inc pozwala opublikować do trzech stron z gotowych szablonów; kreator AI, który tworzy stronę na podstawie opisu, zaczyna się od planu Starter za $20 miesięcznie. Możesz zarejestrować się tutaj.

Zacznij za darmo · Bez karty kredytowej

Umair Ali Sadaqat

Założyciel We.Inc

Umair jest założycielem We.Inc. Pisze o tworzeniu stron z AI, agencjach i prowadzeniu studia internetowego.

Chcesz zbudować coś świetnego?

Dołącz do 15,000+ firm, które z We.Inc startują, rosną i automatyzują pracę, wszystko na jednej platformie.