Catch up on everthing we announced at this year's Firebase Summit. Learn more

Verbinden Sie eine benutzerdefinierte Domain

Mit Firebase Hosting müssen Sie nicht auf Ihre einzigartigen, markenorientierten Domainnamen verzichten. Sie können eine eigene Domain (wie verwenden example.com oder app.example.com ) anstelle eine Firebase-generierte Domain für Ihre Firebase-Website gehostet.

Firebase Hosting stellt für jede Ihrer Domains ein SSL-Zertifikat 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 die von Ihrem Projekt „Get Started“ Assistenten abgeschlossen haben Firebase Hosting - Seite , so dass Sie eine Firebase Hosting - Site in Ihrem Firebase Projekt.

Schritt 1: Add Domain

  1. Von Ihrem Projekt -Hosting - Seite , geben Sie den Assistenten für eine benutzerdefinierte Domain verbinden:

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

  3. (Optional) überprüfen Sie die Box alle Anforderungen auf der benutzerdefinierten Domain zu einer zweiten bestimmten Domäne (so dass die Umleitung example.com und www.example.com Umleitung auf den gleichen Inhalt).

  4. Klicken Sie auf Weiter den Validierungsprozess zu initiieren.

Schritt 2: Überprüfen Domain - Inhaberschaft

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 dass Sie der Eigentümer der angegebenen Domain sind.

  1. Suchen Sie auf der Website Ihres Domainanbieters die Seite zur DNS-Verwaltung.

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

    • Typ: TXT - Datensatz hinzufügen.

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

      Ihr Domain-Provider führt diesen Begriff möglicherweise als "Datensatztyp" auf.

    • Host: Geben Sie Ihre Apex - Domain - Key .

      Der Nachweis Ihres Eigentums an einer Apex-Domain oder Root-Domain beweist, dass Sie alle Subdomains besitzen.

      Ihr Domainanbieter führt diesen Begriff möglicherweise als "Hostname", "Name" oder "Domain" auf.

    • Wert: Kopieren Sie die einmalige Prüfwert in das Feld.

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

      Ihr Domain-Provider führt diesen Begriff möglicherweise als "Daten" auf.

  3. Es kann bis zu 24 Stunden für die Vermehrung des aktualisierten TXT - Datensätze, klicken Sie auf Überprüfen.

    Beachten Sie, dass Sie sicher zu schließen Connect Domain Fenster auf Abbrechen klicken können und zu einem späteren Zeitpunkt wieder öffnen. Dies gilt nicht , die Laufzeit beeinflussen, aber Sie werden dazu aufgefordert werden , erneut eingeben Ihren Domain - Namen , wenn Sie das Fenster wieder zu öffnen.

    Nach ausreichender Laufzeit im Connect - Domain - Fenster Verify Klicken der Firebase Konsole können Sie das SSL - Zertifikat Provisioning - Prozess beginnen.

    In den meisten Fällen erfolgt die Verbreitung Ihrer Datensätze und die Verifizierung Ihrer Domain je nach Domain-Anbieter innerhalb weniger Stunden. Ausführliche Anweisungen zum Hinzufügen von TXT-Einträgen und Laufzeiten finden Sie in der Dokumentation Ihres Domainanbieters.

    Wenn das Klicken auf eine Fehlermeldung Überprüfen Aufforderungen, haben Ihre Unterlagen nicht weitergegeben oder Ihre Werte falsch sein.

Schritt 3: Go Live

Im Connect Domain Fenster der Konsole Firebase, wählen Sie Quick Setup für einen neuen Standort oder Advanced Setup , wenn Sie bereits eine Website auf einem anderen Hosting - Provider laufen haben und brauchen eine Null-Ausfallzeiten Migration.

Warten Sie 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, nachdem Sie Ihre DNS-A-Einträge an Firebase Hosting weitergeleitet haben, in unserem globalen CDN bereit.

Ihre Domain 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, 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 Domain verfügbar ist.

Für Advanced Setup - Benutzer, wird Ihre Website von Ihrem bisherigen Hosting - Anbieter bis zum gehostet werden Rüstzustand in Ihrem Projekt Firebase Hosting Seite Updates zu Connected.

Ihr benutzerdefinierter Domainschlüssel

Beim Hinzufügen oder Bearbeiten von DNS - Einträgen, verschiedene Domain - Anbieter erwarten , dass Sie in ihrem DNS - Management - Websites unterschiedliche Eingänge für das Host - Feld eingeben. Wir haben unten allgemeine Eingaben von beliebten Anbietern zusammengestellt. Ausführliche Anweisungen finden Sie in der Dokumentation Ihres Domainanbieters.

Domaintyp Benutzerdefinierter Domänenschlüssel
Apex-Domain

Zu den allgemeinen Eingaben gehören:

  • @
  • Der Scheiteldomänennamen (zum Beispiel example .com )
  • Beim Verlassen des Host - Feld leer
Unterdomäne

Zu den allgemeinen Eingaben gehören:

  • Der vollständige Subdomainnamen (zB app. example .com )
  • Nur der Sub - Domain Teil (zB app nur, und das Weglassen . example .com )
  • Nur www für die Sub - Domain von www. example .com

Gängige Domain-Anbieter

Hier sind einige gängige Domain-Anbieter und die Arten von Eingaben, die für jeden erforderlich sein könnten. Diese Informationen werden so weit wie möglich auf dem neuesten Stand gehalten. Detaillierte Anweisungen finden Sie jedoch in der Dokumentation Ihres Domain-Anbieters.

Statusbeschreibungen für benutzerdefinierte Domains einrichten

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 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 Setup-Flow verwenden, können SSL-Herausforderungen aus folgenden Gründen fehlschlagen:

    • Ihre DNS-Einträge haben 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-Datensätze oder hochgeladene Datei, die auf Ihrer Website bereitgestellt wurde) ist jetzt ungültig.
      Fehlerbehebung Tipp: Klicken Sie auf die Domain, dann bieten die neuen Token zu Ihrer bestehenden Domain.
Ausstehend

Sie haben Ihre benutzerdefinierte Domain richtig 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 Domain blockieren:

  • 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-Flow verwenden und die Migration fehlgeschlagen ist, sind Ihr Token (und sein Challenge-Code) jetzt ungültig.
    Fehlerbehebung Tipp: Klicken Sie auf die Domain, dann bieten die neuen Token zu Ihrer bestehenden Domain.
  • 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 Subdomains in einer benutzerdefinierten Apex-Domain.
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.

Erfordert erneute Überprüfung

Firebase verlangt möglicherweise, dass Sie Ihre Domain-Inhaberschaft erneut manuell bestätigen, wenn eine der folgenden Situationen eintritt:

  • Der TXT - Eintrag hinzugefügt , wenn Sie zunächst Ihre Domain - Inhaberschaft überprüft geändert oder von Ihrer Domain DNS - Einstellungen entfernt wurde.
    • Beachten Sie, dass mehrere TXT-Einträge mit einem Google-Site-Bestätigungstoken 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 der Inhaber der Domain sind und uns ermächtigen, SSL-Zertifikate für Ihre Site zuzuweisen und zu erneuern.
  • Die Person , die Domain - Inhaberschaft überprüft wird nicht mehr eine zugewiesene IAM Rolle , die die erforderliche Berechtigung enthält Domain - Inhaberschaft zu überprüfen. Zu diesen Rollen gehören Inhaber, Bearbeiter, Firebase-Administrator und Firebase-Entwickleradministrator.
Fehlerbehebung Tipp: Besuchen Sie Ihre Projekt - Hosting - Seite den Wiederverifikationsprozess innerhalb des vorgegebenen Zeitfensters zu beenden ( in der Regel 30 Tage) Ihre benutzerdefinierte Domain zu vermeiden , automatisch von Firebase Hosting getrennt wurde.