Verbinden Sie eine benutzerdefinierte Domäne

Mit Firebase Hosting müssen Sie nicht auf Ihre einzigartigen, markenzentrierten Domainnamen verzichten. 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 Site 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 zum Verbinden Ihrer benutzerdefinierten Domäne.

Richten Sie Ihre Domain für das Hosting ein

Stellen Sie sicher, dass Sie den „Erste Schritte“-Assistenten auf der Firebase-Hosting-Seite Ihres Projekts abgeschlossen haben, damit Ihr Firebase-Projekt über eine Firebase-Hosting-Site verfügt.

Schritt 1 : Benutzerdefinierte 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 über mehr als eine Hosting-Site verfügen, 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 Anfragen 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 Ihre DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domäne abzuschließen.

Schritt 2 : Benutzerdefinierte Domäne einrichten

Wenn Sie im Einrichtungsassistenten für die Domäne verbinden dazu aufgefordert werden, überprüfen Sie Ihre Apex-Domäne.

Durch diese Schritte stellen Sie 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 Domain-Anbieters die DNS-Verwaltungsseite.

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

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

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

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

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

      Durch den Nachweis, dass Sie Eigentümer einer Apex-Domäne oder Stammdomäne sind, beweisen Sie, dass Sie Eigentümer aller Subdomänen sind.

      Ihr Domain-Anbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.

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

      Firebase Hosting prüft diesen Wert, um den Besitz Ihrer Domain nachzuweisen.

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

  3. Warten Sie bis zu 24 Stunden, bis Ihre aktualisierten TXT-Datensätze weitergegeben werden, und klicken Sie dann auf „Überprüfen“ .

    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 hat keinen Einfluss auf die Ausbreitungszeit, Sie werden jedoch aufgefordert, Ihren Domänennamen erneut einzugeben, wenn Sie das Fenster erneut öffnen.

    Nach ausreichender Ausbreitungszeit können Sie durch Klicken auf „Verifizieren“ im Fenster „Domäne verbinden“ der Firebase-Konsole mit dem Bereitstellungsprozess des SSL-Zertifikats beginnen.

    In den meisten Fällen erfolgt die Weitergabe Ihrer Datensätze und die Überprüfung Ihrer Domain innerhalb weniger Stunden, abhängig von Ihrem Domain-Anbieter. Ausführliche Anweisungen zum Hinzufügen von TXT-Einträgen und Ausbreitungszeiten finden Sie in der Dokumentation Ihres Domain-Anbieters.

    Wenn beim Klicken auf „Überprüfen“ eine Fehlermeldung angezeigt wird, wurden Ihre Datensätze nicht weitergegeben oder Ihre Werte sind möglicherweise falsch.

Wählen Sie im Assistenten „Benutzerdefinierte Domäne hinzufügen“ der Firebase-Konsole die Option „Schnelleinrichtung “ oder „Erweiterte Einrichtung“ aus.

Die Schnelleinrichtung kann für neue Domänen verwendet werden, die derzeit keinen Datenverkehr empfangen, oder für Domänen, die Sie von einer anderen Hosting-Site übertragen möchten. Das erweiterte Setup kann verwendet werden, wenn Sie bereits über eine Domain verfügen, die Anfragen bei einem anderen Hosting-Anbieter erhält, und eine Migration ohne Ausfallzeiten benötigen.

Der Assistent für die erweiterte Einrichtung hilft Ihnen beim Einrichten eines SSL-Zertifikats und eines Eigentumsanspruchs, damit Hosting den Datenverkehr auf der Domain bereitstellen kann, bevor er Datenverkehr empfängt.

Warten Sie auf die Bereitstellung des SSL-Zertifikats

Nachdem wir den Domänenbesitz überprüft haben, stellen wir ein SSL-Zertifikat für Ihre Domäne bereit und stellen es innerhalb von 24 Stunden, nachdem Sie Ihre DNS-A-Einträge an Firebase Hosting weitergeleitet haben, in unserem globalen CDN bereit.

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

Für Benutzer des erweiterten Setups wird Ihre Website von Ihrem vorherigen Hosting-Anbieter gehostet, bis der Setup-Status auf der Firebase-Hosting-Seite Ihres Projekts auf „Verbunden“ aktualisiert wird.

Ihr benutzerdefinierter Domänenschlüssel

Beim Hinzufügen oder Bearbeiten von DNS-Einträgen erwarten verschiedene Domänenanbieter, dass Sie auf ihren DNS-Verwaltungsseiten unterschiedliche Eingaben für das Feld „Host“ eingeben. Nachfolgend haben wir allgemeine Beiträge beliebter Anbieter zusammengestellt. Ausführliche Anweisungen finden Sie in der Dokumentation Ihres Domain-Anbieters.

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

Zu den üblichen Eingaben gehören:

  • @
  • Der Apex-Domänenname (zum Beispiel example .com )
  • Lassen Sie das Feld „Host“ leer
Subdomain

Zu den üblichen Eingaben gehören:

  • Der vollständige Subdomain-Name (z. B. app. example .com )
  • Nur der Subdomain-Teil (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 Domain-Anbieter und die jeweils erforderlichen Eingabetypen aufgeführt. Diese Informationen werden so weit wie möglich auf dem neuesten Stand gehalten. Detaillierte Anweisungen finden Sie jedoch in der Dokumentation Ihres Domain-Anbieters.

Richten Sie Statusbeschreibungen für benutzerdefinierte Domänen ein

Status Beschreibung
Muss eingerichtet werden

Möglicherweise müssen Sie eine Konfiguration Ihrer DNS-Einträge ändern.

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

  • In selteneren Fällen, insbesondere wenn Sie den erweiterten Setup-Ablauf verwenden, können SSL-Herausforderungen aus folgenden Gründen fehlschlagen:

    • Ihre DNS-Einträge verfügen über A-Einträge oder CNAME-Einträge, die auf andere Hosting-Anbieter verweisen.
      Tipp zur Fehlerbehebung: Stellen Sie sicher, 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 auf Ihrer Website bereitgestellte hochgeladene Datei) 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 die Erstellung eines SSL-Zertifikats für eine benutzerdefinierte Domäne verzögern:

  • Ihre CAA-Datensätze sind zu restriktiv.
    Tipp zur Fehlerbehebung: Stellen Sie sicher, dass die Zertifizierungsstellen „letsencrypt.org“ und „pki.goog“ SSL-Zertifikate für Ihre Domain erstellen dürfen.
  • Ihr Challenge-Code ist ungültig.
    Wenn Sie den erweiterten Setup-Ablauf verwenden und die Migration fehlschlägt, ist 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 aufgrund der Beschränkungen für die Erstellung von SSL-Zertifikaten nicht mehr als 20 Subdomains auf einer benutzerdefinierten Apex-Domain.
Prägezertifikat

Für Ihre Domain wird ein SSL-Zertifikat erstellt.

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.