Połącz domenę niestandardową

Nie musisz rezygnować z unikalnych nazw domen związanych z marką w przypadku aplikacji wdrożonych na platformie Firebase App Hosting. Zamiast domeny wygenerowanej przez Firebase możesz użyć domeny niestandardowej (np.example.com lub app.example.com) w przypadku 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 w 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 aplikacji, postępuj zgodnie z instrukcjami migracji domeny.

Jeśli przerwa w działaniu nie jest problemem, 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

Kreator App Hosting Skonfiguruj domenę 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 określa jego funkcję. Oto typy rekordów, o które App Hostingmoże poprosić:

Typ Opis Wyłącznie
A Rekordy te 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 Zawierają one wartości IPv6 (np. 2001:4860:4860::8888), czyli inny typ rekordu adresu o funkcji podobnej do rekordu A. App Hosting nie używa obecnie rekordów AAAA, ale poprosi Cię o usunięcie z domeny wszystkich istniejących rekordów tego typu. Tak
CNAME Rekordy te zawierają osobną 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: w miarę możliwości usługa 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 w chmurze do udostępniania certyfikatów SSL dla Twojej domeny niestandardowej. Rekord CNAME w subdomenie _acme-challenge... umożliwia usłudze Certificate Manager tworzenie i odnawianie certyfikatów. Po wdrożeniu tego rekordu nie można usunąć, ponieważ w przeciwnym razie utracisz ochronę certyfikatu.
 Tak
TXT Te rekordy umożliwiają dołączanie do domeny dowolnych metadanych. App Hosting umożliwia używanie określonego formatu rekordu TXT, fah-claim=[UUID], aby wskazać, która domena niestandardowa ma obsługiwać 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 żąda rekordów CAA tylko wtedy, gdy nie może wygenerować certyfikatów dla Twojej domeny. Nie

Zanim zaczniesz: niestandardowa nazwa domeny

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują, że w polu Host (lub nazwa hosta) na ich stronach zarządzania DNS wpiszesz różne dane. 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 najwyższego poziomu

Typowe dane wejściowe to:

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

Typowe dane wejściowe to:

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

Popularni dostawcy domen

Oto niektórzy popularni dostawcy domen i rodzaje danych wejściowych, których mogą wymagać. Staramy się, aby te informacje były jak najbardziej aktualne, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Migracja domeny

Jeśli chcesz przenieść domenę od innego dostawcy do App Hostingbez przestojów, możesz skorzystać z procesu Przenoszenie domeny w konsoli Firebase. Ten proces przeprowadzi Cię przez 2-etapowy proces przygotowania do wyświetlania treści w Twojej domenie przed przekierowaniem ruchu na serwery.App HostingApp Hosting

Krok 1. Dodawanie domeny niestandardowej

  1. Otwórz App Hostingstronę projektu.
  2. Wybierz backend App Hosting za pomocą opcji Wyświetl panel.
  3. Kliknij kartę Ustawienia, a potem Dodaj domenę niestandardową.
  4. Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną App Hosting.
  5. (Opcjonalnie) zaznacz pole, aby przekierowywać 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 Kontynuuj konfigurację, aby skonfigurować rekordy DNS i dokończyć konfigurowanie własnej domeny.

Krok 2. Przygotuj domenę

  1. W kreatorze Skonfiguruj domenę kliknij kartę Przenieś domenę.
  2. Postępuj zgodnie z instrukcjami w pierwszym kroku, Przygotuj domenę, który zawiera zestaw zmian niezbędnych do tego, aby usługa App Hosting mogła obsługiwać preferowany backend i ustanawiać bezpieczne połączenia TLS dla Twojej domeny. Dodaj, usuń i zapisz rekordy domeny u dostawcy DNS, podając te dane dla wymaganych rekordów:
    • Nazwa: wpisz niestandardową nazwę 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ć terminu „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Typ rekordu: dodaj podany rekord DNS.
    • Wartość: przypisuje podaną wartość do rekordów. Dostawca domeny może używać terminu „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 to ciągi znaków.
  3. Kliknij 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 na panelu backendu.

Krok 3. Przekierowanie do App Hosting

  1. Po tym, jak App Hosting zweryfikuje aktualizacje rekordu z poprzedniego kroku, kreator przejdzie do ostatniego kroku Przekieruj do App Hosting. Ten krok pokazuje aktualizacje rekordów, które musisz wprowadzić, aby kierować ruch domeny na serwery App Hosting. Podobnie jak wcześniej dodaj, usuń i zapisz rekordy domeny u dostawcy DNS, podając te dane wejściowe dla wymaganych rekordów:
    • Nazwa: wpisz niestandardową nazwę 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ć terminu „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Typ rekordu: dodaj podany rekord DNS.
    • Wartość: przypisuje podaną wartość do rekordów. Dostawca domeny może używać terminu „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 to ciągi znaków.
  2. Kliknij 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 na panelu backendu.

Podłączanie nowej domeny

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

Krok 1. Dodawanie domeny niestandardowej

  1. Otwórz App Hostingstronę projektu.
  2. Wybierz backend App Hosting za pomocą opcji Wyświetl panel.
  3. Kliknij kartę Ustawienia, a potem Dodaj domenę niestandardową.
  4. Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną App Hosting.
  5. (Opcjonalnie) zaznacz pole, aby przekierowywać 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 Kontynuuj konfigurację, aby skonfigurować rekordy DNS i dokończyć konfigurowanie własnej domeny.

Krok 2. Zweryfikuj rekordy DNS

  1. Kreator Konfigurowanie domeny w konsoli Firebase wyświetli niezbędne rekordy, które należy zaktualizować, aby przekierować stronę do Firebase App Hosting. Dodawanie, usuwanie i zapisywanie rekordów z domeny u dostawcy DNS
    • Nazwa: wpisz niestandardową nazwę 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ć terminu „Nazwa hosta”, „Nazwa” lub „Domena”.
    • Typ rekordu: dodaj podany rekord DNS.
    • Wartość: przypisuje podaną wartość do rekordów. Dostawca domeny może używać terminu „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 to ciągi znaków.
  2. Kliknij 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 na panelu backendu.

Poczekaj na udostępnienie certyfikatu SSL

App Hosting może udostępnić certyfikat SSL dla Twojej domeny w ciągu kilku godzin od zaktualizowania rekordów DNS. W niektórych przypadkach może to potrwać do 24 godzin od momentu przekierowania DNS na Firebase App Hosting.

Możesz wyświetlić ten certyfikat za pomocą narzędzi zabezpieczających 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 normalna część procesu, która zostanie rozwiązana, gdy certyfikat domeny będzie dostępny.

Uwaga: Firebase App Hosting automatycznie ponownie udostępnia certyfikaty SSL w razie potrzeby w przypadku 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 A DNS nie zostały jeszcze rozpowszechnione z usługi dostawcy nazwy domeny na serwery Firebase App Hosting.
    Wskazówka: jeśli minęło ponad 24 godziny, sprawdź, czy rekordy wskazują na Firebase App Hosting.

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

Własna domena została prawidłowo skonfigurowana, ale Firebase App Hosting nie ma certyfikatu SSL.

Czasami zbyt restrykcyjne rekordy CAA mogą opóźniać tworzenie certyfikatu SSL dla domeny niestandardowej. Sprawdź, czy urzędy certyfikacji `letsencrypt.org` i `pki.goog` mogą tworzyć certyfikaty SSL dla Twojej domeny.
Certyfikat wybicia

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

Twoja domena niestandardowa ma odpowiednie rekordy DNS i certyfikat SSL.
Możesz wyświetlać treści witryny.