Połącz domenę niestandardową

W Hostingu Firebase nie musisz rezygnować z unikalnych nazw domen, które są związane z Twoją marką z 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 udostępnia treści w globalnej sieci CDN.

W dalszej części tego dokumentu znajdziesz opis tych czynności, które pozwolą Ci połączyć domenę niestandardową.

Konfigurowanie domeny na potrzeby Hosting

Upewnij się, że w projekcie Firebase masz witrynę w Hostingu Firebase. W tym celu na stronie Hostingu Firebase w projekcie musisz przejść przez kreator „Pierwsze kroki”.Firebase HostingFirebase Hosting

Krok 1. Dodaj domenę niestandardową

  1. Na stronie w projekcie otwórz kreator łączenia domeny niestandardowej:Hosting

    • Jeśli masz tylko 1 witrynę Hosting, kliknij Dodaj domenę niestandardową.
    • Jeśli masz więcej niż 1 Hosting witrynę, kliknij Wyświetl w przypadku wybranej witryny, a potem kliknij Dodaj domenę niestandardową.

  2. Wpisz nazwę domeny niestandardowej, którą chcesz połączyć z witryną w Hosting.

  3. (Opcjonalnie) Zaznacz pole, aby przekierować 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 dokończyć konfigurowanie domeny niestandardowej.

Krok 2. Skonfiguruj domenę niestandardową

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

Te czynności zapewniają, że Twoja domena nie jest jeszcze połączona z projektem w Firebase i że jesteś właścicielem określonej domeny.

  1. Na stronie dostawcy domeny znajdź stronę zarządzania DNS.

  2. Dodaj i zapisz nowy rekord z tymi danymi:

    • Typ: dodaj rekord TXT.

      Firebase Hosting wymaga, aby ten rekord TXT był stale obecny w ustawieniach DNS. Dzięki temu potwierdzisz własność domeny i upoważnisz Firebase do przypisywania i odnawiania certyfikatów SSL dla Twojej witryny.

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

    • Osoba prowadząca: wpisz klucz domeny głównej.

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

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

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

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

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

  3. Poczekaj do 24 godzin na rozpowszechnienie zaktualizowanych rekordów TXT, a następnie kliknij Weryfikuj.

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

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

    W większości przypadków rozpowszechnienie 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 informacje o czasie rozpowszechniania znajdziesz w dokumentacji dostawcy domeny.

    Jeśli po kliknięciu Weryfikuj pojawi się komunikat o błędzie, oznacza to, że 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 Hosting witryny. Konfiguracja zaawansowana może być używana, jeśli masz już domenę, która otrzymuje żądania od innego dostawcy hostingu, i potrzebujesz migracji bez przestojów.

Kreator Konfiguracja zaawansowana pomoże Ci utworzyć certyfikat SSL i zgłosić prawa własności, aby Hosting mógł obsługiwać ruch w domenie przed jego otrzymaniem.

Czekanie na udostępnienie certyfikatu SSL

Gdy potwierdzimy własność domeny, udostępnimy dla niej certyfikat SSL i wdrożymy go w naszej globalnej sieci CDN w ciągu 24 godzin od przekierowania rekordów DNS A do Firebase Hosting.

Twoja domena będzie wymieniona jako jedna z alternatywnych nazw podmiotów (SAN) w certyfikacie SSL FirebaseApp. Możesz wyświetlić ten certyfikat za pomocą narzędzi zabezpieczeń przeglądarki. Podczas udostępniania domeny może pojawić się nieprawidłowy certyfikat, który nie zawiera nazwy Twojej domeny. Jest to normalna część procesu, a problem zostanie rozwiązany, gdy certyfikat domeny będzie dostępny.

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

Klucz domeny niestandardowej

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen wymagają wpisania różnych danych w polu Osoba prowadząca na swoich stronach zarządzania DNS. Poniżej zebraliśmy typowe dane od popularnych dostawców. Szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Typ domeny Klucz domeny niestandardowej
Domena główna

Typowe dane:

  • @
  • Nazwa domeny głównej (np. example.com)
  • Pozostawienie pola Osoba prowadząca pustego
Subdomena

Typowe dane:

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

Popularni dostawcy domen

Oto kilku popularnych dostawców domen i typy danych, których mogą wymagać. Staramy się, aby te informacje były jak najbardziej aktualne, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Opisy stanów konfiguracji domen niestandardowych

Stan Opis
Wymaga konfiguracji

Może być konieczna zmiana konfiguracji rekordów DNS.

  • W większości przypadków rekordy DNS A nie zostały rozpowszechnione z serwerów dostawcy nazw domen na serwery Firebase Hosting.
    Wskazówka dotycząca rozwiązywania problemów: jeśli minęły ponad 24 godziny, sprawdź, czy rekordy zostały przekierowane do Firebase Hosting.

  • W rzadszych przypadkach, zwłaszcza jeśli używasz konfiguracji zaawansowanej , wyzwania SSL mogą się nie powieść, ponieważ:

    • Wyzwania certyfikatu SSL nie powiodły się, a token (rekordy DNS TXT lub przesłany plik udostępniony w witrynie) jest teraz nieprawidłowy.
      Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl w przypadku domeny, a następnie podaj nowy token w istniejącej domenie.
Oczekuje

Domena niestandardowa została prawidłowo skonfigurowana, ale Firebase Hosting nie udostępnił certyfikatu SSL.

Czasami tworzenie certyfikatu SSL certyfikatu dla domeny niestandardowej może zostać wstrzymane z powodu tych problemów:

  • Rekordy CAA są zbyt restrykcyjne.
    Wskazówka dotycząca rozwiązywania problemów: upewnij się, że urzędy certyfikacji `letsencrypt.org` i `pki.goog` mogą tworzyć certyfikaty SSL dla Twojej domeny.
  • Kod wyzwania jest nieprawidłowy.
    Jeśli używasz konfiguracji zaawansowanej i migracja nie powiodła się, token (i jego kod wyzwania) jest teraz nieprawidłowy.
    Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl w przypadku domeny, a następnie podaj nowy token w istniejącej domenie.
  • Poproszono o certyfikaty dla zbyt wielu subdomen.
    Wskazówka dotycząca rozwiązywania problemów: Ogólnie rzecz biorąc, Firebase Hosting zaleca, aby w przypadku 1 domeny niestandardowej najwyższego poziomu nie używać więcej niż 20 subdomen ze względu na limity tworzenia certyfikatów SSL.
Tworzenie certyfikatu

Trwa tworzenie certyfikatu SSL dla Twojej domeny.
Połączono

Twoja domena niestandardowa ma prawidłowe rekordy DNS i certyfikat SSL certyfikat.
Możesz udostępniać treści witryny.