Połącz domenę niestandardową

Nie musisz rezygnować z unikalnych nazw domen związanych z marką, które masz w usłudze Firebase Hosting. Zamiast domeny wygenerowanej przez Firebase możesz użyć domeny niestandardowej (np. example.com lub app.example.com) w przypadku witryny hostowanej w Firebase.

Firebase Hosting udostępnia certyfikat SSL dla każdej z Twoich domen i dostarcza treści za pomocą globalnej sieci CDN.

W pozostałej części tego dokumentu znajdziesz instrukcje, jak połączyć domenę niestandardową.

Konfigurowanie domeny na potrzeby Hosting

Upewnij się, że w projekcie Firebase masz witrynę Firebase Hosting. W tym celu wykonaj czynności opisane w kreatorze „Pierwsze kroki” na stronie Firebase Hosting projektu.

Krok 1. Dodaj domenę niestandardową

  1. Na Hostingstronie projektu otwórz kreator łączenia domeny niestandardowej:

    • Jeśli masz tylko 1 witrynę Hosting, kliknij Dodaj domenę niestandardową.
    • Jeśli masz więcej niż 1 witrynę, kliknij Wyświetl przy wybranej witrynie, a następnie kliknij Dodaj domenę niestandardową.Hosting

  2. Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witrynąHosting.

  3. (Opcjonalnie) Zaznacz pole, aby przekierowywać wszystkie żądania w domenie niestandardowej do drugiej określonej domeny (tak aby example.com i www.example.com przekierowywały do tej samej treści).

  4. Kliknij Dalej, aby skonfigurować rekordy DNS i zakończyć konfigurowanie własnej domeny.

Krok 2. Skonfiguruj domenę niestandardową

Jeśli w kreatorze konfiguracji Połącz domenę pojawi się odpowiednia prośba, potwierdź własność domeny głównej.

Dzięki tym czynnościom upewnisz się, że domena nie jest jeszcze połączona z projektem Firebase i że jesteś jej właścicielem.

  1. W witrynie dostawcy domeny znajdź stronę zarządzania DNS.

  2. Dodaj i zapisz nowy rekord z tymi danymi wejściowymi:

    • Typ: dodaj rekord TXT.

      Firebase Hosting wymaga, aby ten rekord TXT był stale obecny w ustawieniach DNS, co potwierdza własność domeny i umożliwia Firebase przypisywanie i odnawianie certyfikatów SSL dla Twojej witryny.

      Dostawca domeny może określać ten termin jako „Typ rekordu”.

    • Host: wpisz klucz domeny głównej.

      Potwierdzenie własności domeny najwyższego poziomu lub domeny głównej potwierdza własność wszystkich jej subdomen.

      Dostawca domeny może używać terminu „Nazwa hosta”, „Nazwa” lub „Domena”.

    • Wartość: skopiuj do tego pola unikalną wartość weryfikacyjną.

      Firebase Hosting sprawdza tę wartość, aby potwierdzić własność domeny.

      Dostawca domeny może używać terminu „Dane”.

  3. Odczekaj 24 godziny na rozpowszechnienie zaktualizowanych rekordów TXT, a potem kliknij Weryfikuj.

    Możesz kliknąć Anuluj, aby bezpiecznie zamknąć okno Połącz domenę i ponownie otworzyć je później. Nie wpłynie to na czas propagacji, ale po ponownym otwarciu okna pojawi się prośba o ponowne wpisanie nazwy domeny.

    Po upływie odpowiedniego czasu propagacji kliknięcie Zweryfikuj w oknie Połącz domenę konsoli Firebase umożliwia rozpoczęcie procesu udostępniania certyfikatu SSL.

    W większości przypadków propagacja rekordów i weryfikacja domeny nastąpi w ciągu kilku godzin, w zależności od dostawcy domeny. Szczegółowe instrukcje dodawania rekordów TXT i czasów propagacji znajdziesz w dokumentacji dostawcy domeny.

    Jeśli po kliknięciu Zweryfikuj pojawi się komunikat o błędzie, oznacza to, że Twoje rekordy nie zostały rozpowszechnione lub wartości mogą być nieprawidłowe.

W kreatorze Dodaj domenę niestandardową w konsoli Firebase wybierz Szybka konfiguracja lub Konfiguracja zaawansowana.

Szybka konfiguracja może być używana w przypadku nowych domen, które obecnie nie otrzymują ruchu, lub domen, które próbujesz przenieść z innej Hostingwitryny. Konfiguracja zaawansowana może być używana, jeśli masz już domenę, która otrzymuje żądania od innego dostawcy hostingu, i potrzebujesz migracji bez przestoju.

Kreator Konfiguracja zaawansowana pomoże Ci utworzyć certyfikat SSL i potwierdzić prawo własności, aby umożliwić Hosting obsługę ruchu w domenie przed jego otrzymaniem.

Poczekaj na udostępnienie certyfikatu SSL

Po potwierdzeniu własności domeny udostępnimy certyfikat SSL dla Twojej domeny i wdrożymy go w naszej globalnej sieci CDN w ciągu 24 godzin od momentu, gdy skierujesz rekordy A DNS na adres Firebase Hosting.

Twoja domena będzie wymieniona jako jedna z alternatywnych nazw podmiotów (SAN) w certyfikacie SSL FirebaseApp. Ten certyfikat możesz wyświetlić za pomocą narzędzi zabezpieczających przeglądarki. Podczas udostępniania domeny może pojawić się nieprawidłowy certyfikat, który nie zawiera nazwy domeny. Jest to normalna część procesu, która zostanie rozwiązana po udostępnieniu certyfikatu domeny.

W przypadku użytkowników konfiguracji zaawansowanej witryna będzie hostowana przez poprzedniego dostawcę hostingu, dopóki stan konfiguracji na stronie Firebase Hosting projektu nie zmieni się na Połączono.

Klucz domeny niestandardowej

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują, że w polu Host na ich stronach zarządzania DNS wpiszesz różne dane. Poniżej zebraliśmy typowe dane wejściowe od popularnych dostawców. Szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Typ domeny Klucz domeny niestandardowej
Domena najwyższego poziomu

Typowe dane wejściowe to:

  • @
  • Nazwa domeny najwyższego poziomu (np. example.com)
  • Pozostawienie pustego pola Host
Subdomena

Typowe dane wejściowe to:

  • Pełna nazwa subdomeny (np. app.example.com)
  • Tylko część adresu z subdomeną (np. tylko app, bez .example.com).
  • Tylko www w przypadku subdomeny www.example.com

Popularni dostawcy domen

Oto niektórzy popularni dostawcy domen i rodzaje danych wejściowych, których mogą wymagać. Staramy się, aby te informacje były jak najbardziej aktualne, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Opisy stanu konfiguracji domen niestandardowych

Stan Opis
Wymaga konfiguracji

Może być konieczne wprowadzenie zmian w konfiguracji rekordów DNS.

  • W większości przypadków rekordy A DNS nie zostały jeszcze rozpowszechnione z usługi dostawcy nazwy domeny na serwery Firebase Hosting.
    Wskazówka: jeśli minęło ponad 24 godziny, sprawdź, czy rekordy wskazują na Firebase Hosting.

  • W rzadszych przypadkach, zwłaszcza jeśli korzystasz z procesu Konfiguracja zaawansowana, testy SSL mogą się nie powieść z tych powodów:

    • Wyzwania związane z certyfikatem SSL nie powiodły się, a token (rekordy DNS TXT lub przesłany plik udostępniony w witrynie) jest teraz nieprawidłowy.
      Wskazówka: kliknij Wyświetl obok domeny, a potem podaj nowy token w przypadku istniejącej domeny.
Oczekuje

Własna domena została prawidłowo skonfigurowana, ale Firebase Hostingnie udostępnił certyfikatu SSL.

Czasami następujące problemy mogą opóźnić wygenerowanie certyfikatu SSL dla domeny niestandardowej:

  • Rekordy CAA są zbyt restrykcyjne.
    Wskazówka: sprawdź, czy urzędy certyfikacji `letsencrypt.org` i `pki.goog` mogą tworzyć certyfikaty SSL dla Twojej domeny.
  • Kod weryfikacyjny jest nieprawidłowy.
    Jeśli korzystasz z zaawansowanego procesu konfiguracji, a migracja się nie powiodła, token (i jego kod weryfikacyjny) jest teraz nieprawidłowy.
    Wskazówka: kliknij Wyświetl obok domeny, a potem podaj nowy token w przypadku istniejącej domeny.
  • Poproszono o certyfikaty dla zbyt wielu subdomen.
    Wskazówka dotycząca rozwiązywania problemów: Firebase Hosting zaleca, aby w jednej domenie niższej kategorii nie było więcej niż 20 subdomen ze względu na limity generowania certyfikatów SSL.
Certyfikat wybicia

Dla Twojej domeny jest generowany certyfikat SSL.
Połączono

Twoja domena niestandardowa ma odpowiednie rekordy DNS i certyfikat SSL.
Możesz wyświetlać treści witryny.