Połącz domenę niestandardową

Nie musisz rezygnować z wyjątkowych, związanych z marką nazw domen 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ą.

Skonfiguruj domenę dla usługi 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 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. Wskazany host to domena, w której chcesz udostępniać 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 kierowania DNS na Firebase App Hosting. W większości przypadków rozpowszechnienie rekordów i udostępnienie 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 zająć do 24 godzin od momentu wskazania adresu DNS na 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 uruchamia certyfikaty SSL w razie potrzeby 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 Zawierają one wartości IPv6 (np. 2001:4860:4860::8888), inny typ rekordu adresowego, który ma mniej więcej taką samą funkcję jak 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 dokumentu nie można go usunąć, ponieważ spowoduje to utratę ochrony certyfikatu.
 Tak
TXT Dzięki tym rekordom możesz dołączać dowolne metadane do swojej 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ć wyświetlany. Nie
CAA Rekordy te działają jak lista dozwolonych służąca do określania urzędów certyfikacji, które są upoważnione do generowania certyfikatów SSL dla Twojej domeny. App Hosting żąda rekordów CAA tylko wtedy, gdy nie ma możliwości generowania certyfikatów dla Twojej domeny. Nie

Niestandardowy klucz domeny

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. Zebraliśmy poniżej popularne dane wejściowe od popularnych dostawców. Szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domen.

Typ domeny Klucz domeny niestandardowej
Domena Apex

Typowe dane wejściowe to:

  • @
  • 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ć. Te informacje są w miarę możliwości aktualizowane, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Opisy stanów 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 zostały zmapowane na Firebase App Hosting.

  • W rzadkich przypadkach testy SSL mogą nie działać, ponieważ rekordy DNS zawierają rekordy A lub CNAME wskazujące 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.
Oczekujący

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ć zawartość swojej witryny.