Catch up on highlights from Firebase at Google I/O 2023. Learn more

Połącz niestandardową domenę

Dzięki Firebase Hosting nie musisz rezygnować ze swoich unikalnych, zorientowanych na markę nazw domen. Możesz użyć domeny niestandardowej (takiej jak example.com lub app.example.com ) zamiast domeny wygenerowanej przez Firebase dla swojej witryny hostowanej przez Firebase.

Firebase Hosting zapewnia certyfikat SSL dla każdej z Twoich domen i udostępnia Twoje treści za pośrednictwem globalnej sieci CDN.

Pozostała część tego dokumentu przeprowadzi Cię przez te kroki, aby połączyć domenę niestandardową.

Skonfiguruj swoją domenę dla Hostingu

Upewnij się, że ukończyłeś działanie kreatora „Rozpocznij” na stronie Hostingu Firebase Twojego projektu, aby mieć witrynę Hostingu Firebase w swoim projekcie Firebase.

Krok 1 : Dodaj domenę

  1. Na stronie Hosting Twojego projektu wejdź do kreatora łączenia domeny niestandardowej:

    • Jeśli masz tylko jedną witrynę hostingową, kliknij Dodaj domenę niestandardową .
    • Jeśli masz więcej niż jedną witrynę hostingową , kliknij Wyświetl żądaną witrynę, a następnie kliknij Dodaj domenę niestandardową .
  2. Wprowadź niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną hostingową.

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

  4. Kliknij Kontynuuj , aby rozpocząć proces sprawdzania poprawności.

Krok 2 : Zweryfikuj własność domeny

Jeśli zostaniesz o to poproszony w kreatorze konfiguracji Connect Domain , zweryfikuj swoją domenę wierzchołkową.

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

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

  2. Dodaj i zapisz nowy rekord z następującymi danymi wejściowymi:

    • Wpisz : Dodaj rekord TXT.

      Hosting Firebase wymaga ciągłego przechowywania tego rekordu TXT w ustawieniach DNS, aby udowodnić, że jesteś właścicielem domeny i upoważnić Firebase do przypisywania i odnawiania certyfikatów SSL dla Twojej witryny.

      Twój dostawca domeny może podać ten termin jako „Typ rekordu”.

    • Host : Wprowadź klucz domeny wierzchołka .

      Udowodnienie, że jesteś właścicielem domeny wierzchołkowej lub domeny głównej, potwierdza, że ​​jesteś właścicielem wszystkich jej subdomen.

      Twój dostawca domeny może podać ten termin jako „Nazwa hosta”, „Nazwa” lub „Domena”.

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

      Firebase Hosting sprawdza tę wartość, aby udowodnić, że jesteś właścicielem domeny.

      Twój dostawca domeny może podać ten termin jako „Dane”.

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

    Pamiętaj, że możesz kliknąć Anuluj , aby bezpiecznie zamknąć okno Połącz domenę i otworzyć je ponownie później. Nie wpływa to na czas propagacji, ale po ponownym otwarciu okna pojawi się monit o ponowne wprowadzenie nazwy domeny .

    Po długim czasie propagacji kliknięcie opcji Zweryfikuj w oknie Połącz domenę konsoli Firebase umożliwia rozpoczęcie procesu udostępniania certyfikatu SSL.

    W większości przypadków propagacja Twoich rekordów i weryfikacja domeny nastąpi w ciągu kilku godzin, w zależności od dostawcy domeny. Zapoznaj się z dokumentacją dostawcy domeny, aby uzyskać szczegółowe instrukcje dotyczące dodawania rekordów TXT i czasów propagacji.

    Jeśli kliknięcie przycisku Zweryfikuj powoduje wyświetlenie komunikatu o błędzie, rekordy nie zostały rozpowszechnione lub wartości mogą być nieprawidłowe.

Krok 3 : Rozpocznij transmisję na żywo

W oknie Połącz domenę konsoli Firebase wybierz Szybka konfiguracja dla nowej witryny lub Konfiguracja zaawansowana , jeśli masz już witrynę działającą u innego dostawcy usług hostingowych i potrzebujesz migracji bez przestojów.

Poczekaj na udostępnienie certyfikatu SSL

Po zweryfikowaniu 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 skierowania rekordów DNS A do Firebase Hosting.

Twoja domena zostanie wymieniona jako jedna z alternatywnych nazw podmiotu (SAN) w certyfikacie SSL FirebaseApp. Możesz wyświetlić ten certyfikat za pomocą narzędzi bezpieczeństwa przeglądarki. Podczas udostępniania domeny możesz zobaczyć nieprawidłowy certyfikat, który nie zawiera nazwy Twojej domeny. Jest to normalna część procesu i zostanie rozwiązana po udostępnieniu certyfikatu Twojej domeny.

W przypadku użytkowników korzystających z konfiguracji zaawansowanej Twoja witryna będzie hostowana przez poprzedniego dostawcę usług hostingowych, dopóki stan konfiguracji na stronie Firebase Hosting Twojego projektu nie zmieni się na Połączony .

Twój niestandardowy klucz domeny

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują różnych danych wejściowych w polu Host w swoich witrynach zarządzania DNS. Poniżej zebraliśmy typowe dane wejściowe od popularnych dostawców. Szczegółowe instrukcje można znaleźć w dokumentacji dostawcy domeny.

Typ domeny Niestandardowy klucz domeny
Domena wierzchołka

Typowe dane wejściowe obejmują:

  • @
  • Nazwa domeny wierzchołka (na przykład example .com )
  • Pozostawienie pustego pola Gospodarz
Subdomena

Typowe dane wejściowe obejmują:

  • Pełna nazwa subdomeny (np. app. example .com )
  • Tylko część subdomeny (na przykład tylko app , pomijając . example .com )
  • Tylko www dla subdomeny www. example .com

Wspólni dostawcy domen

Oto kilku typowych dostawców domen i rodzaje danych wejściowych, których każdy z nich może wymagać. Informacje te są w miarę możliwości aktualizowane, ale szczegółowe instrukcje można znaleźć w dokumentacji dostawcy domeny.

Skonfiguruj opisy stanu dla domen niestandardowych

Status Opis
Wymaga konfiguracji

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

  • W większości przypadków Twoje rekordy DNS A nie zostały przeniesione z dostawcy nazwy domeny na serwery Hostingu Firebase.
    Wskazówka dotycząca rozwiązywania problemów: jeśli minęło więcej niż 24 godziny, sprawdź, czy Twoje rekordy zostały skierowane do Firebase Hosting.

  • W rzadszych przypadkach, zwłaszcza jeśli korzystasz z procedury konfiguracji zaawansowanej, testy SSL mogą kończyć się niepowodzeniem, ponieważ:

    • Twoje rekordy DNS zawierają rekordy A lub rekordy CNAME, które wskazują innych dostawców usług hostingowych.
      Wskazówka dotycząca rozwiązywania problemów: sprawdź, czy Twoje rekordy A wskazują tylko na Firebase Hosting, i usuń wszystkie rekordy CNAME.
    • Migracja nie powiodła się, a token (rekordy DNS TXT lub przesłany plik dostarczony do Twojej witryny) jest teraz nieprawidłowy.
      Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl dla domeny, a następnie podaj nowy token dla istniejącej domeny.
Aż do

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

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

  • Twoje akta CAA są zbyt restrykcyjne.
    Wskazówka dotycząca rozwiązywania problemów: upewnij się, że urzędy certyfikacji `letsencrypt.org` i `pki.goog` mają uprawnienia do tworzenia certyfikatów SSL dla Twojej domeny.
  • Twój kod wyzwania jest nieprawidłowy.
    Jeśli używasz przepływu konfiguracji zaawansowanej i migracja nie powiodła się, token (i jego kod wezwania) są teraz nieprawidłowe.
    Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl dla domeny, a następnie podaj nowy token dla istniejącej domeny.
  • Zażądano certyfikatów dla zbyt wielu subdomen.
    Wskazówka dotycząca rozwiązywania problemów: Ogólnie rzecz biorąc, Firebase Hosting zaleca nie więcej niż 20 subdomen w jednej niestandardowej domenie wierzchołka ze względu na ograniczenia dotyczące tworzenia certyfikatów SSL.
Połączony

Twoja domena niestandardowa ma odpowiednie rekordy DNS i certyfikat SSL.
Możesz udostępniać zawartość swojej witryny.

Wymaga ponownej weryfikacji

Firebase może wymagać ręcznej ponownej weryfikacji własności domeny, jeśli rekord TXT dodany podczas wstępnej weryfikacji własności domeny został zmieniony lub usunięty z ustawień DNS domeny.

  • Pamiętaj, że w jednej domenie dozwolonych jest wiele rekordów TXT z tokenem weryfikacji witryny Google.
  • Wymagamy, aby rekord TXT był stale obecny w Twoich ustawieniach DNS, ponieważ potwierdza to, że jesteś właścicielem domeny i upoważnia nas do przypisywania i odnawiania certyfikatów SSL dla Twojej witryny.
Wskazówka dotycząca rozwiązywania problemów: odwiedź stronę Hosting swojego projektu, aby zakończyć proces ponownej weryfikacji w określonym przedziale czasowym (zwykle 30 dni), aby uniknąć automatycznego odłączania domeny niestandardowej od Hostingu Firebase.