Benutzerdefinierte Domain verbinden

Mit Firebase Hosting müssen Sie nicht auf Ihre einzigartigen, markenspezifischen Domainnamen verzichten. Sie können für Ihre von Firebase gehostete Website eine benutzerdefinierte Domain verwenden (z. B. example.com oder app.example.com) anstelle einer von Firebase generierten Domain.

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 geführt, die zum Verbinden Ihrer benutzerdefinierten Domain erforderlich sind.

Domain für Hosting einrichten

Achten Sie darauf, dass Sie den Assistenten „Erste Schritte“ 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. Rufen Sie auf der Seite Ihres Projekts, den Assistenten zum Verbinden einer benutzerdefinierten Domain auf:Hosting

    • Wenn Sie nur eine Hosting Website haben, klicken Sie auf Benutzerdefinierte Domain hinzufügen.
    • Wenn Sie mehr als eine Hosting Website haben, klicken Sie für die gewünschte Website auf Anzeigen und dann auf Benutzerdefinierte Domain hinzufügen.

  2. Geben Sie den Namen der benutzerdefinierten Domain ein, die Sie mit Ihrer Hosting Website verbinden möchten.

  3. (Optional) Aktivieren Sie das Kästchen, um alle Anfragen an die benutzerdefinierte Domain an eine zweite angegebene Domain weiterzuleiten (sodass example.com und www.example.com auf dieselben Inhalte 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 Ihre Stammdomain, wenn Sie im Einrichtungsassistenten Domain verbinden dazu aufgefordert werden.

Mit diesen Schritten wird sichergestellt, dass Ihre Domain nicht bereits mit einem Firebase-Projekt verknüpft ist und dass Sie Inhaber der angegebenen Domain sind.

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

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

    • Typ: Fügen Sie einen TXT-Eintrag hinzu.

      Firebase Hosting erfordert, dass dieser TXT-Eintrag in Ihren DNS-Einstellungen vorhanden ist, um Ihre Inhaberschaft der Domain nachzuweisen und Firebase zu autorisieren, SSL-Zertifikate für Ihre Website zuzuweisen und zu verlängern.

      Ihr Domainanbieter listet diesen Begriff möglicherweise als „Eintragstyp“ auf.

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

      Wenn Sie Ihre Inhaberschaft einer Stammdomain oder Root-Domain nachweisen, weisen Sie damit auch Ihre Inhaberschaft aller Subdomains nach.

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

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

      Firebase Hosting sucht nach diesem Wert, um Ihre Domaininhaberschaft nachzuweisen.

      Ihr Domainanbieter listet diesen Begriff möglicherweise als „Daten“ auf.

  3. Warten Sie bis zu 24 Stunden, bis die aktualisierten TXT-Einträge weitergegeben wurden, und klicken Sie dann auf Bestätigen.

    Sie können auf Abbrechen klicken, um das Fenster Domain verbinden sicher zu schließen und später wieder zu öffnen. Dies hat keine Auswirkungen auf die Weitergabezeit . Sie werden jedoch aufgefordert, Ihren Domainnamen noch einmal einzugeben, wenn Sie das Fenster wieder öffnen.

    Nach einer angemessenen Weitergabezeit können Sie im Fenster Domain verbinden der Firebase Console auf Bestätigen klicken, um die Bereitstellung des SSL-Zertifikats zu starten.

    In den meisten Fällen erfolgt die Weitergabe Ihrer Einträge und die Bestätigung Ihrer Domain je nach Domainanbieter innerhalb weniger Stunden. Eine detaillierte Anleitung zum Hinzufügen von TXT-Einträgen und zu den Weitergabezeiten finden Sie in der Dokumentation Ihres Domainanbieters.

    Wenn beim Klicken auf Bestätigen eine Fehlermeldung angezeigt wird, wurden Ihre Einträge nicht weitergegeben oder Ihre Werte sind möglicherweise falsch.

Wählen Sie im Assistenten Benutzerdefinierte Domain hinzufügen der Firebase Console Schnelleinrichtung oder Erweiterte Einrichtung aus.

Die Schnelleinrichtung 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, die Anfragen von einem anderen Hosting-Anbieter erhält, und eine Migration ohne Ausfallzeit benötigen.

Der Assistent Erweiterte Einrichtung hilft Ihnen, ein SSL-Zertifikat und einen Inhaberschaftsanspruch einzurichten, damit Hosting Traffic auf der Domain bereitstellen kann, bevor Traffic empfangen wird.

Auf die Bereitstellung des SSL-Zertifikats warten

Nachdem wir die Domaininhaberschaft bestätigt haben, stellen wir innerhalb von 24 Stunden, nachdem Sie Ihre DNS-A-Einträge auf Firebase Hosting verwiesen haben, ein SSL-Zertifikat für Ihre Domain bereit und stellen es in unserem globalen CDN bereit.

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

Für Nutzer der Erweiterten Einrichtung wird Ihre Website von Ihrem bisherigen Hosting Anbieter gehostet, bis der Einrichtungsstatus auf der Firebase Hosting Firebase Hosting Seite Ihres Projekts auf Verbunden aktualisiert wird.

Benutzerdefinierter Domain-Schlüssel

Beim Hinzufügen oder Bearbeiten von DNS-Einträgen erwarten verschiedene Domainanbieter, dass Sie unterschiedliche Eingaben für das Feld Host auf ihren DNS-Verwaltungswebsites machen. Wir haben unten häufige Eingaben von beliebten Anbietern zusammengestellt. Eine detaillierte Anleitung finden Sie in der Dokumentation Ihres Domainanbieters.

Domaintyp Benutzerdefinierter Domain-Schlüssel
Stammdomain

Häufige Eingaben sind:

  • @
  • Der Name der Stammdomain (z. B. example.com)
  • Das Feld Host leer lassen
Subdomain

Häufige Eingaben sind:

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

Häufige Domainanbieter

Hier sind einige häufige Domainanbieter und die Arten von Eingaben, die jeweils erforderlich sein können. Diese Informationen werden so weit wie möglich auf dem neuesten Stand gehalten. Eine detaillierte Anleitung 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 Domainnamen-Anbieter an die Firebase Hosting Server weitergegeben.
    Tipps zur Fehlerbehebung: Wenn bereits mehr als 24 Stunden vergangen sind, prüfen Sie, ob Sie Ihre Einträge auf Firebase Hosting verwiesen haben.

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

    • SSL-Zertifikat-Challenges sind fehlgeschlagen und das Token (DNS-TXT Einträge oder hochgeladene Datei, die Ihrer Website zur Verfügung gestellt wurde) ist jetzt ungültig.
      Tipps zur Fehlerbehebung: Klicken Sie für die Domain auf Anzeigen und geben Sie dann das neue Token für Ihre vorhandene Domain an.
Ausstehend

Sie haben Ihre benutzerdefinierte Domain korrekt eingerichtet, aber Firebase Hosting hat kein SSL-Zertifikat bereitgestellt.

Gelegentlich können die folgenden Probleme die Erstellung eines SSL Zertifikats für eine benutzerdefinierte Domain verzögern:

  • Ihre CAA-Einträge sind zu restriktiv.
    Tipps zur Fehlerbehebung: Achten Sie darauf, 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 die erweiterte Einrichtung verwenden und die Migration fehlgeschlagen ist, sind Ihr Token und der zugehörige Challenge Code jetzt ungültig.
    Tipps zur Fehlerbehebung: Klicken Sie für die Domain auf Anzeigen und geben Sie dann das neue Token für Ihre vorhandene Domain an.
  • Sie haben Zertifikate für zu viele Subdomains angefordert.
    Tipps zur Fehlerbehebung: Im Allgemeinen empfiehlt Firebase Hosting aufgrund von Beschränkungen bei der Erstellung von SSL -Zertifikaten nicht mehr als 20 Subdomains für eine benutzerdefinierte Stammdomain.
Zertifikat wird erstellt

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

Ihre benutzerdefinierte Domain hat die richtigen DNS-Einträge und ein SSL Zertifikat.
Sie können die Inhalte Ihrer Website bereitstellen.