Połącz domenę niestandardową

Nie musisz rezygnować z unikalnych, związanych z marką nazw domen dla aplikacji wdrożonych w Firebase App Hosting. Zamiast domeny wygenerowanej przez Firebase możesz używać w witrynie hostowanej w Hosting Firebase własnej domeny (np. example.com lub app.example.com). Firebase App Hosting udostępnia certyfikat SSL dla każdej z Twoich domen.

W dalszej 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. Postępuj zgodnie z instrukcjami migracji domeny, aby zapobiec przestojom w działaniu aplikacji.

Jeśli przerwa w działaniu nie jest problemem, na przykład gdy łączysz domenę, która jest nowa w aplikacji internetowej, postępuj zgodnie z instrukcjami łączenia nowej domeny.

Zanim zaczniesz: typy rekordów DNS

Kreator Konfiguracja domeny w App Hosting może poprosić Cię o dodanie lub usunięcie od 1 do 5 rekordów DNS, w zależności od bieżącej konfiguracji domeny. Typ rekordu A określa jego funkcję. Oto typy rekordów, o które może poprosić App Hosting:

Typ Opis Wyłączność
A Te rekordy zawierają wartości IPv4 (np. 8.8.8.8), które informują przeglądarki, jakiego adresu użyć 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 o podobnej funkcji jak rekordy A. App Hosting nie używa obecnie rekordów AAAA, ale poprosi Cię o usunięcie wszystkich istniejących rekordów z domeny, jeśli takie istnieją. 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 wprowadzenie: jeśli to możliwe, App Hosting prosi 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 Cloud do obsługi certyfikatów SSL dla Twojej własnej domeny. Rekord CNAME w subdomenie _acme-challenge... umożliwia Menedżerowi certyfikatów tworzenie i odnawianie certyfikatów. Po zakończeniu procesu rejestracji nie wolno usuwać tego rekordu, ponieważ spowoduje to wygaśnięcie certyfikatu.
 Tak
TXT Te rekordy umożliwiają dołączanie do domeny dowolnych metadanych. App Hosting umożliwia użycie określonego formatu rekordu TXT, fah-claim=[UUID], aby wskazać, którą własną domenę ma obsługiwać w Twojej domenie. Nie
CAA Te rekordy działają jak lista dozwolonych, na której można określić urzędy certyfikacji uprawnione do wystawiania certyfikatów SSL dla Twojej domeny. App Hosting żąda rekordów CAA tylko wtedy, gdy nie może utworzyć certyfikatów dla Twojej domeny. Nie

Zanim zaczniesz: nazwa Twojej domeny

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują, że w polu Host (lub Nazwa hosta) w witrynach zarządzania DNS wpiszesz różne dane. Kreator własnej domeny App Hosting wymaga wpisania tej samej wartości w polu Nazwa.

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

Typ domeny Nazwa własnej domeny
Domena najwyższego poziomu

Typowe dane wejściowe:

  • @
  • Nazwa domeny najwyższego poziomu (np. example.com).
  • pozostawienie pola Host pustego,
Subdomena

Typowe dane wejściowe:

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

Popularni dostawcy domen

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

Migracja domeny

Jeśli chcesz przenieść domenę od innego dostawcy do App Hosting bez żadnych przestojów, możesz użyć procesu Przenieś domenę w konsoli Firebase. Ten proces składa się z 2 etapów, które przygotowują App Hosting do wyświetlania treści w Twojej domenie, zanim ruch zostanie skierowany na serwery App Hosting.

Krok 1. Dodaj własną domenę

  1. W konsoli Firebase otwórz Hosting i bezserwerowe > App Hosting.
  2. Wybierz backend App Hosting, korzystając z opcji Wyświetl panel.
  3. Wybierz kartę Ustawienia, a następnie kliknij Dodaj własną domenę.
  4. Wpisz nazwę własnej domeny, którą chcesz połączyć ze swoją witryną App Hosting.
  5. (Opcjonalnie) Zaznacz pole, aby przekierowywać wszystkie żądania w własnej domenie do drugiej określonej domeny (tak aby adresy example.com i www.example.com przekierowywały do tych samych treści).
  6. Kliknij Przejdź do konfiguracji, aby skonfigurować rekordy DNS i dokończyć konfigurowanie własnej domeny.

Krok 2. Przygotuj domenę

  1. Wybierz kartę Migrate a domain (Przenieś domenę) w kreatorze Set up domain (Skonfiguruj domenę).
  2. Postępuj zgodnie z instrukcjami podanymi w pierwszym kroku, Przygotuj domenę, który obejmuje zestaw zmian niezbędnych do tego, aby usługa App Hosting obsługiwała preferowany backend i nawiązywała bezpieczne połączenia TLS dla Twojej domeny. Dodaj, usuń i zapisz rekordy domeny u dostawcy DNS, podając te dane wymaganych rekordów:
    • Nazwa: wpisz nazwę własnej domeny dla 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 używać określenia „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Record type (Typ rekordu): dodaj podany rekord DNS.
    • Wartość: przypisz podaną wartość do rekordów. Dostawca domeny może używać określenia „Dane”, „Wskazuje na”, „Treść”, „Adres” lub „Adres IP”. Zawartość pola wartości różni się w zależności od typu rekordu. Na przykład rekordy TXT są ciągami znaków.
  3. Wybierz Zweryfikuj rekordy. App Hosting spróbuje wykryć zmiany wprowadzone u dostawcy domeny. Zastosowanie zmian może potrwać do 24 godzin. Stan możesz sprawdzić w widoku Ustawienia > Domeny w panelu backendu.

Krok 3. Przekierowanie 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 kierować ruch w domenie na serwery App Hosting. Tak jak wcześniej, dodaj, usuń i zapisz rekordy z domeny u dostawcy DNS, podając te dane dla wymaganych rekordów:
    • Nazwa: wpisz nazwę własnej domeny dla 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 używać określenia „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Record type (Typ rekordu): dodaj podany rekord DNS.
    • Wartość: przypisz podaną wartość do rekordów. Dostawca domeny może używać określenia „Dane”, „Wskazuje na”, „Treść”, „Adres” lub „Adres IP”. Zawartość pola wartości różni się w zależności od typu rekordu. Na przykład rekordy TXT są ciągami znaków.
  2. Wybierz Zweryfikuj rekordy. App Hosting spróbuje wykryć zmiany wprowadzone u dostawcy domeny. Zastosowanie zmian może potrwać do 24 godzin. Stan możesz sprawdzić w widoku Ustawienia > Domeny w panelu backendu.

Łączenie nowej domeny

Jeśli przerwa w działaniu nie jest problemem, na przykład gdy łączysz domenę, która jest nowa w aplikacji internetowej, postępuj zgodnie z instrukcjami w tej sekcji.

Krok 1. Dodaj własną domenę

  1. W konsoli Firebase otwórz Hosting i bezserwerowe > App Hosting.
  2. Wybierz backend App Hosting, korzystając z opcji Wyświetl panel.
  3. Wybierz kartę Ustawienia, a następnie kliknij Dodaj własną domenę.
  4. Wpisz nazwę własnej domeny, którą chcesz połączyć ze swoją witryną App Hosting.
  5. (Opcjonalnie) Zaznacz pole, aby przekierowywać wszystkie żądania w własnej domenie do drugiej określonej domeny (tak aby adresy example.com i www.example.com przekierowywały do tych samych treści).
  6. Kliknij Przejdź do konfiguracji, aby skonfigurować rekordy DNS i dokończyć konfigurowanie własnej domeny.

Krok 2. Zweryfikuj rekordy DNS

  1. Kreator Konfiguracja domeny w konsoli Firebase wyświetli niezbędne rekordy, które należy zaktualizować, aby strona wskazywała na Firebase App Hosting. Dodaj, usuń i zapisz rekordy domeny u dostawcy DNS, podając te informacje:
    • Nazwa: wpisz nazwę własnej domeny dla 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 używać określenia „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Record type (Typ rekordu): dodaj podany rekord DNS.
    • Wartość: przypisz podaną wartość do rekordów. Dostawca domeny może używać określenia „Dane”, „Wskazuje na”, „Treść”, „Adres” lub „Adres IP”. Zawartość pola wartości różni się w zależności od typu rekordu. Na przykład rekordy TXT są ciągami znaków.
  2. Wybierz Zweryfikuj rekordy. App Hosting spróbuje wykryć zmiany wprowadzone u dostawcy domeny. Zastosowanie zmian może potrwać do 24 godzin. Stan możesz sprawdzić w widoku Ustawienia > Domeny w panelu backendu.

Oczekiwanie na udostępnienie certyfikatu SSL

Po zaktualizowaniu rekordów DNS udostępnienie certyfikatu SSL dla domeny przez App Hosting może potrwać do kilku godzin. W niektórych przypadkach może to potrwać do 24 godzin od momentu skierowania DNS na Firebase App Hosting.

Możesz go wyświetlić, korzystając z narzędzi zabezpieczeń przeglądarki. Podczas udostępniania domeny może pojawić się nieprawidłowy certyfikat lub mogą wystąpić problemy z połączeniem z domeną. Jest to normalny element procesu, który zostanie rozwiązany, gdy certyfikat domeny będzie dostępny.

Uwaga: Firebase App Hosting automatycznie ponownie udostępnia certyfikaty SSL w razie potrzeby w przypadku własnych domen.

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 jeszcze rozpowszechnione od 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ą na Firebase App Hosting.

  • W rzadszych przypadkach testy SSL mogą się nie powieść, ponieważ 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 Firebase App Hosting, i usuń wszystkie rekordy CNAME.
Oczekuje

Własna domena została skonfigurowana prawidłowo, ale usługa Firebase App Hosting nie udostępniła certyfikatu SSL.

Czasami zbyt restrykcyjne rekordy CAA mogą uniemożliwić utworzenie certyfikatu SSL dla własnej domeny. Upewnij się, że urzędy certyfikacji `letsencrypt.org` i `pki.goog` mogą tworzyć certyfikaty SSL dla Twojej domeny.
Certyfikat wybicia

Trwa generowanie certyfikatu SSL dla Twojej domeny.
Połączono

Twoja własna domena ma prawidłowe rekordy DNS i certyfikat SSL.
Możesz wyświetlać treści ze swojej witryny.