Połącz domenę niestandardową

Nie musisz rezygnować ze swoich unikalnych, skoncentrowanych na marce nazw domen Firebase Hosting Możesz użyć domeny niestandardowej (takiej jak example.com lub app.example.com) zamiast domeny wygenerowanej przez Firebase dla Twojej Witryna hostowana w Firebase.

Firebase Hosting udostępnia certyfikat SSL dla każdej z Twoich domen i wyświetla Twoje treści w globalnej sieci CDN.

W dalszej części tego dokumentu znajdziesz instrukcje łączenia domeny niestandardowej.

Skonfiguruj domenę dla usługi Hosting

Upewnij się, że wykonano wszystkie czynności podane w artykule „Pierwsze kroki”. z poziomu swojego projektu Firebase Hosting strona aby mieć witrynę Firebase Hosting w projekcie Firebase.

Krok 1. Dodaj domenę niestandardową

  1. Źródło: Hosting, otwórz kreator łączenia z domeną niestandardową:

    • Jeśli masz tylko jedną witrynę Hosting, kliknij Dodaj domenę niestandardową.
    • Jeśli masz więcej niż jedną witrynę Hosting, kliknij Wyświetl obok odpowiedniej witryny, a następnie kliknij Dodaj domenę niestandardową.

  2. Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoim urządzeniem Hosting witrynie.

  3. (Opcjonalnie) Zaznacz pole wyboru, aby przekierowywać wszystkie żądania z domeny niestandardowej do drugą określoną domenę (taką jak example.com i www.example.com przekierowują do tej samej treści).

  4. Kliknij Dalej, aby skonfigurować rekordy DNS i ukończyć konfigurowanie domeny niestandardowej.

Krok 2. Skonfiguruj domenę niestandardową

Jeśli w kreatorze konfiguracji Connect Domains pojawi się prośba w kreatorze konfiguracji, zweryfikować domenę apex.

Dzięki tym czynnościom możesz się upewnić, że Twoja domena nie jest już 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 ciągłego przechowywania tego rekordu TXT w ustawieniach DNS, aby potwierdzić własność domeny oraz upoważnić Firebase do przypisywania i odnawiania certyfikatów SSL Twojej witryny.

      Dostawca domeny może wskazać ten termin jako „Record Type” (Typ rekordu).

    • Host: wpisz kluczem domeny apex.

      Dowód własności domeny najwyższego poziomu, czyli domeny głównej, wszystkich subdomen.

      Dostawca domeny może wymienić ten termin jako „Host Name”, „Name” (Nazwa hosta), lub „Domena”.

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

      Firebase Hosting sprawdza tę wartość, aby potwierdzić, że domena należy do Ciebie.

      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ąć Połącz domenę. i ponownie otworzyć w późniejszym czasie. Nie ma to wpływu na propagację ale pojawi się prośba o ponownie wpisz nazwę domeny, gdy ponownie otworzysz to okno.

    Po upływie wystarczającego czasu na propagację kliknięcie Zweryfikuj w oknie Połącz domenę w 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 to w ciągu kilku godzin, w zależności od dostawcy domeny. Więcej informacji: w dokumentacji dostawcy domeny znajdziesz szczegółowe instrukcje dodawania Rekordy TXT i czas propagacji.

    Jeśli kliknięcie Verify (Zweryfikuj) wyświetli się komunikat o błędzie, oznacza to, że rekordy nie zostały lub wartości mogą być nieprawidłowe.

W kreatorze Add Custom Domains (Dodaj domenę niestandardową) w konsoli Firebase wybierz Quick (Szybkie) Konfiguracja lub Konfiguracja zaawansowana.

Szybka konfiguracja może być używana w przypadku nowych domen, które nie generują obecnie ruchu, lub domen, które próbujesz przenieść z innej witryny Hosting. Konfiguracji zaawansowanej możesz użyć, jeśli masz już domenę odbierającą do innego dostawcy usług hostingowych i nie wymagają migracji bez przestojów.

Kreator konfiguracji zaawansowanej pomoże Ci utworzyć certyfikat SSL i roszczenie dotyczące własności, dzięki któremu Hosting będzie obsługiwać ruch w domenie, zanim który odbiera ruch.

Poczekaj na udostępnienie certyfikatu SSL

Po zweryfikowaniu własności domeny udostępniamy certyfikat SSL dla Twojej i wdrożyć ją w naszej globalnej sieci CDN w ciągu 24 godzin Rekordy A DNS dla domeny Firebase Hosting.

Twoja domena będzie wymieniona jako jedna z alternatywnych nazw podmiotu (SAN) w certyfikacie SSL FirebaseApp. Certyfikat możesz wyświetlić za pomocą narzędzi bezpieczeństwa przeglądarki. Podczas obsługi administracyjnej domeny możesz zobaczyć nieprawidłowe dane certyfikat, który nie zawiera nazwy Twojej domeny. To normalna część zostanie rozwiązany po udostępnieniu certyfikatu domeny.

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

Niestandardowy klucz domeny

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują, aby wpisać różne dane wejściowe w polu Host w ustawieniach zarządzania DNS witryn. Zebraliśmy poniżej popularne 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:

  • @
  • Nazwa domeny najwyższego poziomu (na przykład example.com)
  • Pozostaw pole Host puste.
Subdomena

Typowe dane wejściowe to:

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

Popularni dostawcy domen

Oto kilku popularnych dostawców domen i rodzaje danych wejściowych, które mogą być wymagane. Staramy się, aby informacje były jak najbardziej aktualne, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Opis stanu 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 nazw domeny do serwerów Firebase Hosting.
    Wskazówka dotycząca rozwiązywania problemów: jeśli upłynęły ponad 24 godziny, sprawdź, czy według Ciebie to Firebase Hosting.

  • W rzadkich przypadkach, zwłaszcza gdy używasz konfiguracji zaawansowanej, testy zabezpieczające, testy SSL mogą powodować błędy, ponieważ:

    • Nie udało się zweryfikować certyfikatu SSL, a token (DNS TXT) się nie powiódł rekordów ani przesłanych przesłanego do witryny) jest teraz nieprawidłowy.
      Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl obok domeny, a następnie podaj nowy token w istniejącej domenie.
Oczekujący

Domena niestandardowa została prawidłowo skonfigurowana, ale Firebase Hostingnie ma certyfikatu SSL.

Czasami następujące problemy mogą zakłócić generowanie protokołu SSL certyfikat dla domeny niestandardowej:

  • Rekordy 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 karty Zaawansowane Błąd konfiguracji i migracja, Twój token (i test zabezpieczający) ) są teraz nieprawidłowe.
    Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl obok 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: w przeglądarce Firebase Hosting nie zaleca się ponad 20 subdomen w jednej domenie niestandardowej najwyższego poziomu ze względu na protokół SSL i ograniczeniami pozyskiwania certyfikatów.
Certyfikat generowania

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

Twoja domena niestandardowa ma prawidłowe rekordy DNS i ma protokół SSL certyfikat.
Możesz wyświetlać treści z Twojej witryny.