欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

Połącz niestandardową domenę

Dzięki Hostingowi Firebase 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 generowanej przez Firebase dla swojej witryny hostowanej przez Firebase.

Hosting Firebase udostępnia 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ć swoją domenę niestandardową.

Skonfiguruj swoją domenę dla Hostingu

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

Krok 1 : Dodaj domenę

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

    • Jeśli masz tylko jedną witrynę hostingową, kliknij Połącz domenę .
    • Jeśli masz więcej niż jedną witrynę hostingową , kliknij Wyświetl obok żądanej witryny, a następnie kliknij Połącz domenę .
  2. Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną hostingową.

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

  4. Kliknij Kontynuuj , aby rozpocząć proces weryfikacji.

Krok 2 : Zweryfikuj własność domeny

Jeśli zażądasz tego w kreatorze konfiguracji Connect Domain , zweryfikuj swoją domenę apex.

Dzięki tym krokom 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 potwierdzić własność domeny i upoważnić Firebase do przypisywania i odnawiania certyfikatów SSL dla Twojej witryny.

      Dostawca domeny może umieścić ten termin jako „Typ rekordu”.

    • Host : wprowadź klucz domeny apex .

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

      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 potwierdzić własność domeny.

      Dostawca Twojej domeny może podać ten termin jako „Dane”.

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

    Zwróć uwagę, ż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 pojawi się monit o ponowne wprowadzenie nazwy domeny .

    Po długim czasie propagacji kliknięcie przycisku 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 Zweryfikuj spowoduje wyświetlenie komunikatu o błędzie, oznacza to, że Twoje rekordy nie zostały rozprzestrzenione lub wartości mogą być nieprawidłowe.

Krok 3 : Uruchom na żywo

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

Poczekaj na udostępnienie certyfikatu SSL

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

Twoja domena zostanie wymieniona jako jedna z alternatywnych nazw podmiotu (SAN) w certyfikacie FirebaseApp SSL. Możesz wyświetlić ten certyfikat za pomocą narzędzi bezpieczeństwa przeglądarki. Podczas obsługi administracyjnej domeny możesz zobaczyć nieprawidłowy certyfikat, który nie zawiera nazwy domeny. Jest to normalna część procesu i zostanie rozwiązana po udostępnieniu certyfikatu 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 Hosting Firebase projektu nie zmieni się na Połączono .

Twój niestandardowy klucz domeny

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują od użytkownika wprowadzenia różnych danych wejściowych w polu Host w ich witrynach zarządzania DNS. Poniżej zestawiliś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łka (na example .com )
  • Pozostawienie pustego pola Host
Subdomena

Typowe dane wejściowe obejmują:

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

Dostawcy wspólnych domen

Oto kilku typowych dostawców domen i typy danych wejściowych, które mogą być wymagane. Informacje te są w miarę możliwości aktualizowane, ale szczegółowe instrukcje można znaleźć w dokumentacji dostawcy domeny.

Opisy stanu konfiguracji dla domen niestandardowych

Status Opis
Wymaga konfiguracji

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

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

  • W rzadszych przypadkach, zwłaszcza jeśli używasz przepływu konfiguracji zaawansowanej, wyzwania SSL mogą kończyć się niepowodzeniem, ponieważ:

    • Twoje rekordy DNS zawierają rekordy A lub CNAME, które wskazują na innych dostawców hostingu.
      Wskazówka dotycząca rozwiązywania problemów: sprawdź, czy rekordy A wskazują tylko 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 Wyświetl dla domeny, a następnie podaj nowy token w istniejącej domenie.
W oczekiwaniu

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

Czasami następujące problemy mogą spowodować wstrzymanie wydobycia certyfikatu SSL dla domeny niestandardowej:

  • Twoje 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.
  • Twój kod wyzwania jest nieprawidłowy.
    Jeśli używasz przepływu konfiguracji zaawansowanej, a 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 Wyświetl dla domeny, a następnie podaj nowy token w istniejącej domenie.
  • Poprosiłeś o certyfikaty 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 limity wydawania certyfikatów SSL.
Połączony

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

Wymaga ponownej weryfikacji

Firebase może wymagać ręcznego ponownego zweryfikowania własności domeny, jeśli wystąpi którakolwiek z następujących sytuacji:

  • Rekord TXT dodany podczas wstępnej weryfikacji własności domeny został zmieniony lub usunięty z ustawień DNS domeny.
    • Pamiętaj, że wiele rekordów TXT z tokenem weryfikacji witryny Google jest dozwolonych w jednej domenie.
    • Wymagamy, aby rekord TXT był stale obecny w 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.
  • Osoba, która zweryfikowała własność domeny, nie ma już przypisanej roli uprawnień, która zawiera wymagane uprawnienia do weryfikowania własności domeny. Te role obejmują właściciela, edytującego, administratora Firebase i administratora programistycznego Firebase.
Wskazówka dotycząca rozwiązywania problemów: odwiedź stronę Hostingu swojego projektu, aby zakończyć proces ponownej weryfikacji w określonym przedziale czasu (zwykle 30 dni), aby uniknąć automatycznego odłączania domeny niestandardowej od Hostingu Firebase.