Dzięki Hostingowi Firebase nie musisz rezygnować z unikalnych, skoncentrowanych na marce nazw domen. Zamiast domeny wygenerowanej przez Firebase dla swojej witryny hostowanej w Firebase możesz użyć domeny niestandardowej (np. example.com lub app.example.com).
Hosting Firebase zapewnia certyfikat SSL dla każdej z Twoich domen i udostępnia treści w globalnej sieci CDN.
Z dalszej części tego dokumentu dowiesz się, jak połączyć domenę niestandardową.
Konfigurowanie domeny na potrzeby Hostingu
Aby utworzyć witrynę Hostingu Firebase w projekcie Firebase, musisz ukończyć kreatora „Pierwsze kroki” na stronie Hostingu Firebase swojego projektu.
Krok 1. Dodaj domenę niestandardową
Na stronie Hostingu projektu otwórz kreatora łączenia z domeną niestandardową:
Jeśli masz tylko jedną witrynę w Hostingu, kliknij Dodaj domenę niestandardową.
Jeśli masz więcej niż 1 witrynę w Hostingu, kliknij Wyświetl obok odpowiedniej witryny, a potem kliknij Dodaj domenę niestandardową.
Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną w Hostingu.
(Opcjonalnie) Zaznacz pole, aby przekierowywać wszystkie żądania z domeny niestandardowej do drugiej określonej domeny (na przykład example.com i www.example.com przekierowują do tej samej treści).
Kliknij Dalej, aby skonfigurować rekordy DNS i zakończyć konfigurowanie domeny niestandardowej.
Krok 2. Skonfiguruj domenę niestandardową
Jeśli pojawi się prośba w kreatorze konfiguracji Connect Domains, zweryfikuj domenę apex.
Dzięki temu upewnisz się, ż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 tymi danymi wejściowymi:
Typ: dodaj rekord TXT.
Hosting Firebase wymaga, aby rekord TXT był stale dostępny w ustawieniach DNS, aby potwierdzić własność domeny oraz autoryzować Firebase do przypisywania i odnawiania certyfikatów SSL Twojej witryny.
Dostawca domeny może wymienić ten termin jako „Record Type” (Typ rekordu).
Udowodnienie własności domeny najwyższego poziomu (głównej) potwierdza, że wszystkie jej subdomeny należą do Ciebie.
Dostawca domeny może określić ten termin jako „Host Name” (Nazwa hosta), „Name” (Nazwa) lub „Domain” (Domena).
Wartość: skopiuj unikalną wartość weryfikacji do pola.
Hosting Firebase sprawdza tę wartość, aby potwierdzić własność domeny.
Dostawca domeny może oznaczyć ten termin jako „Dane”.
Zaczekaj do 24 godzin na rozpowszechnienie zaktualizowanych rekordów TXT, a następnie kliknij Zweryfikuj.
Możesz kliknąć Anuluj, aby bezpiecznie zamknąć okno Połącz domenę i otworzyć je ponownie w późniejszym czasie. Nie ma to wpływu na czas propagacji, ale po ponownym otwarciu okna poprosimy Cię o ponowne wpisanie nazwy domeny.
Po upłynięciu czasu rozpowszechnienia kliknięcia Zweryfikuj w oknie Połącz domenę w konsoli Firebase umożliwi Ci rozpoczęcie procesu udostępniania certyfikatu SSL.
W większości przypadków rozpowszechnienie rekordów i weryfikacja domeny mogą potrwać kilka godzin, w zależności od dostawcy domeny. Szczegółowe instrukcje dodawania rekordów TXT i czasu rozpowszechniania znajdziesz w dokumentacji dostawcy domeny.
Jeśli po kliknięciu Zweryfikuj pojawi się komunikat o błędzie, rekordy nie zostały rozpowszechnione lub Twoje wartości mogą być nieprawidłowe.
W kreatorze dodawania domeny niestandardowej w konsoli Firebase wybierz Szybka konfiguracja lub Konfiguracja zaawansowana.
Możesz użyć szybkiej konfiguracji w przypadku nowych domen, które nie otrzymują obecnie ruchu lub domen, które próbujesz przenieść z innej witryny Hostingu. Możesz skorzystać z konfiguracji zaawansowanej, jeśli masz już domenę odbierającą żądania od innego dostawcy usług hostingowych i potrzebujesz migracji, która nie spowoduje żadnych przestojów.
Kreator konfiguracji zaawansowanej pomoże Ci utworzyć certyfikat SSL i roszczenie własności, dzięki którym Hosting będzie mógł obsługiwać ruch w domenie przed jego zyskaniem.
Szybka konfiguracja
Kreator dodawania domeny niestandardowej w konsoli Firebase wyświetli rekordy, które należy zaktualizować, aby wskazywały Hosting Firebase. Dodaj, usuń i zapisz rekordy swojej domeny u dostawcy DNS z tymi danymi wejściowymi:
Wskazany host to domena, w której chcesz wyświetlać treści. Może to być domena najwyższego poziomu lub subdomena.
Dostawca domeny może używać tego terminu jako „Host Name” (Nazwa hosta), „Name” (Nazwa) lub „Domain” (Domena).
Wartość: przypisz podane adresy IP do wartości rekordów.
Dostawca domeny może oznaczyć ten termin jako „Dane”, „Wskazuje na”, „Treść”, „Adres” lub „Adres IP”.
Poczekaj na udostępnienie certyfikatu SSL.
Może to potrwać do 24 godzin od skierowania DNS do Hostingu Firebase.
W większości przypadków rozpowszechnienie rekordów i udostępnienie certyfikatu SSL trwa kilka godzin, w zależności od dostawcy domeny.
Konfiguracja zaawansowana
Tryb konfiguracji zaawansowany kreatora dodawania domeny niestandardowej pozwala skonfigurować Hosting tak, aby bezpiecznie obsługiwał Twoją domenę, zanim przekierujesz ruch na jej serwery. Ogólnie do skutecznego obsługi ruchu w domenie Hosting potrzebuje 3 elementów:
Rekord własności: rekord TXT informuje Hosting, która witryna ma być udostępniana w domenie.
Certyfikat SSL: certyfikat specyficzny dla domeny, który umożliwia szyfrowaną komunikację między serwerami Hostingu a użytkownikami
Rekordy IP w Hostingu: co najmniej jeden rekord A i AAAA, który kieruje wszystkie żądania dotyczące domeny do serwerów Hostingu.
Konfiguracja zaawansowana przeprowadzi Cię przez proces konfigurowania domeny w taki sposób, aby usługa Hosting spełniła 2 pierwsze wymagania z wyprzedzeniem, co pozwoli Ci przygotować odpowiednie treści do obsługi ruchu związanego z Twoją domeną.
Ten kreator przedstawia ten proces jako dwuetapowy przepływ pracy:
Przygotowanie domeny
Aktualizowanie rekordów DNS: dodaj co najmniej 1 rekord do swojej domeny:
Własność: rekord TXT w formacie `hosting-site=[identyfikator_witryny]`.
CAA (opcjonalnie): para rekordów CAA, które umożliwiają urzędom certyfikacji Hostingu wygenerowanie certyfikatu SSL Twojej domeny. Widoczny tylko wtedy, gdy Hosting wykryje istniejące rekordy CAA, które uniemożliwiają mu udostępnienie certyfikatu.
Skonfiguruj certyfikat SSL: kreator dostarcza test ACME, którego urzędy certyfikacji Hostingu będą używać do wygenerowania certyfikatu SSL dla Twojej domeny. Możesz wybrać test DNS lub HTTP:
Test DNS: wejdź na stronę zarządzania DNS Twojego dostawcy domeny. Dodaj rekord TXT z kluczem subdomeny wyzwania ACME i podaną wartością. Odczekaj do 24 godzin na rozpowszechnienie rekordów TXT.
Wyzwanie HTTP: prześlij podany plik tekstowy do istniejącej witryny pod określonym adresem URL i sprawdź, czy istnieje.
Hosting spróbuje zweryfikować sam test ACME przed zażądaniem weryfikacji do urzędu certyfikacji. Jeśli z jakiegokolwiek powodu urząd certyfikacji nie zweryfikowanie wyzwań, na przykład nieregularnych problemów z usługą. Hosting będzie musiał wygenerować dla Ciebie nowy zestaw wyzwań. Po pomyślnej weryfikacji może minąć nawet kilka godzin, zanim Hosting udostępni certyfikat SSL i pozwoli go rozpowszechnić.
Bezpośrednie do Hostingu
Gdy Hosting ustali własność domeny i udostępni certyfikat SSL, wróć do dostawcy DNS i dodaj rekordy DNS A/AAAA kierujące żądania do Hostingu:
Typ: dodaj żądane rekordy DNS A/AAAA.
Host: wpisz niestandardowy klucz domeny dla obu rekordów.
Wskazany host to domena, w której chcesz wyświetlać treści. Może to być domena najwyższego poziomu lub subdomena. Dostawca domeny może wymienić ten termin jako „Nazwa hosta”, „Nazwa” lub „Domena”.
Wartość: przypisz po jednej wartości do każdego rekordu DNS A/AAAA, aby kierować domenę na określone adresy IP.
Dostawca domeny może oznaczyć ten termin jako „Dane”, „Wskazuje na”, „Treść”, „Adres” lub „Adres IP”.
Poczekaj na udostępnienie certyfikatu SSL
Gdy zweryfikujemy własność domeny, udostępnimy dla niej certyfikat SSL i wdrożymy go w naszej globalnej sieci CDN w ciągu 24 godzin od skierowania rekordów DNS A do Hostingu Firebase.
Twoja domena będzie wymieniona jako jedna z alternatywnych nazw podmiotu w certyfikacie SSL aplikacji Firebase. Możesz wyświetlić ten certyfikat za pomocą
narzędzi zabezpieczeń przeglądarki. Podczas udostępniania domeny możesz zobaczyć nieprawidłowy certyfikat niezawierający nazwy Twojej domeny. Jest to normalna część procesu i zniknie, gdy certyfikat Twojej domeny będzie dostępny.
W przypadku użytkowników konfiguracji zaawansowanej witryna będzie hostowana przez poprzedniego dostawcę usług hostingowych, dopóki stan konfiguracji na stronie Hostingu Firebase nie zmieni się na Połączono.
Twój niestandardowy klucz domeny
Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują od siebie różnych danych wejściowych w polu Host w swoich witrynach zarządzania DNS. Poniżej zebraliśmy typowe dane od popularnych dostawców.
Szczegółowe instrukcje znajdziesz w dokumentacji Twojego dostawcy domeny.
Typ domeny
Niestandardowy klucz domeny
Domena Apex
Typowe dane wejściowe:
@
Nazwa domeny najwyższego poziomu (na przykład example.com)
pozostawienie pola Host pustego,
Subdomena
Typowe dane wejściowe:
Pełna nazwa subdomeny (na przykład app.example.com).
Tylko część związana z subdomeną (np. tylko app z pominięciem .example.com)
Tylko www w subdomenie www.example.com
Popularni dostawcy domen
Oto kilku popularnych dostawców domen i rodzaje danych wejściowych, których każdy z nich może wymagać.
Te informacje są w miarę możliwości aktualne, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.
Cloudflare
Typ
Osoba prowadząca
Wartość
Dane wejściowe rekordu DNS typu TXT
TXT
example.com
wartość weryfikacyjna podana w konsoli Firebase
Dane wejściowe rekordów A DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Typ
Osoba prowadząca
Wartość
Dane wejściowe rekordu DNS typu TXT
TXT
example.com
wartość weryfikacyjna podana w konsoli Firebase
Dane wejściowe rekordów A DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
NameTanie
Typ
Osoba prowadząca
Wartość
Dane wejściowe rekordu DNS typu TXT
TXT
:
wartość weryfikacyjna podana w konsoli Firebase
Dane wejściowe rekordów A DNS
A
:
199.36.158.100
A
www
199.36.158.100
Squarespace
Typ
Osoba prowadząca
Wartość
Dane wejściowe rekordu DNS typu TXT
TXT
:
wartość weryfikacyjna podana w konsoli Firebase
Dane wejściowe rekordów A DNS
A
:
199.36.158.100
A
www
199.36.158.100
Opisy 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 przez dostawcę nazwy domeny na serwery Hostingu Firebase. Wskazówka dotycząca rozwiązywania problemów: jeśli upłynęło więcej niż 24 godziny, sprawdź, czy rekordy są ustawione na Hosting Firebase.
W rzadkich przypadkach, zwłaszcza jeśli korzystasz z procesu konfiguracji zaawansowanej, testy zabezpieczające logowanie z użyciem protokołu SSL mogą zakończyć się niepowodzeniem, ponieważ:
Testy certyfikatu SSL nie powiodły się, a token (rekordy DNS TXT lub przesłany plik udostępniony do Twojej witryny) jest teraz nieprawidłowy. Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl obok domeny i podaj nowy token dla istniejącej domeny.
Oczekuje
Domena niestandardowa jest skonfigurowana prawidłowo, ale Hosting Firebase nie udostępnił certyfikatu SSL.
Czasami mogą wystąpić te problemy, które mogą wstrzymać generowanie certyfikatu SSL dla domeny niestandardowej:
Rekordy CAA są zbyt restrykcyjne. Wskazówka dotycząca rozwiązywania problemów: sprawdź, czy 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 procesu konfiguracji zaawansowanej, a migracja nie powiodła się, Twój token (i jego kod wyzwania) są teraz nieprawidłowe. Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl obok domeny i podaj nowy token dla istniejącej domeny.
Zażądano certyfikatów dla zbyt wielu subdomen. Wskazówka dotycząca rozwiązywania problemów: z zasady Hosting Firebase zaleca używanie nie więcej niż 20 subdomen w jednej domenie niestandardowej najwyższego poziomu ze względu na limity generowania certyfikatów SSL.
Certyfikat generowania
Trwa przygotowywanie certyfikatu SSL dla Twojej domeny.
Połączono
Twoja domena niestandardowa ma odpowiednie rekordy DNS i ma certyfikat SSL. Możesz wyświetlać zawartość swojej witryny.