Połącz domenę niestandardową

W przypadku aplikacji wdrożonych w Firebase App Hosting nie musisz rezygnować z unikalnych nazw domen, które są związane z Twoją marką. Zamiast domeny wygenerowanej przez Firebase możesz użyć domeny niestandardowej (np. example.com lub app.example.com) dla witryny hostowanej w Firebase. Firebase App Hosting udostępnia certyfikat SSL dla każdej z Twoich domen.

W pozostałej części tego dokumentu znajdziesz instrukcje łączenia domeny niestandardowej na jeden z tych sposobów:

Aby zapewnić nieprzerwany dostęp do usługi, musisz zaktualizować rekordy DNS w określonej kolejności. Aby zapobiec przestojom w aplikacji, postępuj zgodnie z instrukcjami przenoszenia domeny.

Jeśli nie musisz się martwić przestojami, np. gdy łączysz domenę, która jest nowa w Twojej aplikacji internetowej, postępuj zgodnie z instrukcjami łączenia nowej domeny.

Zanim zaczniesz: typy rekordów DNS

W zależności od bieżącej konfiguracji domeny kreator App Hosting Konfigurowanie domeny w Hostingu aplikacji może poprosić Cię o dodanie lub usunięcie od 1 do 5 rekordów DNS. Funkcję rekordu określa jego typ. Oto typy rekordów, o które App Hosting może poprosić Cię:

Typ Opis Wyłączny
A Te rekordy zawierają wartości IPv4 (np. 8.8.8.8), które informują przeglądarki, jakiego adresu użyć podczas próby skontaktowania się z Twoją domeną. Tak
AAAA Te rekordy zawierają wartości IPv6 (np. 2001:4860:4860::8888), czyli inny typ rekordu adresu o mniej więcej tej samej funkcji co rekordy A. App Hosting nie używa obecnie rekordów AAAA, ale poprosi Cię o usunięcie wszystkich istniejących rekordów z naszej domeny, jeśli takie są. Tak
CNAME Te rekordy zawierają oddzielną nazwę domeny, która powinna być używana 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 wdrażanie: jeśli to możliwe, App Hosting poprosi Cię o utworzenie 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 udostępniania 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 wdrożeniu tego rekordu nie wolno usuwać, ponieważ w przeciwnym razie certyfikat przestanie działać.
 Tak
TXT Te rekordy umożliwiają dołączanie dowolnych metadanych do domeny. App Hosting umożliwia używanie rekordu TXT w określonym formacie, fah-claim=[UUID], aby wskazać, która własna domena ma udostępniać Twoją domenę. Nie
CAA Te rekordy działają jak lista dozwolonych, która określa urzędy certyfikacji uprawnione do wystawiania certyfikatów SSL dla Twojej domeny. App Hosting prosi o rekordy CAA tylko wtedy, gdy nie może wystawić certyfikatów dla Twojej domeny. Nie

Zanim zaczniesz: nazwa domeny niestandardowej

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen wymagają wpisania różnych danych w polu Host (lub nazwa hosta) w swoich witrynach do zarządzania DNS. Kreator domeny niestandardowej App Hosting wymaga wpisania tej samej wartości w polu Nazwa.

Poniżej zebraliśmy typowe dane wejściowe od popularnych dostawców. Szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Typ domeny Nazwa domeny niestandardowej
Domena główna

Typowe dane wejściowe:

  • @
  • Nazwa domeny głównej (np. example.com)
  • Pozostawienie pustego pola Host
Subdomena

Typowe dane wejściowe:

  • Pełna nazwa subdomeny (np. app.example.com)
  • Tylko część subdomeny (np. app tylko, bez .example.com)

Popularni dostawcy domen

Oto kilku popularnych dostawców domen i typy danych wejściowych, których mogą wymagać. Te informacje są aktualizowane na bieżąco, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Przenoszenie domeny

Jeśli chcesz przenieść domenę od innego dostawcy do App Hosting bez przestojów, możesz użyć procesu Przenieś domenę w Firebase konsoli. Ten proces przeprowadzi Cię przez 2 etapy, które przygotują App Hosting do obsługi treści w Twojej domenie, zanim ruch zostanie przekierowany na serwery App Hosting.

Krok 1. Dodaj domenę niestandardową

  1. W konsoli Firebase otwórz Hosting i usługi bezserwerowe > Hosting aplikacji.
  2. Wybierz App Hosting backend, korzystając z opcji Wyświetl panel.
  3. Kliknij kartę Ustawienia, a potem Dodaj domenę niestandardową.
  4. Wpisz nazwę domeny niestandardowej, którą chcesz połączyć z 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ć , aby skonfigurować rekordy DNS i dokończyć konfigurowanie domeny niestandardowej.

Krok 2. Przygotuj domenę

  1. W kreatorze Konfigurowanie domeny kliknij kartę Przenieś domenę.
  2. Postępuj zgodnie z instrukcjami w pierwszym kroku, Przygotuj domenę, który obejmuje zestaw zmian niezbędnych do tego, aby App Hosting mógł udostępnić Twój preferowany backend i ustanawiać bezpieczne połączenia protokołu TLS dla Twojej domeny. Dodaj, usuń i zapisz rekordy z domeny u dostawcy DNS, używając tych danych wejściowych dla wymaganych rekordów:
    • Nazwa: w przypadku rekordów wpisz nazwę domeny niestandardowej. Wskazany host to domena, w której chcesz udostępniać treści. Może to być domena główna lub subdomena. Dostawca domeny może używać takich określeń jak „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Typ rekordu: dodaj podany rekord DNS.
    • Wartość: przypisz podaną wartość do swoich rekordów. Dostawca domeny może używać takich określeń jak „Dane”, „Wskazuje”, „Treść”, „Adres” lub „Adres IP”. Zawartość pola wartości różni się w zależności od typu rekordu. Na przykład rekordy TXT to ciągi znaków.
  3. Kliknij Zweryfikuj rekordy. App Hosting spróbuje wykryć zmiany wprowadzone u dostawcy domeny. Rozpowszechnienie tych zmian może potrwać do 24 godzin. Stan możesz sprawdzić w panelu backendu w sekcji Ustawienia > Domeny.

Krok 3. Przekieruj do App Hosting

  1. Gdy App Hosting zweryfikuje aktualizacje rekordów z poprzedniego kroku, kreator przejdzie do ostatniego kroku Przekieruj do App Hosting. W tym kroku wyświetlane są aktualizacje rekordów, które musisz wprowadzić, aby przekierować ruch w domenie na App Hosting serwery. Podobnie jak wcześniej dodaj, usuń i zapisz rekordy z domeny u dostawcy DNS, używając tych danych wejściowych dla wymaganych rekordów:
    • Nazwa: w przypadku rekordów wpisz nazwę domeny niestandardowej. Wskazany host to domena, w której chcesz udostępniać treści. Może to być domena główna lub subdomena. Dostawca domeny może używać takich określeń jak „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Typ rekordu: dodaj podany rekord DNS.
    • Wartość: przypisz podaną wartość do swoich rekordów. Dostawca domeny może używać takich określeń jak „Dane”, „Wskazuje”, „Treść”, „Adres” lub „Adres IP”. Zawartość pola wartości różni się w zależności od typu rekordu. Na przykład rekordy TXT to ciągi znaków.
  2. Kliknij Zweryfikuj rekordy. App Hosting spróbuje wykryć zmiany wprowadzone u dostawcy domeny. Rozpowszechnienie tych zmian może potrwać do 24 godzin. Stan możesz sprawdzić w panelu backendu w sekcji Ustawienia > Domeny.

Łączenie nowej domeny

Jeśli nie musisz się martwić przestojami, np. gdy łączysz domenę, która jest nowa w Twojej aplikacji internetowej, postępuj zgodnie z instrukcjami w tej sekcji.

Krok 1. Dodaj domenę niestandardową

  1. W konsoli Firebase otwórz Hosting i usługi bezserwerowe > Hosting aplikacji.
  2. Wybierz App Hosting backend, korzystając z opcji Wyświetl panel.
  3. Kliknij kartę Ustawienia, a potem Dodaj domenę niestandardową.
  4. Wpisz nazwę domeny niestandardowej, którą chcesz połączyć z 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ć , aby skonfigurować rekordy DNS i dokończyć konfigurowanie domeny niestandardowej.

Krok 2. Zweryfikuj rekordy DNS

  1. Kreator Konfigurowanie domeny w konsoli Firebase wyświetli rekordy, które należy zaktualizować, aby przekierować stronę do Hostingu aplikacji Firebase. Dodaj, usuń i zapisz rekordy z domeny u dostawcy DNS, używając tych danych wejściowych:
    • Nazwa: w przypadku rekordów wpisz nazwę domeny niestandardowej. Wskazany host to domena, w której chcesz udostępniać treści. Może to być domena główna lub subdomena. Dostawca domeny może używać takich określeń jak „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Typ rekordu: dodaj podany rekord DNS.
    • Wartość: przypisz podaną wartość do swoich rekordów. Dostawca domeny może używać takich określeń jak „Dane”, „Wskazuje”, „Treść”, „Adres” lub „Adres IP”. Zawartość pola wartości różni się w zależności od typu rekordu. Na przykład rekordy TXT to ciągi znaków.
  2. Kliknij Zweryfikuj rekordy. App Hosting spróbuje wykryć zmiany wprowadzone u dostawcy domeny. Rozpowszechnienie tych zmian może potrwać do 24 godzin. Stan możesz sprawdzić w panelu backendu w sekcji Ustawienia > Domeny.

Poczekaj na udostępnienie certyfikatu SSL

App Hosting Po zaktualizowaniu rekordów DNS udostępnienie certyfikatu SSL dla Twojej domeny może potrwać kilka godzin. W niektórych przypadkach może to zająć do 24 godzin po przekierowaniu DNS na Firebase App Hosting.

Ten certyfikat możesz wyświetlić za pomocą narzędzi zabezpieczeń przeglądarki. Podczas udostępniania domeny możesz zobaczyć nieprawidłowy certyfikat lub mieć problemy z połączeniem z domeną. Jest to normalny etap procesu, a problem zostanie rozwiązany, gdy certyfikat domeny będzie dostępny.

Uwaga: Firebase App Hosting automatycznie udostępnia certyfikaty SSL w razie potrzeby dla domen niestandardowych.

Opisy stanów domen niestandardowych

Stan Opis
Wymaga konfiguracji

Może być konieczne wprowadzenie zmian w konfiguracji rekordów DNS.

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

  • W rzadszych przypadkach wyzwania SSL mogą się nie powieść, ponieważ rekordy DNS zawierają rekordy A lub CNAME, które wskazują innych dostawców hostingu.
    Wskazówka dotycząca rozwiązywania problemów: sprawdź, czy rekordy A wskazują tylko Firebase App Hosting, i usuń wszystkie rekordy CNAME.
Oczekuje

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

Czasami zbyt restrykcyjne rekordy CAA mogą wstrzymać udostępnianie certyfikatu SSL dla domeny niestandardowej. Upewnij się, że urzędy certyfikacji `letsencrypt.org` i `pki.goog` mogą tworzyć certyfikaty SSL dla Twojej domeny.
Udostępnianie certyfikatu

Dla Twojej domeny jest generowany certyfikat SSL.
Połączono

Twoja domena niestandardowa ma prawidłowe rekordy DNS i certyfikat SSL certyfikat.
Możesz udostępniać treści witryny.