Połącz domenę niestandardową

Dzięki Firebase Hosting nie musisz rezygnować z wyjątkowych nazw domen związanych z 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 Hosting udostępnia certyfikat SSL dla każdej z Twoich domen i udostępnia Twoje treści za pomocą globalnej sieci CDN.

W dalszej części tego dokumentu znajdziesz instrukcje łączenia domeny niestandardowej.

Konfigurowanie domeny na potrzeby Hosting

Upewnij się, że na stronie Firebase Hosting w projekcie masz ukończony kreator „Rozpoczynanie pracy”. Dzięki temu w projekcie Firebase będziesz mieć witrynę Firebase Hosting.

Krok 1. Dodaj domenę niestandardową

  1. Na stronie Hosting projektu otwórz kreatora łączenia domeny niestandardowej:

    • Jeśli masz tylko jedną witrynę Hosting, kliknij Dodaj domenę niestandardową.
    • Jeśli masz więcej niż jedną witrynę Hosting, kliknij Wyświetl obok wybranej witryny, a następnie kliknij Dodaj domenę niestandardową.

  2. Wpisz niestandardową nazwę domeny, którą chcesz połączyć ze swoją witryną Hosting.

  3. (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).

  4. Kliknij Dalej, aby skonfigurować rekordy DNS i zakończyć konfigurowanie domeny niestandardowej.

Krok 2. Skonfiguruj domenę niestandardową

Jeśli w kreatorze konfiguracji Połącz domenę pojawi się taka prośba, potwierdź domenę najwyższego poziomu.

Dzięki tym czynnościom możesz mieć pewność, że Twoja domena nie jest już połączona z projektem Firebase i że jesteś jej właścicielem.

  1. W witrynie dostawcy domeny znajdź stronę zarządzania DNS.

  2. Dodaj i zapisz nowy rekord, podając te dane:

    • Typ: dodaj rekord TXT.

      Firebase Hosting wymaga, aby ten rekord TXT był stale obecny w ustawieniach DNS, aby udowodnić własność domeny i upoważnić Firebase do przypisywania i odnawiania certyfikatów SSL dla Twojej witryny.

      Twój dostawca domeny może podać ten termin jako „Typ rekordu”.

    • Host: wpisz klucz domeny najwyższego poziomu.

      Potwierdzenie własności domeny najwyższego poziomu lub domeny głównej powoduje potwierdzenie własności wszystkich jej subdomen.

      Twój dostawca domen może podać ten termin jako „Nazwa hosta”, „Nazwa” lub „Domena”.

    • Wartość: skopiuj unikalną wartość weryfikacyjną do tego pola.

      Firebase Hosting sprawdza tę wartość, aby potwierdzić własność domeny.

      Twój dostawca domeny może podać ten termin jako „Dane”.

  3. Poczekaj do 24 godzin na propagację zaktualizowanych rekordów TXT, a potem kliknij Weryfikuj.

    Pamiętaj, że możesz kliknąć Anuluj, aby bezpiecznie zamknąć okno Połącz domenę i otworzyć je ponownie w późniejszym czasie. Nie wpłynie to na czas propagacji, ale po ponownym otwarciu okna pojawi się prośba o ponowne wpisanie nazwy domeny.

    Po upływie wystarczającego czasu na propagację kliknięcie Zweryfikuj w oknie Połącz domenę w konsoli Firebase umożliwia rozpoczęcie procesu udostępniania certyfikatu SSL.

    W większości przypadków propagacja rekordów i weryfikacja domeny nastąpi w ciągu kilku godzin, w zależności od dostawcy domeny. Szczegółowe instrukcje dodawania rekordów TXT oraz czas propagacji znajdziesz w dokumentacji dostawcy domeny.

    Jeśli po kliknięciu Sprawdź pojawi się komunikat o błędzie, oznacza to, że rekordy nie zostały rozpowszechnione lub wartości są nieprawidłowe.

W kreatorze Dodawanie domeny niestandardowej w konsoli Firebase wybierz Szybka konfiguracja lub Konfiguracja zaawansowana.

Szybka konfiguracja może być używana w przypadku nowych domen, które nie generują obecnie ruchu, lub domen, które próbujesz przenieść z innej witryny Hosting. Konfiguracja zaawansowana może być używana, jeśli masz już domenę, która otrzymuje żądania od innego dostawcy hostingu i chcesz przeprowadzić migrację bez przestojów.

Kreator Konfiguracja zaawansowana pomoże Ci utworzyć certyfikat SSL i roszczenie do domeny, aby umożliwić Hosting wyświetlanie reklam w domenie przed otrzymaniem ruchu.

Czekaj na udostępnienie certyfikatu SSL

Po potwierdzeniu własności domeny wystawimy certyfikat SSL dla Twojej domeny i w ciągu 24 godzin od ustawienia rekordów DNS A na serwer Firebase Hosting wdrożymy go w naszym globalnym CDN.

Twoja domena będzie wymieniona jako jedna z alternatywnych nazw podmiotu (SAN) w certyfikacie SSL FirebaseApp. Certyfikat możesz wyświetlić za pomocą narzędzi bezpieczeństwa przeglądarki. Podczas konfigurowania domeny możesz zobaczyć nieprawidłowy certyfikat, który nie zawiera nazwy Twojej domeny. To normalna część procesu, która zostanie rozwiązana, 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 Firebase Hosting strony projektu nie zmieni się na Połączona.

Klucz domeny niestandardowej

Podczas dodawania lub edytowania rekordów DNS różni dostawcy domen oczekują, że w polu Host na swoich stronach zarządzania DNS podasz różne dane. Poniżej przedstawiamy najczęściej używane dane wejściowe od popularnych dostawców. Szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Typ domeny Klucz domeny niestandardowej
Domena najwyższego poziomu

Typowe dane wejściowe:

  • @
  • Nazwa domeny najwyższego poziomu (na przykład example.com).
  • pozostawienie pola Host (Host) pustego;
Subdomena

Typowe dane wejściowe:

  • Pełna nazwa subdomeny (na przykład app.example.com)
  • Tylko część subdomeny (np. tylko app, pomijając .example.com)
  • Tylko www dla subdomeny www.example.com

Popularni dostawcy domen

Oto lista niektórych typowych dostawców domen i typów danych, których mogą wymagać. Staramy się, aby informacje były jak najbardziej aktualne, ale szczegółowe instrukcje znajdziesz w dokumentacji dostawcy domeny.

Opis 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 z serwerów nazw domeny do serwerów Firebase Hosting.
    Wskazówka dotycząca rozwiązywania problemów: jeśli minęło ponad 24 godziny, sprawdź, czy rekordy są kierowane do Firebase Hosting.

  • W rzadszych przypadkach, zwłaszcza jeśli używasz konfiguracji zaawansowanej, testy zabezpieczające SSL mogą się nie udać, ponieważ:

    • Wyzwania certyfikatu SSL zakończyły się niepowodzeniem, a token (rekordy DNS TXT lub przesłany plik dostarczony do witryny) jest teraz nieprawidłowy.
      Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl obok domeny, a następnie podaj nowy token w istniejącej domenie.
Oczekuje

Domena niestandardowa została prawidłowo skonfigurowana, ale Firebase Hostingnie ma certyfikatu SSL.

Czasami tworzenie certyfikatu SSL dla domeny niestandardowej może zostać wstrzymane z powodu tych problemów:

  • Rekordy CAA są zbyt restrykcyjne.
    Wskazówka dotycząca rozwiązywania problemów: upewnij się, że urzędy certyfikacji `letsencrypt.org` i `pki.goog` mają uprawnienia do tworzenia certyfikatów SSL dla Twojej domeny.
  • Twój kod weryfikacyjny jest nieprawidłowy.
    Jeśli używasz zaawansowanego procesu konfiguracji i migracja się nie powiodła, Twój token (i jego kod weryfikacyjny) są teraz nieprawidłowe.
    Wskazówka dotycząca rozwiązywania problemów: kliknij Wyświetl obok domeny, a następnie podaj nowy token w istniejącej domenie.
  • poproszono o certyfikaty dla zbyt wielu subdomen.
    Wskazówka dotycząca rozwiązywania problemów: z powodu limitów tworzenia certyfikatów SSL Firebase Hosting zaleca, aby w jednej domenie niestandardowej na poziomie najwyższym nie było więcej niż 20 subdomen.
Certyfikat bicia monet

Tworzony jest certyfikat SSL dla Twojej domeny.
Połączono

Twoja domena niestandardowa ma prawidłowe rekordy DNS i certyfikat SSL.
Możesz wyświetlać treści z Twojej witryny.