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
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“ .
Geben Sie den benutzerdefinierten Domänennamen ein, den Sie mit Ihrer Hosting-Site verbinden möchten.
(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).
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.
Suchen Sie auf der Website Ihres Domain-Anbieters die DNS-Verwaltungsseite.
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.
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.
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.
Schnelle Einrichtung
Der Assistent „Benutzerdefinierte Domäne hinzufügen“ der Firebase-Konsole zeigt die erforderlichen Datensätze an, die aktualisiert werden müssen, damit Ihre Seite auf Firebase Hosting verweist. Fügen Sie mit den folgenden Eingaben Datensätze zu Ihrer Domain bei Ihrem DNS-Anbieter hinzu, entfernen Sie sie und speichern Sie sie:
Geben Sie Folgendes ein: Fügen Sie den bereitgestellten DNS-Eintrag hinzu.
Der von Ihnen angegebene Host ist die Domäne, auf der Sie Inhalte bereitstellen möchten. Diese Domäne kann eine Apex-Domäne oder eine Subdomäne sein.
Ihr Domain-Anbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.
Wert : Ordnen Sie die bereitgestellten IP-Adressen dem Wert der Datensätze zu.
Ihr Domain-Anbieter führt diesen Begriff möglicherweise als „Daten“, „Verweise auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auf.
Warten Sie, bis Ihr SSL-Zertifikat bereitgestellt ist . Dies kann bis zu 24 Stunden dauern, nachdem Sie Ihr DNS auf Firebase Hosting verwiesen haben. In den meisten Fällen erfolgt die Weitergabe Ihrer Datensätze und die Bereitstellung Ihres SSL-Zertifikats je nach Domain-Anbieter innerhalb weniger Stunden.
Erweiterte Einrichtung
Im erweiterten Einrichtungsmodus des Assistenten „Benutzerdefinierte Domäne hinzufügen“ können Sie das Hosting so konfigurieren, dass es Ihre Domäne sicher bedient, bevor Sie den Datenverkehr an die Server weiterleiten. Im Allgemeinen benötigt das Hosting drei Dinge, um den Datenverkehr auf einer Domain erfolgreich zu bedienen:
Besitzeintrag: Ein TXT-Eintrag teilt Hosting mit, welche Site auf der Domain bereitgestellt werden soll
SSL-Zertifikat: ein domänenspezifisches Zertifikat, das eine verschlüsselte Kommunikation zwischen Hosting-Servern und Endbenutzern ermöglicht
Hosting-IP-Einträge: ein oder mehrere A- und AAAA-Einträge, die alle Anfragen für die Domain an Hosting-Server weiterleiten
Das erweiterte Setup führt Sie durch die Konfiguration Ihrer Domain, damit Hosting die ersten beiden Anforderungen im Voraus erfüllen kann, sodass es bereit ist, den richtigen Inhalt bereitzustellen, bevor es Datenverkehr für Ihre Domain empfängt. Dieser Assistent stellt diesen Prozess als zweistufigen Workflow dar:
Domain vorbereiten
DNS-Eintrag(e) aktualisieren : Fügen Sie einen oder mehrere Einträge zu Ihrer Domain hinzu:
Eigentum: Ein TXT-Eintrag in der Form „hosting-site=[site_id]“.
CAA (optional): Ein Paar CAA-Datensätze, die es den Zertifizierungsstellen des Hostings ermöglichen, ein SSL-Zertifikat für Ihre Domain zu erstellen. Nur vorhanden, wenn Hosting vorhandene CAA-Datensätze erkennt, die die Bereitstellung eines Zertifikats verhindern.
SSL-Zertifikat einrichten : Der Assistent stellt eine ACME-Aufforderung bereit, mit der die Zertifizierungsstellen des Hostings ein SSL-Zertifikat für Ihre Domain erstellen. Sie können zwischen einer DNS- oder HTTP-Challenge wählen:
DNS-Herausforderung : Besuchen Sie die DNS-Verwaltungsseiten Ihres Domain-Anbieters. Fügen Sie einen TXT-Eintrag mit dem ACME-Challenge-Subdomain-Schlüssel und dem bereitgestellten Wert hinzu. Die Verbreitung Ihrer TXT-Datensätze kann bis zu 24 Stunden dauern.
HTTP-Challenge : Laden Sie die bereitgestellte Textdatei unter der angegebenen URL auf Ihre bestehende Website hoch und überprüfen Sie deren Existenz.
Das Hosting wird versuchen, die ACME-Herausforderungen selbst zu validieren, bevor es von seiner Zertifizierungsstelle eine Verifizierung anfordert. Wenn die Zertifizierungsstelle Ihre Herausforderungen aus irgendeinem Grund nicht validiert, beispielsweise aufgrund zeitweiliger Serviceprobleme. Das Hosting wird eine Reihe neuer Herausforderungen für Sie mit sich bringen. Nach erfolgreicher Überprüfung kann es einige Stunden dauern, bis Hosting ein SSL-Zertifikat bereitstellt und dessen Weitergabe zulässt.
Direkt zum Hosting
Nachdem Hosting den Besitz Ihrer Domain festgestellt und ein SSL-Zertifikat bereitgestellt hat, kehren Sie zu Ihrem DNS-Anbieter zurück und fügen DNS-A/AAAA-Einträge hinzu, um Anfragen an Hosting weiterzuleiten:
Geben Sie ein : Angeforderte DNS-A/AAAA-Einträge hinzufügen.
Host : Geben Sie Ihren benutzerdefinierten Domänenschlüssel für beide Datensätze ein.
Der von Ihnen angegebene Host ist die Domäne, auf der Sie Inhalte bereitstellen möchten. Diese Domäne kann eine Apex-Domäne oder eine Subdomäne sein. Ihr Domain-Anbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.
Wert : Weisen Sie jedem DNS-A/AAAA-Eintrag einen Wert zu, um Ihre Domain auf die angegebenen IP-Adressen zu verweisen.
Ihr Domain-Anbieter führt diesen Begriff möglicherweise als „Daten“, „Verweise auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auf.
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.
Wolkenflare
Typ
Gastgeber
Wert
Eingaben für DNS-TXT-Einträge
TXT
example .com
Verifizierungswert, der in der Firebase-Konsole bereitgestellt wird
DNS A zeichnet Eingaben auf
A
example .com
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Typ
Gastgeber
Wert
Eingaben für DNS-TXT-Einträge
TXT
example .com
Verifizierungswert, der in der Firebase-Konsole bereitgestellt wird
DNS A zeichnet Eingaben auf
A
example .com
199.36.158.100
A
www
199.36.158.100
NameCheap
Typ
Gastgeber
Wert
Eingaben für DNS-TXT-Einträge
TXT
@
Verifizierungswert, der in der Firebase-Konsole bereitgestellt wird
DNS A zeichnet Eingaben auf
A
@
199.36.158.100
A
@
199.36.158.100
Squarespace
Typ
Gastgeber
Wert
Eingaben für DNS-TXT-Einträge
TXT
@
Verifizierungswert, der in der Firebase-Konsole bereitgestellt wird
DNS A zeichnet Eingaben auf
A
@
199.36.158.100
A
www
199.36.158.100
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.
