Benutzerdefinierte Domain verbinden

Sie müssen nicht auf Ihre einzigartigen, markenorientierten Domainnamen mit Firebase Hosting 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 weiteren Verlauf dieses Dokuments werden Sie durch die Schritte zum Verbinden Ihres benutzerdefinierten .

Domain für Hosting einrichten

Sie müssen den Einrichtungsassistenten auf der Firebase Hosting-Seite Ihres Projekts abgeschlossen haben, damit Sie eine Firebase Hosting-Website in Ihrem Firebase-Projekt haben.

Schritt 1: Benutzerdefinierte Domain hinzufügen

  1. Aus dem Hosting Seite, öffnen Sie den Assistenten zum Verbinden einer benutzerdefinierten Domain:

    • 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 Ihrer Hosting-Website verknüpfen möchten.

  3. Optional: Klicken Sie das Kästchen an, um alle Anfragen in der benutzerdefinierten Domain an eine zweite angegebene Domain (z. B. example.com und www.example.com verweisen auf denselben Inhalt).

  4. Klicken Sie auf Weiter, um die DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domain abzuschließen.

Schritt 2: Benutzerdefinierte Domain einrichten

Wenn Sie im Einrichtungsassistenten für Connect Domain (Domain verbinden) dazu aufgefordert werden, um Ihre Apex-Domain zu bestätigen.

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 den Schlüssel Ihrer Apex-Domain ein.

      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. Es kann bis zu 24 Stunden dauern, bis die aktualisierten TXT-Einträge wirksam werden. 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. Dies wirkt sich nicht auf die Weitergabe aus, Sie werden jedoch aufgefordert, Ihren Domainnamen noch einmal eingeben, wenn Sie das Fenster wieder öffnen.

    Klicken Sie anschließend im Bereich Connect Domain (Domain verbinden) auf Verify (Bestätigen). der Firebase-Konsole können Sie das SSL-Zertifikat Bereitstellungsprozess.

    In den meisten Fällen ist die Weitergabe Ihrer Einträge und die Bestätigung Ihrer Domain erfolgt je nach Domainanbieter innerhalb weniger Stunden. Weitere Informationen finden Sie unter finden Sie in der Dokumentation Ihres Domain-Anbieters. TXT-Einträge und Verbreitungszeiten.

    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 Assistenten Benutzerdefinierte Domain hinzufügen der Firebase-Konsole die Option Schnellzugriff Einrichtung oder Erweiterte Einrichtung.

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 können Sie verwenden, wenn Sie bereits eine Domain haben, die bei einem anderen Hostanbieter gestellt werden und eine Migration ohne Ausfallzeiten erfordern.

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.

Warten auf die Bereitstellung des SSL-Zertifikats

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 sich dieses Zertifikat mit den Sicherheitstools des Browsers ansehen. Während die Domain bereitgestellt wird, sehen Sie möglicherweise eine ungültige Zertifikat, das Ihren Domainnamen nicht enthält. Das ist ein normaler Teil des Prozesses und das Problem wird behoben, sobald das Zertifikat Ihrer Domain verfügbar ist.

Wenn Sie die erweiterte Einrichtung verwenden, wird Ihre Website von Ihrem bisherigen Hosting-Anbieter gehostet. bis das Einrichtungsstatus in Ihrem des Projekts Firebase Hosting Seite wird auf Verbunden aktualisiert.

Ihr benutzerdefinierter Domainschlüssel

Verschiedene Domainanbieter erwarten, dass Sie beim Hinzufügen oder Bearbeiten von DNS-Einträgen verschiedene Eingaben in das Feld Host in der DNS-Verwaltung eingeben. Websites. Im Folgenden haben wir häufige Eingaben von beliebten Anbietern zusammengestellt. Eine ausführliche Anleitung finden Sie in der Dokumentation Ihres Domainanbieters.

Domaintyp Benutzerdefinierter Domainschlüssel
Apex-Domain

Gängige Eingaben:

  • @
  • Der Top-Level-Domainname (z. B. example.com)
  • Das Feld Host leer lassen
Subdomain

Gängige Eingaben:

  • 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 Domain-Anbieter

Im Folgenden sind einige gängige Domainanbieter und die jeweils erforderlichen Eingabetypen aufgeführt. Diese Informationen werden soweit möglich aktuell gehalten, sollten sich jedoch finden Sie in der Dokumentation des Domain-Anbieters.

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 DNS-A-Einträge noch nicht weitergegeben von Ihrem Domainnamen-Anbieter zu Firebase Hosting-Servern.
    Tipp zur Fehlerbehebung: Wenn mehr als 24 Stunden vergangen sind, prüfen Sie, Sie haben Ihre Einträge auf Firebase Hosting verwiesen.

  • In seltenen Fällen, insbesondere wenn Sie die erweiterte Einrichtung verwenden SSL-Herausforderungen können aus folgenden Gründen fehlschlagen:

    • Die SSL-Zertifikatsanfragen sind fehlgeschlagen und das Token (DNS-TXT-Einträge oder hochgeladene Datei für Ihre Website) 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 korrekt eingerichtet, aber Firebase Hosting hat kein SSL-Zertifikat bereitgestellt.

Gelegentlich können die folgenden Probleme die Erstellung einer SSL-Datei verzögern Zertifikat für eine benutzerdefinierte Domain:

  • Ihre CAA-Einträge sind zu einschränkend.
    Tipp zur Fehlerbehebung: Achten Sie darauf, dass die Zertifizierungsstellen Über „letsencrypt.org“ und „pki.goog“ dürfen SSL-Zertifikate für Ihre Domain.
  • 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: Im Allgemeinen empfiehlt Firebase Hosting, dass Sie keine mehr als 20 Subdomains in einer benutzerdefinierten Apex-Domain durch SSL der Zertifikatserstellungslimits.
Minting-Zertifikat

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 die Inhalte Ihrer Website bereitstellen.