Połącz domenę niestandardową

Nie musisz rezygnować z wyjątkowych nazw domen związanych z marką w przypadku aplikacji wdrożonych na Firebase App Hosting. W przypadku witryny hostowanej w Firebase możesz użyć domeny niestandardowej (np. example.com lub app.example.com) zamiast domeny wygenerowanej przez Firebase. Firebase App Hosting udostępnia certyfikat SSL dla każdej z Twoich domen.

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

Konfigurowanie domeny na potrzeby App Hosting

Upewnij się, że wykonałeś/wykonałaś podstawowe czynności konfiguracyjne App Hosting, aby w projekcie Firebase był dostępny element Firebase App Hosting.

Krok 1. Dodaj domenę niestandardową

  1. Otwórz App Hostingstronę projektu.
  2. Wybierz App Hosting backend za pomocą opcji Wyświetl panel.
  3. Kliknij kolejno kartę Ustawienia i Dodaj domenę niestandardową.
  4. Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną App Hosting.
  5. (Opcjonalnie) Zaznacz pole, aby przekierować wszystkie żądania w domenie niestandardowej do drugiej określonej domeny (tak, aby adresy example.com i www.example.com przekierowywały do tej samej treści).
  6. Kliknij Dalej, aby skonfigurować rekordy DNS i zakończyć konfigurowanie domeny niestandardowej.

Krok 2. Skonfiguruj domenę niestandardową

  1. Kreator Dodaj domenę niestandardową w konsoli Firebase wyświetli niezbędne rekordy, które należy zaktualizować, aby wskazać stronę do usługi Hostingu aplikacji Firebase. Dodawaj, usuwaj i zapisuj rekordy swojej domeny u dostawcy DNS za pomocą tych danych wejściowych:

    • Typ: dodaj podany rekord DNS.

    • Host: wpisz niestandardowy klucz domeny dla rekordów. Host, który wskazujesz, to domena, w której chcesz wyświetlać treści. Może to być domena najwyższego poziomu lub subdomena. Twój dostawca domeny może podać ten termin jako „Nazwa hosta”, „Nazwa” lub „Domena”.

    • Wartość: przypisz podawaną wartość do swoich rekordów. Twój dostawca domen może podać ten termin jako „Dane”, „Punkty docelowe”, „Treść”, „Adres” lub „Adres IP”. Zawartość pola wartości zależy od typu rekordu. Rekordy A i AAAA mają wartości w postaci adresów IP, a rekordy TXT zawierają ciągi znaków.

Poczekaj, aż certyfikat SSL zostanie udostępniony. Zwykle zajmuje to kilka godzin, ale czasami może potrwać do 24 godzin od momentu ustawienia DNS na Firebase App Hosting. W większości przypadków propagacja Twoich rekordów i udostępnianie certyfikatu SSL nastąpi w ciągu godziny, w zależności od dostawcy domeny.

Czekaj na udostępnienie certyfikatu SSL

App Hosting może potrwać do kilku godzin. W niektórych przypadkach może to potrwać do 24 godzin od momentu ustawienia DNS na wartość Firebase App Hosting.

Możesz wyświetlić ten certyfikat za pomocą narzędzi bezpieczeństwa przeglądarki. Podczas udostępniania domeny możesz zobaczyć nieprawidłowy certyfikat lub mieć problemy z połączeniem z domeną. To normalna część procesu, która zostanie rozwiązana, gdy certyfikat Twojej domeny będzie dostępny.

Uwaga: Firebase App Hosting automatycznie ponownie udostępnia certyfikaty SSL w przypadku domen niestandardowych.

Typy rekordów DNS

W kreatorze App Hosting Domena niestandardowa możesz zostać poproszony o dodanie od 1 do 5 rekordów DNS, w zależności od bieżącej konfiguracji domeny. Typ rekordu określa jego funkcję. Oto typy rekordów, o które może poprosić usługa App Hosting:

Typ Opis Wyjątkowe
A Te rekordy zawierają wartości IPv4 (np. 8.8.8.8), które informują przeglądarki, którego adresu używać podczas próby nawiązania połączenia z Twoją domeną. Tak
AAAA Te rekordy zawierają wartości IPv6 (np. 2001:4860:4860::8888), czyli inny typ rekordu adresu, który pełni mniej więcej tę samą funkcję co rekordy A. App Hosting nie używa obecnie rekordów AAAA, ale poprosi Cię o usunięcie z naszej domeny wszystkich istniejących rekordów AAAA, jeśli takie istnieją. Tak
CNAME Te rekordy zawierają osobną nazwę domeny, której należy używać zamiast bieżącej domeny do rozwiązywania zapytań DNS. Rekordy CNAME są dozwolone tylko w subdomenach (np. www.example.com). App Hosting używa rekordów CNAME z 2 powodów:
  • Łatwe wdrożenie: jeśli to możliwe, App Hosting poprosi Cię o ustawienie rekordu CNAME dla wstępnie skonfigurowanej domeny, która zaczyna się od _custom-domain....
  • Weryfikacja certyfikatu SSL: App Hosting używa menedżera certyfikatów w chmurze do tworzenia certyfikatów SSL dla Twojej domeny niestandardowej. Rekord CNAME w subdomenie _acme-challenge... umożliwia menedżerowi certyfikatów tworzenie i odnawianie certyfikatów. Po wprowadzeniu tego rekordu nie można go usunąć, ponieważ spowoduje to utratę ochrony certyfikatu.
 Tak
TXT Te rekordy umożliwiają dołączanie dowolnych metadanych do domeny. App Hosting umożliwia użycie określonego formatu rekordu TXT, fah-claim=[UUID], aby wskazać, w której domenie niestandardowej ma on być używany. Nie
CAA Te rekordy działają jak lista dozwolonych urzędów certyfikacji, które mogą wydawać certyfikaty SSL dla Twojej domeny. App Hosting wysyła żądanie rekordów CAA tylko wtedy, gdy nie może utworzyć certyfikatów dla Twojej domeny. Nie

Klucz domeny niestandardowej

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują, że w polu Host na swoich stronach zarządzania DNS podasz różne dane wejściowe. Poniżej przedstawiamy najczęściej używane dane od popularnych dostawców. Szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domen.

Typ domeny Klucz domeny niestandardowej
Domena najwyższego poziomu

Typowe dane wejściowe:

  • @
  • nazwa domeny najwyższego poziomu (na przykład example.com);
  • pozostawienie pola Host (Host) pustego;
Subdomena

Typowe dane wejściowe:

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

Popularni dostawcy domen

Oto lista niektórych typowych dostawców domen i typów danych, których mogą wymagać. Staramy się, aby informacje były jak najbardziej aktualne, ale szczegółowe instrukcje znajdziesz w dokumentacji swojego dostawcy domen.

Opisy stanów dla 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 App Hosting.
    Wskazówka dotycząca rozwiązywania problemów: jeśli minęło ponad 24 godziny, sprawdź, czy rekordy są kierowane do Firebase App Hosting.

  • W rzadkich przypadkach problemy z wyzwaniami SSL mogą być spowodowane tym, że rekordy DNS zawierają rekordy A lub CNAME, które wskazują na innych dostawców usług hostingowych.
    Wskazówka dotycząca rozwiązywania problemów: sprawdź, czy rekordy A wskazują tylko na Firebase App Hosting, i usuń wszystkie rekordy CNAME.
Oczekuje

Domena niestandardowa została prawidłowo skonfigurowana, ale Firebase App Hosting nie ma certyfikatu SSL.

Czasami zbyt restrykcyjne rekordy CAA mogą zablokować tworzenie certyfikatu SSL dla domeny niestandardowej. Upewnij się, że urzędy certyfikacji `letsencrypt.org` i `pki.goog` mają uprawnienia do tworzenia certyfikatów SSL dla Twojej domeny.
Certyfikat bicia monet

Tworzony jest certyfikat SSL dla Twojej domeny.
Połączono

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