Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Verbinden Sie eine benutzerdefinierte Domäne

Mit Firebase Hosting müssen Sie Ihre eindeutigen, markenzentrierten Domain-Namen nicht aufgeben. Sie können eine benutzerdefinierte Domain (wie example.com oder app.example.com ) anstelle einer von Firebase generierten Domain für Ihre von Firebase gehostete Site verwenden.

Firebase Hosting stellt für jede Ihrer Domains ein von Let's Encrypt signiertes SSL-Zertifikat bereit und stellt Ihre Inhalte über ein globales CDN bereit.

Der Rest dieses Dokuments führt Sie durch diese Schritte, um eine Verbindung zu Ihrer benutzerdefinierten Domäne herzustellen.

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 Ihr Firebase-Projekt eine Firebase-Hosting-Site enthält.

Schritt 1 : Domain hinzufügen

  1. Geben Sie auf der Hosting-Seite Ihres Projekts den Assistenten zum Verbinden einer benutzerdefinierten Domäne ein:

    • Wenn Sie nur eine Hosting-Site haben, klicken Sie auf Domäne verbinden .
    • Wenn Sie mehr als eine Hosting-Site haben , klicken Sie auf Ansicht für die gewünschte Site und dann auf Domäne verbinden .
  2. Geben Sie den benutzerdefinierten Domainnamen ein, den Sie mit Ihrer Hosting-Site verbinden möchten.

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

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

Schritt 2 : Überprüfen Sie den Domainbesitz

Wenn im Connect - Domain - Setup - Assistenten aufgefordert, Ihre Spitze Domäne überprüfen.

Diese Schritte stellen sicher, dass Ihre Domain nicht bereits mit einem Firebase-Projekt verknüpft ist und Sie die angegebene Domain besitzen.

  1. Suchen Sie auf der Website Ihres Domain-Providers 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-Datensatz hinzu.

      Für Firebase Hosting muss dieser TXT-Eintrag in Ihren DNS-Einstellungen ständig vorhanden sein, um Ihren Besitz der Domain nachzuweisen und Firebase zu autorisieren, SSL-Zertifikate für Ihre Site zuzuweisen und zu erneuern.

      Ihr Domain-Anbieter listet diesen Begriff möglicherweise als "Datensatztyp" auf.

    • Host : Geben Sie Ihren Apex-Domain-Schlüssel ein .

      Wenn Sie nachweisen, dass Sie Eigentümer einer Apex-Domain oder Root-Domain sind, beweisen Sie, dass Sie alle Subdomains besitzen.

      Ihr Domain-Anbieter listet diesen Begriff möglicherweise als "Hostname", "Name" oder "Domain" auf.

    • Wert : Kopieren Sie den eindeutigen Überprüfungswert in das Feld.

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

      Ihr Domain-Anbieter listet diesen Begriff möglicherweise als "Daten" auf.

  3. Warten Sie bis zu 24 Stunden, bis Ihre aktualisierten TXT-Datensätze weitergegeben sind, 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 Weitergabezeit. Sie werden jedoch aufgefordert, Ihren Domainnamen erneut einzugeben, wenn Sie das Fenster erneut öffnen.

    Wenn Sie nach einer längeren Laufzeit im Fenster " Domäne verbinden" der Firebase-Konsole auf " Überprüfen" klicken, können Sie mit der Bereitstellung des SSL-Zertifikats beginnen.

    In den meisten Fällen erfolgt die Weitergabe Ihrer Datensätze und die Überprüfung Ihrer Domain je nach Domain-Anbieter innerhalb weniger Stunden. Ausführliche Anweisungen zum Hinzufügen von TXT-Datensätzen und Weitergabezeiten finden Sie in der Dokumentation Ihres Domain-Providers.

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

Schritt 3 : Gehen Sie live

Wählen Sie im Fenster " Domäne verbinden" der Firebase-Konsole die Option " Schnelleinrichtung für eine neue Site" oder " Erweiterte Einrichtung", wenn bereits eine Site auf einem anderen Hosting-Anbieter ausgeführt wird und eine Migration ohne Ausfallzeiten erforderlich ist.

Warten Sie auf die Bereitstellung des SSL-Zertifikats

Nachdem wir den Domainbesitz ü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, auf unserem globalen CDN bereit.

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

Für Benutzer mit erweitertem Setup 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 Domain-Schlüssel

Beim Hinzufügen oder Bearbeiten von DNS-Einträgen erwarten verschiedene Domänenanbieter, dass Sie auf ihren DNS-Verwaltungssites unterschiedliche Eingaben für das Feld Host eingeben. Im Folgenden haben wir allgemeine Eingaben von bekannten Anbietern zusammengestellt. Ausführliche Anweisungen finden Sie in der Dokumentation Ihres Domain-Providers.

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

Zu den allgemeinen Eingaben gehören:

  • @
  • Der Apex-Domainname (z. example .com )
  • Lassen Sie das Feld Host leer
Subdomain

Zu den allgemeinen Eingaben gehören:

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

Gemeinsame Domain-Anbieter

Hier sind einige gängige Domänenanbieter und die jeweils erforderlichen Eingabetypen aufgeführt. Diese Informationen werden so weit wie möglich auf dem neuesten Stand gehalten. Detaillierte Anweisungen finden Sie 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 mit Ihren DNS-Einträgen ä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 auf Firebase Hosting verwiesen haben.

  • In selteneren Fällen, insbesondere wenn Sie den erweiterten Setup-Ablauf verwenden, schlagen SSL-Herausforderungen möglicherweise fehl, weil:

    • Ihre DNS-Einträge verfügen über A-Einträge oder CNAME-Einträge, die auf andere Hosting-Anbieter verweisen.
      Tipp zur Fehlerbehebung: Überprüfen Sie, ob 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 Dateien, die auf Ihrer Site bereitgestellt werden) ist jetzt ungültig.
      Tipp zur Fehlerbehebung: Klicken Sie auf Ansicht für die Domäne und stellen Sie das neue Token Ihrer vorhandenen Domäne zur Verfügung.
steht aus

Sie haben Ihre benutzerdefinierte Domain 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-Datensätze sind zu restriktiv.
    Tipp zur Fehlerbehebung: Stellen Sie sicher, dass die Zertifizierungsstelle Let's Encrypt SSL-Zertifikate für Ihre Domain erstellen darf.
  • Ihr Challenge-Code ist ungültig.
    Wenn Sie den erweiterten Setup-Ablauf verwenden und die Migration fehlgeschlagen ist, sind Ihr Token (und sein Challenge-Code) jetzt ungültig.
    Tipp zur Fehlerbehebung: Klicken Sie auf Ansicht für die Domäne und stellen Sie das neue Token Ihrer vorhandenen Domäne zur Verfügung.
  • Sie haben Zertifikate für zu viele Subdomains angefordert.
    Tipp zur Fehlerbehebung: Im Allgemeinen empfiehlt Firebase Hosting aufgrund der Beschränkungen für das Prägen von SSL-Zertifikaten nicht mehr als 20 Subdomänen in einer benutzerdefinierten Apex-Domäne.
In Verbindung gebracht

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

Muss erneut überprüft werden

In Firebase müssen Sie möglicherweise Ihren Domain-Besitz manuell erneut überprüfen, wenn eine der folgenden Situationen eintritt:

  • Der TXT-Eintrag, der hinzugefügt wurde, als Sie anfänglich überprüft haben, dass Ihr Domain-Besitz geändert oder aus den DNS-Einstellungen Ihrer Domain entfernt wurde.
    • Beachten Sie, dass mehrere TXT-Einträge mit einem Google-Site-Verifikationstoken in einer einzelnen Domain zulässig sind.
    • Wir fordern, dass der TXT-Eintrag in Ihren DNS-Einstellungen ständig vorhanden ist, da dies beweist, dass Sie Eigentümer der Domain sind und uns autorisieren, SSL-Zertifikate für Ihre Site zuzuweisen und zu erneuern.
  • Der Person, die den Domänenbesitz überprüft hat, wird keine IAM-Rolle mehr zugewiesen, die die erforderliche Berechtigung zum Überprüfen des Domänenbesitzes enthält. Diese Rollen umfassen Eigentümer, Editor, Firebase-Administrator und Firebase-Entwicklungsadministrator.
Tipp zur Fehlerbehebung: Besuchen Sie die Hosting-Seite Ihres Projekts, um den erneuten Überprüfungsprozess innerhalb des angegebenen Zeitfensters (normalerweise 30 Tage) abzuschließen, damit Ihre benutzerdefinierte Domain nicht automatisch vom Firebase-Hosting getrennt wird.