Benutzerdefinierte Domain verbinden

Mit Firebase Hosting müssen Sie Ihre eindeutigen, markenorientierten Domainnamen nicht aufgeben. Sie können eine benutzerdefinierte Domain wie example.com oder app.example.com) statt einer von Firebase generierten Domain für Ihr Von Firebase gehostete Website.

Firebase Hosting stellt für jede Ihrer Domains ein SSL-Zertifikat bereit und stellt Ihre Inhalte über ein globales CDN bereit.

Im Rest dieses Dokuments werden Sie durch die Schritte zum Verbinden Ihrer benutzerdefinierten Domain geführt.

Domain für Hosting einrichten

Vergewissern Sie sich, dass Sie den Abschnitt "Erste Schritte" Assistenten aus der Firebase Hosting Seite sodass in Ihrem Firebase-Projekt eine Firebase Hosting-Website vorhanden ist.

Schritt 1: Benutzerdefinierte Domain hinzufügen

  1. 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 auf Klicken Sie für die gewünschte Website auf Anzeigen und dann auf Benutzerdefinierte Domain hinzufügen.

  2. Geben Sie den benutzerdefinierten Domainnamen ein, den Sie mit Ihrem Hosting verbinden möchten Website.

  3. 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.

  4. 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.

Durch diese Schritte wird sichergestellt, dass Ihre Domain nicht bereits mit einem Firebase-Projekt erstellen und dass Sie der Inhaber der angegebenen Domain sind.

  1. Gehen Sie auf der Website Ihres Domainanbieters zur Seite für die DNS-Verwaltung.

  2. 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 Domain-Anbieter gibt diesen Begriff möglicherweise als „Record Type“ (Eintragstyp) an.

    • Host: Geben Sie Ihren apex-Domainschlüssel.

      Wenn Sie die Inhaberschaft einer Apex-Domain oder Stammdomain nachweisen, Eigentumsrechte an allen zugehörigen Sub-Domains.

      Ihr Domainanbieter gibt diesen Begriff möglicherweise als "Hostname", "Name", oder „Domain“.

    • Wert: Kopieren Sie den eindeutigen Bestätigungswert in das Feld.

      Firebase Hosting prüft diesen Wert, um Ihre Domaininhaberschaft zu bestätigen.

      Ihr Domainanbieter führt diesen Begriff möglicherweise als „Daten“ auf.

  3. 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 Cancel (Abbrechen) klicken, um Connect Domain (Domain verbinden) sicher zu schließen. zu einem späteren Zeitpunkt erneut ö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. Weitere Informationen finden Sie unter finden Sie in der Dokumentation Ihres Domain-Anbieters. TXT-Einträge und Verbreitungszeiten.

    Wenn beim Klicken auf Verify (Bestätigen) eine Fehlermeldung angezeigt wird, wurden Ihre Einträge nicht weitergegeben wurden oder Ihre Werte falsch sind.

Wählen Sie in der Firebase-Konsole im Assistenten Benutzerdefinierte Domain hinzufügen die Option Schnelleinrichtung oder Erweiterte Einrichtung aus.

Die Schnelleinrichtung kann für neue Domains verwendet werden, die derzeit keine Traffic oder Domains, die Sie von einem anderen Hosting übertragen möchten Website. 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.

Der Assistent Erweiterte Einrichtung unterstützt Sie bei der Einrichtung eines SSL-Zertifikats und Anspruch auf Inhaberschaft, damit Hosting Traffic in der Domain bereitstellen kann, bevor Traffic zu empfangen.

Auf Bereitstellung von SSL-Zertifikaten warten

Nach der Bestätigung der Domain-Inhaberschaft stellen wir ein SSL-Zertifikat für Ihr und innerhalb von 24 Stunden, nachdem Sie Ihren DNS-A-Einträge an Firebase Hosting.

Ihre Domain wird als einer der alternativen Antragstellernamen (Subject Alternative Names, SANs) in der FirebaseApp-SSL-Zertifikat. Sie können dieses Zertifikat über die Sicherheitstools. Während die Domain bereitgestellt wird, sehen Sie möglicherweise eine ungültige Zertifikat, das Ihren Domainnamen nicht enthält. Das ist ganz normal und wird aufgelöst, 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.

Ihr benutzerdefinierter Domainschlüssel

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
Apex-Domain

Zu den gängigen Eingaben gehören:

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

Zu den gängigen Eingaben gehören:

  • Der vollständige Subdomainname (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.

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 seltenen Fällen, insbesondere wenn Sie die erweiterte Einrichtung verwenden SSL-Herausforderungen können aus folgenden Gründen fehlschlagen:

    • Die SSL-Zertifikatsherausforderungen sind fehlgeschlagen und das Token (DNS-TXT) Datensätze oder hochgeladen -Datei) ist jetzt ungültig.
      Tipp zur Fehlerbehebung: Klicken Sie für die Domain auf Anzeigen. und stellen Sie dann das neue Token für Ihre vorhandene Domain bereit.
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 restriktiv.
    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 stellen Sie dann das neue Token für Ihre vorhandene Domain bereit.
  • Sie haben Zertifikate für zu viele Subdomains angefordert.
    Tipp zur Fehlerbehebung: Im Allgemeinen empfiehlt Firebase Hosting, dass Sie keine mehr als 20 Subdomains in einer benutzerdefinierten Apex-Domain durch SSL der Zertifikatserstellungslimits.
Zertifikat wird erstellt

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

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