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 dalszej 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łączność
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 Te rekordy zawierają 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 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 Cloud Certificate Manager do udostępniania certyfikatów SSL dla Twojej domeny niestandardowej. Rekord CNAME w subdomenie _acme-challenge... umożliwia usłudze menedżer certyfikatów tworzenie i odnawianie certyfikatów. Po wdrożeniu tego rekordu nie można usunąć, ponieważ w przeciwnym razie ochrona certyfikatu wygaśnie.
 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ć, w której domenie niestandardowej ma być wyświetlana Twoja domena. 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 wysyła żądania dotyczące rekordów CAA tylko wtedy, gdy nie może utworzyć 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 znajdziesz 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ęść subdomeny (np. tylko app, bez .example.com).

Popularni dostawcy domen

Oto kilku popularnych dostawców 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 przestoju, możesz skorzystać z procesu Migracja domeny w konsoli Firebase. Ten proces przeprowadzi Cię przez 2-etapowy proces, który przygotuje App Hosting do udostępniania treści w Twojej domenie, zanim skieruje ruch na serwery App Hosting.

Krok 1. Dodaj domenę niestandardową

  1. W konsoli Firebase otwórz Hosting i usługi bezserwerowe > Hosting aplikacji.
  2. Wybierz backend App Hosting, korzystając z opcji Wyświetl panel.
  3. Kliknij kolejno kartę Ustawienia i 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ć konfigurację własnej domeny.

Krok 2. Przygotuj domenę

  1. W kreatorze Konfigurowanie domeny kliknij kartę Migracja domeny.
  2. Postępuj zgodnie z instrukcjami w pierwszym kroku, Przygotuj domenę, który obejmuje 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 wejściowe dla wymaganych rekordów:
    • Nazwa: wpisz nazwę domeny niestandardowej 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ść: przypisz podaną wartość do swoich 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. Przekieruj do App Hosting

  1. Po tym, jak App Hosting zweryfikuje aktualizacje rekordu z poprzedniego kroku, kreator przejdzie do ostatniego kroku Bezpośrednio 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 nazwę domeny niestandardowej 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ść: przypisz podaną wartość do swoich 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. Dodaj domenę niestandardową

  1. W konsoli Firebase otwórz Hosting i usługi bezserwerowe > Hosting aplikacji.
  2. Wybierz backend App Hosting, korzystając z opcji Wyświetl panel.
  3. Kliknij kolejno kartę Ustawienia i 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ć konfigurację własnej domeny.

Krok 2. Sprawdź rekordy DNS

  1. Kreator Konfigurowanie domeny w Firebase konsoli wyświetli niezbędne rekordy, które musisz zaktualizować, aby przekierować stronę do Firebase App Hosting. Dodawaj, usuwaj i zapisuj rekordy z domeny u dostawcy DNS
      , podając te dane:
    • Nazwa: wpisz nazwę domeny niestandardowej 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ść: przypisz podaną wartość do swoich 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.

Oczekiwanie na udostępnienie certyfikatu SSL

App Hosting może potrwać kilka godzin, zanim po zaktualizowaniu rekordów DNS udostępnimy certyfikat SSL dla Twojej domeny. W niektórych przypadkach może to potrwać do 24 godzin od momentu przekierowania DNS na Firebase App Hosting.

Ten certyfikat możesz wyświetlić 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 serwerów 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 CNAME, które wskazują innych dostawców hostingu.
    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 prawidłowo skonfigurowana, ale usługa Firebase App Hosting nie udostępniła certyfikatu SSL.

Czasami zbyt restrykcyjne rekordy CAA mogą opóźniać tworzenie certyfikatu SSL dla domeny niestandardowej. Upewnij się, że 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.