Połącz domenę niestandardową

W Hostingu Firebase nie musisz rezygnować z unikalnych nazw domen związanych z marką z Firebase Hosting. Zamiast domeny wygenerowanej przez Firebase możesz używać 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.

Z dalszej części tego dokumentu dowiesz się, jak połączyć domenę niestandardową.

Konfigurowanie domeny na potrzeby Hosting

Upewnij się, że w projekcie w Firebase został ukończony kreator "Pierwsze kroki" ze strony Firebase Hosting aby mieć witrynę Firebase Hosting w projekcie w Firebase.

Krok 1. Dodaj domenę niestandardową

  1. Na stronie projektuHosting otwórz kreator łączenia domeny niestandardowej:

    • 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 następnie 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, aby potwierdzić własność domeny i upoważnić 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

Po potwierdzeniu własności domeny udostępniamy certyfikat SSL dla Twojej domeny i wdrażamy 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. Ten certyfikat możesz wyświetlić 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 Firebase Hosting na stronie Hostingu Firebase w projekcie nie zmieni się na Połączono.

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

Typowi dostawcy domen

Oto kilku typowych dostawców domen i rodzaje danych, których mogą wymagać. Te informacje są aktualizowane na bieżąco, 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 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 dla domeny niestandardowej może zostać wstrzymane z tych powodó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 się nie powiodła, 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: ze względu na limity tworzenia certyfikatów SSL Firebase Hosting zaleca, aby w przypadku 1 domeny niestandardowej nie używać więcej niż 20 subdomen.
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.