Benutzerdefinierte Domain verbinden

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

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

Domain für Hosting einrichten

Sie müssen den Einrichtungsassistenten auf der Firebase Hosting-Seite Ihres Projekts durchlaufen haben, damit 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 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: 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.

So stellen Sie sicher, dass Ihre Domain nicht bereits mit einem Firebase-Projekt verknüpft ist und dass Sie der Inhaber 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: 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 Domainanbieter führt diesen Begriff möglicherweise als „Eintragstyp“ auf.

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

      Wenn Sie nachweisen, dass Sie Inhaber einer Enddomain oder Stammdomain sind, bestätigen Sie damit auch die Inhaberschaft aller zugehörigen Subdomains.

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

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

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

      Möglicherweise wird dieser Begriff von Ihrem Domainanbieter als „Daten“ aufgeführt.

  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 Abbrechen klicken, um das Fenster Domain verbinden zu schließen und es später wieder zu ö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. Eine ausführliche Anleitung zum Hinzufügen von TXT-Einträgen und zu den Aktualisierungszeiten finden Sie in der Dokumentation Ihres Domainanbieters.

    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 Firebase-Konsolen-Assistenten Benutzerdefinierte Domain hinzufügen die Option Schnelleinrichtung oder Erweiterte Einrichtung aus.

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

Im Assistenten für die erweiterte Einrichtung können Sie ein SSL-Zertifikat und einen Anspruch auf Inhaberschaft einrichten, damit Hosting Traffic auf der Domain bereitstellen kann, bevor er Traffic empfängt.

Warten 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 nach dem Verknüpfen Ihrer DNS-A-Einträge mit Firebase Hosting in unserem globalen CDN bereit.

Ihre Domain wird im SSL-Zertifikat der FirebaseApp als einer der alternativen Antragstellernamen (Subject Alternative Names, SANs) aufgeführt. Sie können sich dieses Zertifikat mit den Sicherheitstools des Browsers ansehen. Während die Domain bereitgestellt wird, wird möglicherweise ein ungültiges Zertifikat angezeigt, das Ihren Domainnamen nicht enthält. Das ist ein normaler Teil des Prozesses und wird behoben, 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.

Schlüssel für die benutzerdefinierte Domain

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

Gängige Eingaben:

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

Gängige Eingaben:

  • Der vollständige Name der Subdomain (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 selteneren Fällen, insbesondere wenn Sie die erweiterte Einrichtung verwenden, schlagen SSL-Herausforderungen möglicherweise aus folgenden Gründen fehl:

    • Die SSL-Zertifikatsanfragen sind fehlgeschlagen und das Token (DNS-TXT-Einträge oder hochgeladene Datei für Ihre Website) ist jetzt ungültig.
      Troubleshooting tip: Click View for the domain, then provide the new token to your existing domain.
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 einschränkend.
    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 geben Sie dann das neue Token für Ihre bestehende Domain an.
  • Sie haben Zertifikate für zu viele Subdomains angefordert.
    Tipp zur Fehlerbehebung: Firebase Hosting empfiehlt in der Regel nicht mehr als 20 Subdomains für eine benutzerdefinierte Apex-Domain, da die Anzahl der generierten SSL-Zertifikate begrenzt ist.
Zertifikat für die Erstellung

Es wird ein SSL-Zertifikat für Ihre Domain erstellt.

Verbunden

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