Połącz niestandardową domenę

Dzięki Firebase Hosting nie musisz rezygnować ze swoich unikalnych, skupionych na marce 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 Twojej domeny i udostępnia Twoje treści za pośrednictwem globalnej sieci CDN.

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

Skonfiguruj swoją domenę pod kątem hostingu

Upewnij się, że ukończyłeś kreator „Rozpocznij” na stronie Firebase Hosting swojego projektu, aby mieć witrynę Firebase Hosting w swoim projekcie Firebase.

Krok 1 : Dodaj domenę niestandardową

  1. Na stronie Hosting swojego projektu przejdź do kreatora podłączania domeny niestandardowej:

    • Jeśli masz tylko jedną witrynę hostingową, kliknij Dodaj domenę niestandardową .
    • Jeśli masz więcej niż jedną witrynę hostingową , kliknij opcję Wyświetl odpowiednią witrynę, a następnie kliknij opcję Dodaj domenę niestandardową .

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

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

  4. Kliknij Kontynuuj , aby skonfigurować rekordy DNS i dokończ konfigurowanie domeny niestandardowej.

Krok 2 : Skonfiguruj domenę niestandardową

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

Wykonanie tych kroków gwarantuje, ż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, aby ten rekord TXT był stale obecny 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 wymienić ten termin jako „typ rekordu”.

    • Host : Wprowadź klucz domeny wierzchołkowej .

      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.

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

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

  3. Poczekaj do 24 godzin na propagację 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 ma to wpływu na czas propagacji, ale po ponownym otwarciu okna zostaniesz poproszony o ponowne wprowadzenie nazwy domeny .

    Po upływie wystarczającego czasu propagacji kliknięcie Weryfikuj w oknie Połącz domenę konsoli Firebase umożliwia rozpoczęcie procesu dostarczania 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. Szczegółowe instrukcje dotyczące dodawania rekordów TXT i czasów propagacji można znaleźć w dokumentacji dostawcy domeny.

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

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

Szybkiej konfiguracji można użyć w przypadku nowych domen, które obecnie nie generują ruchu, lub domen, które próbujesz przenieść z innej witryny hostingowej. Z konfiguracji zaawansowanej można skorzystać, jeśli masz już domenę otrzymującą żądania od innego dostawcy usług hostingowych i potrzebujesz migracji bez przestojów.

Kreator konfiguracji zaawansowanej pomoże Ci ustanowić certyfikat SSL i roszczenie własności, aby umożliwić Hostingowi obsługę ruchu w domenie przed otrzymaniem ruchu.

Poczekaj na udostępnienie certyfikatu SSL

Po zweryfikowaniu własności domeny zapewniamy certyfikat SSL dla Twojej domeny i wdrażamy go w naszej globalnej sieci CDN w ciągu 24 godzin od skierowania rekordów A DNS 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, gdy certyfikat Twojej domeny będzie dostępny.

W przypadku użytkowników konfiguracji zaawansowanej Twoja witryna będzie hostowana przez poprzedniego dostawcę usług hostingowych do czasu, gdy stan konfiguracji na stronie Hostingu Firebase Twojego projektu zmieni się na Połączony .

Twój niestandardowy klucz domeny

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

Typ domeny Niestandardowy klucz domeny
domena Apex

Typowe dane wejściowe obejmują:

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

Typowe dane wejściowe obejmują:

  • Pełna nazwa subdomeny (na przykład app. example .com )
  • Tylko część subdomeny (na przykład tylko app , z pominięciem . example .com )
  • Tylko www dla subdomeny www. example .com

Typowi dostawcy domen

Oto kilku typowych dostawców domen i rodzaje danych wejściowych, których każdy może wymagać. Informacje te są aktualizowane w miarę możliwości, 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 przesłane od dostawcy nazwy domeny do serwerów Firebase Hosting.
    Wskazówka dotycząca rozwiązywania problemów: jeśli minęły więcej niż 24 godziny, sprawdź, czy skierowałeś swoje dane do Firebase Hosting.

  • W rzadszych przypadkach, szczególnie jeśli korzystasz z konfiguracji zaawansowanej, wyzwania SSL mogą zakoń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 rekordy A wskazują tylko na Hosting Firebase 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 opcję Wyświetl dla domeny, a następnie podaj nowy token dla istniejącej domeny.
Aż do

Poprawnie skonfigurowałeś domenę niestandardową, ale Hosting Firebase nie udostępnił certyfikatu SSL.

Czasami następujące problemy mogą uniemożliwić wytworzenie certyfikatu SSL dla domeny niestandardowej:

  • Twoje dane 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.
  • Twój kod wyzwania jest nieprawidłowy.
    Jeśli korzystasz z konfiguracji zaawansowanej i migracja nie powiodła się, Twój token (i jego kod wezwania) są teraz nieprawidłowe.
    Wskazówka dotycząca rozwiązywania problemów: Kliknij opcję 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 domenie niestandardowej Apex ze względu na limity dotyczące tworzenia certyfikatów SSL.
Świadectwo mennicze

Trwa generowanie certyfikatu SSL dla Twojej domeny.

Połączony

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