Catch up on highlights from Firebase at Google I/O 2023. Learn more

Verbinden Sie eine benutzerdefinierte Domäne

Mit Firebase Hosting müssen Sie Ihre einzigartigen, markenzentrierten Domainnamen nicht aufgeben. Sie können eine benutzerdefinierte Domäne (wie example.com oder app.example.com ) anstelle einer von Firebase generierten Domäne für Ihre von Firebase gehostete Website verwenden.

Firebase Hosting stellt ein SSL-Zertifikat für jede Ihrer Domains bereit und stellt Ihre Inhalte über ein globales CDN bereit.

Der Rest dieses Dokuments führt Sie durch diese Schritte, um Ihre benutzerdefinierte Domäne zu verbinden.

Richten Sie Ihre Domain für das Hosting ein

Stellen Sie sicher, dass Sie den Assistenten „Erste Schritte“ auf der Firebase-Hosting-Seite Ihres Projekts abgeschlossen haben, damit Sie eine Firebase-Hosting-Site in Ihrem Firebase-Projekt haben.

Schritt 1 : Domäne hinzufügen

  1. Rufen Sie auf der Hosting-Seite Ihres Projekts den Assistenten zum Verbinden einer benutzerdefinierten Domain auf:

    • Wenn Sie nur eine Hosting-Site haben, klicken Sie auf Benutzerdefinierte Domäne hinzufügen .
    • Wenn Sie mehr als eine Hosting-Site haben , klicken Sie für die gewünschte Site auf Anzeigen und dann auf Benutzerdefinierte Domäne hinzufügen .

  2. Geben Sie den benutzerdefinierten Domänennamen ein, den Sie mit Ihrer Hosting-Site verbinden möchten.

  3. (Optional) Aktivieren Sie das Kontrollkästchen, um alle Anforderungen auf der benutzerdefinierten Domäne an eine zweite angegebene Domäne umzuleiten (so dass example.com und www.example.com auf denselben Inhalt umleiten).

  4. Klicken Sie auf Weiter , um den Validierungsprozess zu starten.

Schritt 2 : Domain-Inhaberschaft bestätigen

Verifizieren Sie Ihre Apex-Domäne, wenn Sie im Connect Domain- Setup-Assistenten dazu aufgefordert werden.

Diese Schritte stellen sicher, dass Ihre Domain nicht bereits mit einem Firebase-Projekt verknüpft ist und dass Sie Eigentümer der angegebenen Domain sind.

  1. Suchen Sie auf der Website Ihres Domänenanbieters die DNS-Verwaltungsseite.

  2. Fügen Sie einen neuen Datensatz mit den folgenden Eingaben hinzu und speichern Sie ihn:

    • Typ : Fügen Sie einen TXT-Eintrag hinzu.

      Firebase Hosting erfordert, dass Sie diesen TXT-Eintrag ständig in Ihren DNS-Einstellungen vorhanden halten, um Ihr Eigentum an der Domain nachzuweisen und Firebase zu autorisieren, SSL-Zertifikate für Ihre Website zuzuweisen und zu erneuern.

      Ihr Domain-Anbieter führt diesen Begriff möglicherweise als „Eintragstyp“ auf.

    • Host : Geben Sie Ihren Apex-Domänenschlüssel ein.

      Der Nachweis Ihres Eigentums an einer Apex-Domain oder Root-Domain beweist Ihr Eigentum an allen ihren Subdomains.

      Ihr Domänenanbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domäne“ auf.

    • Wert : Kopieren Sie den eindeutigen Verifizierungswert in das Feld.

      Firebase Hosting prüft diesen Wert, um Ihre Domain-Inhaberschaft nachzuweisen.

      Ihr Domain-Anbieter führt diesen Begriff möglicherweise als „Daten“ auf.

  3. Warten Sie bis zu 24 Stunden, bis Ihre aktualisierten TXT-Einträge verbreitet sind, und klicken Sie dann auf Verifizieren .

    Beachten Sie, dass Sie auf „Abbrechen“ klicken können, um das Fenster „Domäne verbinden“ sicher zu schließen und zu einem späteren Zeitpunkt erneut zu öffnen. Dies wirkt sich nicht auf die Ausbreitungszeit aus, aber Sie werden aufgefordert , Ihren Domänennamen erneut einzugeben, wenn Sie das Fenster erneut öffnen.

    Nach ausreichender Verbreitungszeit können Sie durch Klicken auf Verifizieren im Fenster „ Domäne verbinden“ der Firebase-Konsole mit dem Bereitstellungsprozess für das SSL-Zertifikat beginnen.

    In den meisten Fällen erfolgt die Weitergabe Ihrer Datensätze und die Verifizierung Ihrer Domain je nach Domain-Anbieter innerhalb weniger Stunden. Detaillierte Anweisungen zum Hinzufügen von TXT-Einträgen und Ausbreitungszeiten finden Sie in der Dokumentation Ihres Domänenanbieters.

    Wenn beim Klicken auf Bestätigen eine Fehlermeldung angezeigt wird, wurden Ihre Datensätze nicht weitergegeben oder Ihre Werte sind möglicherweise falsch.

Schritt 3 : Live gehen

Wählen Sie im Fenster „Domäne verbinden “ der Firebase-Konsole „Schnelleinrichtung“ für eine neue Website oder „ Erweiterte Einrichtung“ , wenn Sie bereits eine Website auf einem anderen Hostinganbieter ausführen und eine Migration ohne Ausfallzeiten benötigen.

Warten Sie auf die Bereitstellung des SSL-Zertifikats

Nachdem wir die Domain-Inhaberschaft überprüft haben, stellen wir ein SSL-Zertifikat für Ihre Domain bereit und stellen es innerhalb von 24 Stunden, nachdem Sie Ihre DNS-A-Einträge auf Firebase Hosting verweisen, in unserem globalen CDN bereit.

Ihre Domäne wird im FirebaseApp-SSL-Zertifikat als einer der Subject Alternative Names (SAN) aufgeführt. Sie können dieses Zertifikat mit den Sicherheitstools des Browsers anzeigen. Während die Domäne bereitgestellt wird, sehen Sie möglicherweise ein ungültiges Zertifikat, das Ihren Domänennamen nicht enthält. Dies ist ein normaler Teil des Prozesses und wird behoben, sobald das Zertifikat Ihrer Domäne verfügbar ist.

Für Benutzer der erweiterten Einrichtung wird Ihre Website von Ihrem vorherigen Hostinganbieter gehostet, bis der Einrichtungsstatus auf der Firebase-Hostingseite Ihres Projekts auf Verbunden aktualisiert wird.

Ihr benutzerdefinierter Domänenschlüssel

Beim Hinzufügen oder Bearbeiten von DNS-Einträgen erwarten verschiedene Domainanbieter, dass Sie auf ihren DNS-Verwaltungssites unterschiedliche Eingaben für das Feld „Host“ eingeben. Wir haben unten allgemeine Eingaben von beliebten Anbietern zusammengestellt. Ausführliche Anweisungen finden Sie in der Dokumentation Ihres Domänenanbieters.

Domänentyp Benutzerdefinierter Domänenschlüssel
Apex-Domäne

Zu den üblichen Eingaben gehören:

  • @
  • Der Apex-Domänenname (z. B. example .com )
  • Lassen Sie das Host- Feld leer
Subdomäne

Zu den üblichen Eingaben gehören:

  • Der vollständige Subdomain-Name (z. B. app. example .com )
  • Nur der Teil der Subdomain (z. B. nur app und Weglassen von . example .com )
  • Nur www für die Subdomain von www. example .com

Gängige Domainanbieter

Hier sind einige gängige Domänenanbieter und die Arten von Eingaben, die jeder möglicherweise benötigt. Diese Informationen werden so weit wie möglich auf dem neuesten Stand gehalten. Detaillierte Anweisungen finden Sie jedoch in der Dokumentation Ihres Domainanbieters.

Richten Sie Statusbeschreibungen für benutzerdefinierte Domains ein

Status Beschreibung
Benötigt Einrichtung

Möglicherweise müssen Sie eine Konfiguration mit Ihren DNS-Einträgen ändern.

  • In den meisten Fällen wurden Ihre DNS-A-Einträge nicht von Ihrem Domainnamenanbieter an die Firebase-Hosting-Server weitergegeben.
    Tipp zur Fehlerbehebung: Wenn mehr als 24 Stunden vergangen sind, überprüfen Sie, ob Sie Ihre Aufzeichnungen auf Firebase Hosting verwiesen haben.

  • In selteneren Fällen, insbesondere wenn Sie den erweiterten Einrichtungsablauf verwenden, schlagen SSL-Herausforderungen möglicherweise aus folgenden Gründen fehl:

    • Ihre DNS-Einträge haben A-Einträge oder CNAME-Einträge, die auf andere Hosting-Anbieter verweisen.
      Tipp zur Fehlerbehebung: Vergewissern Sie sich, dass Ihre A-Einträge nur auf Firebase Hosting verweisen, und entfernen Sie alle CNAME-Einträge.
    • Die Migration ist fehlgeschlagen und das Token (DNS-TXT-Einträge oder hochgeladene Datei, die Ihrer Website bereitgestellt wurden) ist jetzt ungültig.
      Tipp zur Fehlerbehebung: Klicken Sie für die Domäne auf Anzeigen und stellen Sie dann das neue Token für Ihre vorhandene Domäne bereit.
Ausstehend

Sie haben Ihre benutzerdefinierte Domäne korrekt eingerichtet, aber Firebase Hosting hat kein SSL-Zertifikat bereitgestellt.

Gelegentlich können die folgenden Probleme das Prägen eines SSL-Zertifikats für eine benutzerdefinierte Domäne blockieren:

  • Ihre CAA-Einträge sind zu restriktiv.
    Tipp zur Fehlerbehebung: Stellen Sie sicher, dass die Zertifizierungsstellen „letsencrypt.org“ und „pki.goog“ berechtigt sind, SSL-Zertifikate für Ihre Domain zu erstellen.
  • Ihr Challenge-Code ist ungültig.
    Wenn Sie den Advanced Setup-Flow verwenden und die Migration fehlgeschlagen ist, sind Ihr Token (und sein Challenge-Code) jetzt ungültig.
    Tipp zur Fehlerbehebung: Klicken Sie für die Domäne auf Anzeigen und stellen Sie dann das neue Token für Ihre vorhandene Domäne bereit.
  • Sie haben Zertifikate für zu viele Subdomains angefordert.
    Tipp zur Fehlerbehebung: Im Allgemeinen empfiehlt Firebase Hosting nicht mehr als 20 Subdomains auf einer benutzerdefinierten Apex-Domain, aufgrund von Limits für das Prägen von SSL-Zertifikaten.
In Verbindung gebracht

Ihre benutzerdefinierte Domäne verfügt über die richtigen DNS-Einträge und ein SSL-Zertifikat.
Sie können den Inhalt Ihrer Website bereitstellen.

Benötigt erneute Überprüfung

Firebase fordert Sie möglicherweise auf, Ihre Domain-Inhaberschaft manuell erneut zu bestätigen, wenn der TXT-Eintrag, der bei der anfänglichen Bestätigung Ihrer Domain-Inhaberschaft hinzugefügt wurde, geändert oder aus den DNS-Einstellungen Ihrer Domain entfernt wurde.

  • Beachten Sie, dass mehrere TXT-Einträge mit einem Google-Site-Verifizierungstoken auf einer einzelnen Domain zulässig sind.
  • Wir verlangen, dass der TXT-Eintrag ständig in Ihren DNS-Einstellungen vorhanden ist, da dies beweist, dass Sie Eigentümer der Domain sind, und uns autorisiert, SSL-Zertifikate für Ihre Website zuzuweisen und zu erneuern.
Tipp zur Fehlerbehebung: Besuchen Sie die Hosting-Seite Ihres Projekts, um den erneuten Verifizierungsprozess innerhalb des angegebenen Zeitfensters (normalerweise 30 Tage) abzuschließen, um zu vermeiden, dass Ihre benutzerdefinierte Domäne automatisch vom Firebase-Hosting getrennt wird.