Mit Firebase Hosting müssen Sie Ihre eindeutigen, markenorientierten Domainnamen nicht aufgeben. Sie können anstelle einer von Firebase generierten Domain eine benutzerdefinierte Domain (z. B. example.com oder app.example.com) für Ihre bei Firebase gehostete Website verwenden.
Firebase Hosting stellt für jede Ihrer Domains ein SSL-Zertifikat bereit und liefert Ihre Inhalte über ein globales CDN aus.
Im Rest dieses Dokuments werden Sie durch die Schritte zum Verbinden Ihrer benutzerdefinierten Domain geführt.
Domain für Hosting einrichten
Sie müssen den Einrichtungsassistenten auf der Firebase Hosting-Seite Ihres Projekts durchlaufen haben, damit in Ihrem Firebase-Projekt eine Firebase Hosting-Website vorhanden ist.
Schritt 1: Benutzerdefinierte Domain hinzufügen
Rufen Sie auf der Hosting-Seite Ihres Projekts den Assistenten zum Verbinden einer benutzerdefinierten Domain auf:
Wenn Sie nur eine Hosting-Website haben, klicken Sie auf Benutzerdefinierte Domain hinzufügen.
Wenn Sie mehrere Hosting-Websites haben, klicken Sie für die gewünschte Website auf Anzeigen und dann auf Benutzerdefinierte Domain hinzufügen.
Geben Sie den benutzerdefinierten Domainnamen ein, den Sie mit Ihrer Hosting-Website verknüpfen möchten.
Optional: Setzen Sie ein Häkchen, um alle Anfragen an die benutzerdefinierte Domain an eine zweite angegebene Domain weiterzuleiten, sodass example.com und www.example.com zu denselben Inhalten weiterleiten.
Klicken Sie auf Weiter, um Ihre DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domain abzuschließen.
Schritt 2: Benutzerdefinierte Domain einrichten
Bestätigen Sie im Einrichtungsassistenten Domain verbinden Ihre Top-Level-Domain, falls Sie dazu aufgefordert werden.
So stellen Sie sicher, dass Ihre Domain nicht bereits mit einem Firebase-Projekt verknüpft ist und dass Sie der Inhaber der angegebenen Domain sind.
Suchen Sie auf der Website Ihres Domainanbieters die Seite zur DNS-Verwaltung.
Fügen Sie einen neuen Datensatz mit den folgenden Eingaben hinzu und speichern Sie ihn:
Typ: Fügen Sie einen TXT-Eintrag hinzu.
Für Firebase Hosting muss dieser TXT-Eintrag ständig in Ihren DNS-Einstellungen vorhanden sein, um Ihre Inhaberschaft an der Domain nachzuweisen und Firebase zu autorisieren, SSL-Zertifikate für Ihre Website zuzuweisen und zu verlängern.
Ihr Domainanbieter führt diesen Begriff möglicherweise als „Eintragstyp“ auf.
Wenn Sie nachweisen, dass Sie Inhaber einer Enddomain oder Stammdomain sind, bestätigen Sie damit auch die Inhaberschaft aller zugehörigen Subdomains.
Ihr Domainanbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.
Wert: Kopieren Sie den eindeutigen Bestätigungswert in das Feld.
Firebase Hosting prüft diesen Wert, um Ihre Domaininhaberschaft zu bestätigen.
Möglicherweise wird dieser Begriff von Ihrem Domainanbieter als „Daten“ aufgeführt.
Warten Sie bis zu 24 Stunden, bis die aktualisierten TXT-Einträge übernommen wurden, und klicken Sie dann auf Bestätigen.
Sie können auf Abbrechen klicken, um das Fenster Domain verbinden zu schließen und es später wieder zu öffnen. Das hat keine Auswirkungen auf die Aktualisierungszeit. Wenn Sie das Fenster wieder öffnen, werden Sie jedoch aufgefordert, Ihren Domainnamen noch einmal einzugeben.
Nach ausreichender Zeit für die Weiterleitung können Sie in der Firebase-Konsole im Fenster Domain verbinden auf Überprüfen klicken, um mit der Bereitstellung des SSL-Zertifikats zu beginnen.
In den meisten Fällen werden Ihre Einträge innerhalb weniger Stunden übernommen und Ihre Domain bestätigt. Die Dauer hängt von Ihrem Domainanbieter ab. Eine ausführliche Anleitung zum Hinzufügen von TXT-Einträgen und zu den Aktualisierungszeiten finden Sie in der Dokumentation Ihres Domainanbieters.
Wenn nach dem Klicken auf Überprüfen eine Fehlermeldung angezeigt wird, wurden Ihre Einträge nicht übernommen oder Ihre Werte sind möglicherweise falsch.
Wählen Sie im Firebase-Konsolen-Assistenten Benutzerdefinierte Domain hinzufügen die Option Schnelleinrichtung oder Erweiterte Einrichtung aus.
Die Schnelle Einrichtung kann für neue Domains verwendet werden, die derzeit keinen Traffic erhalten, oder für Domains, die Sie von einer anderen Hosting-Website übertragen möchten. Die erweiterte Einrichtung kann verwendet werden, wenn Sie bereits eine Domain haben, für die Anfragen bei einem anderen Hostinganbieter eingehen, und eine Migration ohne Ausfallzeit benötigen.
Im Assistenten für die erweiterte Einrichtung können Sie ein SSL-Zertifikat und einen Anspruch auf Inhaberschaft einrichten, damit Hosting Traffic auf der Domain bereitstellen kann, bevor er Traffic empfängt.
Schnelleinrichtung
Im Firebase-Konsolen-Assistenten Benutzerdefinierte Domain hinzufügen werden die erforderlichen Einträge angezeigt, die aktualisiert werden müssen, damit Ihre Seite auf Firebase Hosting verweist. Fügen Sie mit den folgenden Eingaben Einträge zu Ihrer Domain hinzu, entfernen Sie sie und speichern Sie sie bei Ihrem DNS-Anbieter:
Typ: Fügen Sie den bereitgestellten DNS-Eintrag hinzu.
Der von Ihnen angegebene Host ist die Domain, auf der Sie Inhalte bereitstellen möchten. Diese Domain kann eine Apex-Domain oder eine Subdomain sein.
Ihr Domainanbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.
Wert: Weisen Sie den angegebenen IP-Adressen den Wert der Einträge zu.
Ihr Domainanbieter kann diesen Begriff als „Daten“, „Weist auf“ oder „Inhalt“ oder „Adresse“ oder „IP-Adresse“ angeben.
Warten Sie, bis Ihr SSL-Zertifikat bereitgestellt wurde.
Das kann bis zu 24 Stunden dauern, nachdem du dein DNS auf Firebase Hosting verweist.
In den meisten Fällen werden Ihre Einträge innerhalb weniger Stunden übernommen und Ihr SSL-Zertifikat bereitgestellt. Das hängt von Ihrem Domainanbieter ab.
Erweiterte Einrichtung
Im Einrichtungsmodus Erweitert des Assistenten Benutzerdefinierte Domain hinzufügen können Sie Hosting so konfigurieren, dass Ihre Domain sicher bereitgestellt wird, bevor Sie den Traffic an die Server weiterleiten. Im Allgemeinen benötigt Hosting drei Dinge, um Traffic auf einer Domain erfolgreich zu erfassen:
Inhaberschaftseintrag: Ein TXT-Eintrag, der Hosting mitteilt, welche Website in der Domain bereitgestellt werden soll
SSL-Zertifikat: Ein domainspezifisches Zertifikat, das die verschlüsselte Kommunikation zwischen Hosting-Servern und Endnutzern 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
Bei der erweiterten Einrichtung werden Sie durch die Konfiguration Ihrer Domain geführt. So kann Hosting die ersten beiden Anforderungen im Voraus erfüllen, damit die richtigen Inhalte ausgeliefert werden können, bevor Zugriffe auf Ihre Domain erfolgen.
Dieser Assistent stellt diesen Prozess als zweistufigen Workflow dar:
Domain vorbereiten
DNS-Einträge aktualisieren: Fügen Sie Ihrer Domain einen oder mehrere Einträge hinzu:
Inhaberschaft: Ein TXT-Eintrag vom Typ „hosting-site=[site_id]“.
CAA (optional): Ein Paar CAA-Einträge, mit denen die Zertifizierungsstellen von Hosting ein SSL-Zertifikat für Ihre Domain ausstellen können. Nur vorhanden, wenn Hosting vorhandene CAA-Einträge findet, die die Bereitstellung eines Zertifikats verhindern.
SSL-Zertifikat einrichten: Der Assistent stellt eine ACME-Herausforderung bereit, mit der die Zertifizierungsstellen von Hosting ein SSL-Zertifikat für Ihre Domain generieren. Sie können zwischen einer DNS- oder HTTP-Anfrage wählen:
DNS-Herausforderung: Rufen Sie die DNS-Verwaltungswebsites Ihres Domainanbieters auf. Fügen Sie einen TXT-Eintrag mit dem ACME-Challenge-Schlüssel für die Subdomain und dem angegebenen Wert hinzu. Es kann bis zu 24 Stunden dauern, bis Ihre TXT-Einträge übernommen werden.
HTTP-Anfrage:
Laden Sie die bereitgestellte Textdatei auf Ihre Website unter der angegebenen URL hoch und prüfen Sie, ob sie vorhanden ist.
Hosting versucht, die ACME-Herausforderungen selbst zu validieren, bevor die Bestätigung von der Zertifizierungsstelle angefordert wird. Wenn die Zertifizierungsstelle Ihre Herausforderungen aus irgendeinem Grund nicht bestätigen kann, z. B. aufgrund von sporadischen Dienstproblemen. Hosting muss dann neue Herausforderungen für Sie entwickeln. Nach der erfolgreichen Überprüfung kann es einige Stunden dauern, bis Hosting ein SSL-Zertifikat bereitgestellt und die Weiterleitung zugelassen hat.
Direkt zu Hosting
Nachdem Hosting die Inhaberschaft Ihrer Domain bestätigt und ein SSL-Zertifikat bereitgestellt hat, kehren Sie zu Ihrem DNS-Anbieter zurück und fügen Sie DNS-A/AAAA-Einträge hinzu, die Anfragen an Hosting weiterleiten:
Typ: Fügen Sie die angeforderten DNS-A/AAAA-Einträge hinzu.
Host:
Geben Sie für beide Einträge Ihren benutzerdefinierten Domainschlüssel ein.
Der von Ihnen angegebene Host ist die Domain, auf der Sie Inhalte bereitstellen möchten. Diese Domain kann eine Apex-Domain oder eine Subdomain sein. Ihr Domainanbieter 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 Domainanbieter kann diesen Begriff als „Daten“, „Ziel“, „Inhalt“, „Adresse“ oder „IP-Adresse“ angeben.
Warten auf die Bereitstellung des SSL-Zertifikats
Nachdem wir die Domaininhaberschaft bestätigt haben, stellen wir ein SSL-Zertifikat für Ihre Domain bereit und stellen es innerhalb von 24 Stunden nach dem Verknüpfen Ihrer DNS-A-Einträge mit Firebase Hosting in unserem globalen CDN bereit.
Ihre Domain wird im SSL-Zertifikat der FirebaseApp als einer der alternativen Antragstellernamen (Subject Alternative Names, SANs) aufgeführt. Sie können sich dieses Zertifikat mit den Sicherheitstools des Browsers ansehen. Während die Domain bereitgestellt wird, wird möglicherweise ein ungültiges Zertifikat angezeigt, das Ihren Domainnamen nicht enthält. Das ist ein normaler Teil des Prozesses und wird behoben, sobald das Zertifikat Ihrer Domain verfügbar ist.
Bei der erweiterten Einrichtung wird Ihre Website von Ihrem bisherigen Hostinganbieter gehostet, bis der Einrichtungsstatus auf der Seite Firebase Hosting Ihres Projekts zu Verbunden aktualisiert wird.
Schlüssel für die benutzerdefinierte Domain
Beim Hinzufügen oder Bearbeiten von DNS-Einträgen erwarten verschiedene Domainanbieter, dass Sie auf ihren DNS-Verwaltungswebsites unterschiedliche Eingaben für das Feld Host vornehmen. Unten finden Sie häufig verwendete Eingaben von beliebten Anbietern.
Eine ausführliche Anleitung finden Sie in der Dokumentation Ihres Domainanbieters.
Domaintyp
Schlüssel für benutzerdefinierte Domain
Root-Domain
Gängige Eingaben:
@
Der Top-Level-Domainname (z. B. example.com)
Lassen Sie das Feld Host leer.
Subdomain
Gängige Eingaben:
Der vollständige Name der Subdomain (z. B. app.example.com)
Nur der Subdomain-Teil (z. B. nur app, ohne .example.com)
Nur www für die Subdomain von www.example.com
Gängige Domainanbieter
Im Folgenden finden Sie einige gängige Domainanbieter und die Arten von Eingaben, die jeweils erforderlich sind.
Diese Informationen werden nach Möglichkeit auf dem neuesten Stand gehalten. Detaillierte Anleitungen finden Sie jedoch in der Dokumentation Ihres Domainanbieters.
Cloudflare
Typ
Moderator:in
Wert
Eingaben für DNS-TXT-Einträge
TXT
example.com
Bestätigungswert in der Firebase-Konsole
Eingaben für DNS-A-Einträge
A
example.com
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Typ
Moderator:in
Wert
Eingaben für DNS-TXT-Einträge
TXT
example.com
Bestätigungswert in der Firebase-Konsole
Eingaben für DNS-A-Einträge
A
example.com
199.36.158.100
A
www
199.36.158.100
NameCheap
Typ
Moderator:in
Wert
Eingaben für DNS-TXT-Einträge
TXT
@
Bestätigungswert in der Firebase-Konsole
Eingaben für DNS-A-Einträge
A
@
199.36.158.100
A
www
199.36.158.100
Squarespace
Typ
Moderator:in
Wert
Eingaben für DNS-TXT-Einträge
TXT
@
Bestätigungswert in der Firebase-Konsole
Eingaben für DNS-A-Einträge
A
@
199.36.158.100
A
www
199.36.158.100
Beschreibungen des Einrichtungsstatus für benutzerdefinierte Domains
Status
Beschreibung
Einrichtung erforderlich
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 übertragen.
Tipp zur Fehlerbehebung: Wenn mehr als 24 Stunden vergangen sind, prüfen Sie, ob Sie Ihre Einträge auf Firebase Hosting verweisen.
In selteneren Fällen, insbesondere wenn Sie die erweiterte Einrichtung verwenden, schlagen SSL-Herausforderungen möglicherweise aus folgenden Gründen fehl:
Die SSL-Zertifikatsanfragen sind fehlgeschlagen und das Token (DNS-TXT-Einträge oder hochgeladene Datei für Ihre Website) ist jetzt ungültig.
Troubleshooting tip: Click View for the domain,
then provide the new token to your existing domain.
Ausstehend
Sie haben Ihre benutzerdefinierte Domain richtig eingerichtet, aber Firebase Hosting hat kein SSL-Zertifikat bereitgestellt.
Gelegentlich können die folgenden Probleme das Erstellen eines SSL-Zertifikats für eine benutzerdefinierte Domain verzögern:
Ihre CAA-Einträge sind zu einschränkend.
Tipp zur Fehlerbehebung: Achten Sie darauf, dass die Zertifizierungsstellen „letsencrypt.org“ und „pki.goog“ berechtigt sind, SSL-Zertifikate für Ihre Domain zu erstellen.
Ihr Bestätigungscode ist ungültig. Wenn Sie die erweiterte Einrichtung verwenden und die Migration fehlgeschlagen ist, sind Ihr Token und sein Bestätigungscode jetzt ungültig.
Tipp zur Fehlerbehebung: Klicken Sie für die Domain auf Anzeigen und geben Sie dann das neue Token für Ihre bestehende Domain an.
Sie haben Zertifikate für zu viele Subdomains angefordert.
Tipp zur Fehlerbehebung: Firebase Hosting empfiehlt in der Regel nicht mehr als 20 Subdomains für eine benutzerdefinierte Apex-Domain, da die Anzahl der generierten SSL-Zertifikate begrenzt ist.
Zertifikat für die Erstellung
Es wird ein SSL-Zertifikat für Ihre Domain erstellt.
Verbunden
Ihre benutzerdefinierte Domain hat die richtigen DNS-Einträge und ein SSL-Zertifikat.
Sie können den Inhalt Ihrer Website bereitstellen.