Jak działają domeny w headlessowym Cmssy

Cmssy to headless CMS z wizualnym edytorem. Twoje treści żyją w panelu Cmssy i są serwowane przez delivery API, a właściwa strona to aplikacja Next.js (App Router), którą budujesz z @cmssy/react i @cmssy/next i wdrażasz samodzielnie (np. na Vercel). Cmssy nie hostuje Twojej strony.

Ponieważ to Ty jesteś właścicielem wdrożenia, własna domena kieruje na Twój hosting, a nie na Cmssy. Domenę dodajesz tam, gdzie wdrożona jest strona, konfigurujesz DNS u rejestratora, a certyfikat SSL wystawia Twój hosting. Po stronie Cmssy ustawiasz Preview URL przestrzeni roboczej, aby edytor osadzał Twoją wdrożoną stronę do wizualnej edycji.

Dlaczego warto używać własnej domeny

Użycie własnej domeny dla headlessowej strony oferuje kilka ważnych korzyści:

• Profesjonalizm — Własna domena jak twojafirma.pl wygląda znacznie bardziej profesjonalnie niż domyślny adres wdrożenia. Pokazuje odwiedzającym, że poważnie podchodzisz do swojej obecności w internecie.
• Branding — Twoja domena jest częścią tożsamości marki. Zapamiętywalna domena wzmacnia rozpoznawalność marki za każdym razem, gdy ktoś odwiedza lub udostępnia Twój adres URL.
• Korzyści SEO — Wyszukiwarki preferują ustalone własne domeny. Z czasem Twoja domena buduje autorytet i poprawia pozycję w wynikach wyszukiwania.
• Spójność e-mail — Z własną domeną możesz używać pasujących adresów e-mail (np. kontakt@twojafirma.pl) dla spójnego i wiarygodnego doświadczenia marki.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

• Wdrożoną stronę Cmssy — Aplikację Next.js połączoną z Twoją przestrzenią roboczą za pomocą @cmssy/react i @cmssy/next. Zobacz poradnik instalacji i szybki start, jeśli jeszcze nie wdrożyłeś strony.
• Konto u dostawcy hostingu — Tam, gdzie wdrożyłeś stronę (np. Vercel). Własne domeny i SSL obsługiwane są właśnie tam.
• Domenę zarejestrowaną u dowolnego rejestratora — Możesz użyć Cloudflare Registrar (ceny po kosztach), Namecheap, Porkbun lub dowolnego innego rejestratora domen.

Krok 1: Wdróż swoją headlessową stronę

Zanim podłączysz domenę, upewnij się, że strona jest zbudowana i wdrożona:

1. Zbuduj aplikację Next.js z blokami Cmssy używając @cmssy/react i @cmssy/next.
2. Wdróż ją na swój hosting (np. wypchnij do repozytorium Git połączonego z Vercel).
3. Potwierdź, że wdrożenie działa pod domyślnym adresem (np. twoja-strona.vercel.app).

To właśnie ta wdrożona aplikacja będzie celem Twojej własnej domeny.

Krok 2: Dodaj domenę u swojego hostingu

W panelu dostawcy hostingu (Vercel jako przykład):

1. Otwórz swój projekt i przejdź do Settings → Domains.
2. Kliknij Add i wpisz nazwę domeny, na przykład: example.com.
3. Dodaj również wariant www, jeśli go chcesz: www.example.com.

Hosting wyświetli dokładne rekordy DNS, które musisz skonfigurować w następnym kroku.

Krok 3: Skonfiguruj rekordy DNS

Przejdź do panelu zarządzania DNS u swojego rejestratora domen i dodaj rekordy, które podał Ci hosting. Dla Vercel zwykle wyglądają tak:

Rekord CNAME dla www kieruje subdomenę www na Twój hosting. Rekord A dla domeny głównej (@) kieruje korzeń domeny na adres IP Twojego hostingu. Zawsze używaj dokładnych wartości pokazanych w panelu hostingu — mogą się różnić między dostawcami i z czasem.

Krok 4: Zweryfikuj domenę

Po dodaniu rekordów DNS:

1. Wróć do sekcji Domains w panelu hostingu.
2. Hosting sprawdza rekordy automatycznie i oznacza domenę jako poprawną, gdy się rozpropagują.

Propagacja DNS może potrwać do 48 godzin, ale w większości przypadków kończy się w ciągu 15–30 minut. Jeśli domena pokazuje się jako niepoprawna, poczekaj chwilę i sprawdź ponownie.

Krok 5: Certyfikat SSL

Gdy domena się rozpropaguje, Twój hosting automatycznie wystawia SSL — Cmssy nie bierze udziału w tym kroku:

• Automatyczne provisjonowanie SSL — Hostingi jak Vercel wystawiają certyfikat (np. przez Let's Encrypt) dla Twojej domeny.
• HTTPS domyślnie włączony — Cały ruch jest automatycznie przekierowywany na HTTPS.
• Brak potrzeby ręcznej konfiguracji — Odnowienie certyfikatu obsługuje Twój hosting.

Twoja strona będzie dostępna pod adresem https://twojadomena.com w ciągu kilku minut od rozpropagowania domeny.

Krok 6: Ustaw Preview URL w Cmssy

Aby wizualny edytor osadzał właściwą stronę, wskaż Cmssy Twoją działającą domenę:

1. Zaloguj się do panelu administracyjnego Cmssy.
2. Przejdź do Settings → Headless.
3. Ustaw Preview URL na swoją wdrożoną stronę (np. https://twojadomena.com).

Teraz edytor Cmssy ładuje Twoją wdrożoną stronę do wizualnej edycji w kontekście, podczas gdy treści nadal są serwowane przez delivery API.

Popularne dostawcy DNS

Oto krótkie instrukcje dla popularnych rejestratorów domen. W każdym przypadku użyj dokładnych wartości rekordów podanych przez Twój hosting.

GoDaddy

1. Przejdź do Moje produkty → wybierz swoją domenę → DNS.
2. Kliknij Dodaj rekord i wpisz rekordy CNAME i A z Twojego hostingu.
3. Zapisz zmiany.

Namecheap

1. Przejdź do Lista domen → kliknij Zarządzaj obok swojej domeny.
2. Wybierz zakładkę Zaawansowany DNS.
3. Dodaj rekordy CNAME i A.
4. Zapisz wszystkie zmiany.

Cloudflare

1. Wybierz swoją domenę w panelu Cloudflare.
2. Przejdź do DNS → Rekordy.
3. Dodaj rekord CNAME w trybie Tylko DNS (szara ikona chmurki — nie proxy).
4. Dodaj rekord A.

Porkbun

1. Przejdź do Konto → Zarządzanie domenami → wybierz swoją domenę.
2. Otwórz edytor Rekordy DNS.
3. Dodaj rekordy CNAME i A.
4. Zapisz.

Rozwiązywanie problemów

Domena się nie rozpropagowuje

• Sprawdź propagację DNS — Użyj narzędzi takich jak dig lub nslookup w terminalu, lub narzędzi online jak whatsmydns.net, aby potwierdzić, że Twoje rekordy zostały rozpropagowane.
• Potwierdź zgodność wartości z hostingiem — Sprawdź rekordy CNAME/A względem tego, co pokazuje panel Domains Twojego hostingu.
• Poczekaj dłużej — Propagacja może potrwać do 48 godzin w rzadkich przypadkach. Bądź cierpliwy.

Problemy z SSL

• Konflikt z proxy CDN — Jeśli używasz Cloudflare w trybie proxy, może to kolidować z provisioningiem SSL Twojego hostingu. Przełącz na tryb tylko DNS, aby hosting mógł wystawić certyfikat.

WWW vs domena główna

• Zarówno www.example.com jak i example.com powinny być skonfigurowane u Twojego hostingu. Dodaj zarówno rekord CNAME (dla www) jak i rekord A (dla domeny głównej), aby odwiedzający mogli dotrzeć do Twojej strony niezależnie od tego, którego adresu URL użyją.

Edytor pokazuje niewłaściwą stronę

• Jeśli edytor Cmssy osadza stary lub domyślny adres, zaktualizuj Preview URL w Settings → Headless na swoją działającą domenę.

Najlepsze praktyki

• Zawsze konfiguruj zarówno www jak i domenę główną — Zapewnia to, że odwiedzający mogą uzyskać dostęp do Twojej strony z obu wariantów adresu URL.
• Skonfiguruj e-mail osobno — Własna domena e-mail (np. przez Google Workspace lub Zoho) wymaga osobnych rekordów MX i nie będzie kolidować z rekordami DNS kierującymi stronę na hosting.
• Użyj trybu tylko DNS, jeśli korzystasz z Cloudflare — Tryb proxy Cloudflare może zakłócać certyfikaty SSL Twojego hostingu. Użyj szarej chmurki (tylko DNS) dla rekordów wskazujących na hosting.
• Utrzymuj Preview URL w synchronizacji — Gdy zmienia się Twoja domena produkcyjna, zaktualizuj Preview URL w Settings → Headless, aby edytor nadal osadzał właściwą stronę.