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ą
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ą .
Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną hostingową.
(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).
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.
W witrynie dostawcy domeny znajdź stronę zarządzania DNS.
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”.
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”.
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.
Szybki montaż
Kreator dodawania domeny niestandardowej w konsoli Firebase wyświetli niezbędne rekordy, które należy zaktualizować, aby wskazywały Twoją stronę na Hosting Firebase. Dodawaj, usuwaj i zapisuj rekordy swojej domeny u swojego dostawcy DNS, wprowadzając następujące dane:
Wskazany przez Ciebie host to domena, na której chcesz udostępniać treści; ta domena może być domeną wierzchołkową lub subdomeną.
Twój dostawca domeny może podać ten termin jako „Nazwa hosta”, „Nazwa” lub „Domena”.
Wartość : przypisz podane adresy IP do wartości rekordów.
Twój dostawca domeny może wymienić ten termin jako „Dane”, „Wskazuje na”, „Treść”, „Adres” lub „Adres IP”.
Zaczekaj na udostępnienie certyfikatu SSL . Może to zająć do 24 godzin po skierowaniu DNS na Hosting Firebase. W większości przypadków propagacja Twoich rekordów i udostępnienie certyfikatu SSL nastąpi w ciągu kilku godzin, w zależności od dostawcy domeny.
Ustawienia zaawansowane
Zaawansowany tryb konfiguracji kreatora Dodaj domenę niestandardową pozwala skonfigurować Hosting tak, aby bezpiecznie obsługiwał Twoją domenę przed skierowaniem ruchu na jej serwery. Ogólnie rzecz biorąc, Hosting potrzebuje trzech rzeczy, aby skutecznie obsługiwać ruch w domenie:
Rekord własności: rekord TXT informuje Hosting, która witryna ma być obsługiwana w domenie
Certyfikat SSL: certyfikat specyficzny dla domeny, który umożliwia szyfrowaną komunikację pomiędzy serwerami Hostingowymi a użytkownikami końcowymi
Rekordy IP hostingu: jeden lub więcej rekordów A i AAAA, które kierują wszystkie żądania dotyczące domeny do serwerów hostingowych
Konfiguracja zaawansowana poprowadzi Cię przez proces konfiguracji domeny, tak aby Hosting mógł z wyprzedzeniem spełnić dwa pierwsze wymagania, tak aby był gotowy do obsługi właściwej treści, zanim zacznie odbierać ruch z Twojej domeny. Ten kreator przedstawia ten proces jako dwuetapowy przepływ pracy:
Przygotuj domenę
Zaktualizuj rekord(y) DNS : Dodaj jeden lub więcej rekordów do swojej domeny:
Własność: rekord TXT w postaci „hosting-site=[site_id]”.
CAA (opcjonalnie): Para rekordów CAA, które umożliwiają urzędom certyfikacji Hostingu wytworzenie certyfikatu SSL dla Twojej domeny. Występuje tylko wtedy, gdy Hosting odkryje istniejące rekordy CAA, które uniemożliwiają mu udostępnienie certyfikatu.
Skonfiguruj certyfikat SSL : Kreator dostarcza wezwanie ACME , którego użyją urzędy certyfikacji Hostingu do wytworzenia certyfikatu SSL dla Twojej domeny. Możesz wybrać pomiędzy wyzwaniem DNS lub HTTP:
Wyzwanie DNS : odwiedź witryny zarządzania DNS swojego dostawcy domeny. Dodaj rekord TXT z kluczem subdomeny wyzwania ACME i podaną wartością. Rozpropagowanie rekordów TXT może zająć do 24 godzin.
Wyzwanie HTTP : prześlij dostarczony plik tekstowy do istniejącej witryny pod określonym adresem URL i sprawdź jego istnienie.
Hosting podejmie próbę samodzielnego sprawdzenia wyzwań ACME przed zażądaniem weryfikacji od swojego urzędu certyfikacji. Jeśli urząd certyfikacji z jakiegokolwiek powodu nie zatwierdzi Twoich wyzwań, na przykład z powodu sporadycznych problemów z usługą. Hosting będzie musiał generować dla Ciebie nowy zestaw wyzwań. Po pomyślnej weryfikacji udostępnienie certyfikatu SSL i umożliwienie jego propagacji może zająć Hostingowi do kilku godzin.
Bezpośrednio do Hostingu
Gdy Hosting ustali własność Twojej domeny i zapewni certyfikat SSL, wróć do swojego dostawcy DNS i dodaj rekordy DNS A/AAAA kierujące żądania do Hostingu:
Typ : Dodaj żądane rekordy DNS A/AAAA.
Host : wprowadź niestandardowy klucz domeny dla obu rekordów.
Wskazany przez Ciebie host to domena, na której chcesz udostępniać treści; ta domena może być domeną wierzchołkową lub subdomeną. Twój dostawca domeny może podać ten termin jako „Nazwa hosta”, „Nazwa” lub „Domena”.
Wartość : przypisz jedną wartość do każdego rekordu DNS A/AAAA, aby wskazać Twojej domenie określone adresy IP.
Twój dostawca domeny może wymienić ten termin jako „Dane”, „Wskazuje na”, „Treść”, „Adres” lub „Adres IP”.
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.
Cloudflare
Typ
Gospodarz
Wartość
Wejścia rekordów DNS TXT
tekst
example .com
wartość weryfikacyjna podana w konsoli Firebase
DNS A rejestruje dane wejściowe
A
example .com
199.36.158.100
A
www
199.36.158.100
Domeny Google
Typ
Gospodarz
Wartość
Wejścia rekordów DNS TXT
tekst
@
wartość weryfikacyjna podana w konsoli Firebase
DNS A rejestruje dane wejściowe
A
@
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Typ
Gospodarz
Wartość
Wejścia rekordów DNS TXT
tekst
example .com
wartość weryfikacyjna podana w konsoli Firebase
DNS A rejestruje dane wejściowe
A
example .com
199.36.158.100
A
www
199.36.158.100
NazwaTanie
Typ
Gospodarz
Wartość
Wejścia rekordów DNS TXT
tekst
@
wartość weryfikacyjna podana w konsoli Firebase
DNS A rejestruje dane wejściowe
A
@
199.36.158.100
A
@
199.36.158.100
Przestrzeń kwadratowa
Typ
Gospodarz
Wartość
Wejścia rekordów DNS TXT
tekst
@
wartość weryfikacyjna podana w konsoli Firebase
DNS A rejestruje dane wejściowe
A
@
199.36.158.100
A
www
199.36.158.100
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.