Benutzerdefinierte Domain verbinden

Sie müssen Ihre eindeutigen, markenorientierten Domainnamen für Anwendungen, die unter Firebase App Hosting bereitgestellt werden, 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 von Firebase gehostete Website verwenden. Firebase App Hosting stellt für jede Ihrer Domains ein SSL-Zertifikat bereit.

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

Domain für App Hosting einrichten

Sie müssen die grundlegenden App HostingEinrichtungsaufgaben abgeschlossen haben, damit Sie eine Firebase App Hosting-Website in Ihrem Firebase-Projekt haben.

Schritt 1: Benutzerdefinierte Domain hinzufügen

  1. Öffnen Sie die App Hosting-Seite Ihres Projekts.
  2. Wählen Sie über die Option Dashboard ansehen ein App Hosting-Backend aus.
  3. Klicken Sie auf den Tab Einstellungen und dann auf Benutzerdefinierte Domain hinzufügen.
  4. Geben Sie den benutzerdefinierten Domainnamen ein, den Sie mit Ihrer App Hosting-Website verbinden möchten.
  5. 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.
  6. Klicken Sie auf Weiter, um Ihre DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domain abzuschließen.

Schritt 2: Benutzerdefinierte Domain einrichten

  1. Der Assistent Benutzerdefinierte Domain hinzufügen der Firebase Console zeigt die erforderlichen Datensätze an, die aktualisiert werden müssen, damit Ihre Seite auf Firebase App Hosting verweist. Fügen Sie mit den folgenden Eingaben Einträge zu Ihrer Domain hinzu, entfernen Sie sie und speichern Sie sie bei Ihrem DNS-Anbieter:

    • Typ: Fügen Sie den bereitgestellten DNS-Eintrag hinzu.
    • Host: Geben Sie den benutzerdefinierten Domainschlüssel für die Einträge ein. Bei dem von Ihnen angegebenen Host handelt es sich um die Domain, auf der Sie Inhalte bereitstellen möchten. Diese Domain kann eine Apex-Domain oder Subdomain sein. Ihr Domainanbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.

    • Wert: Weisen Sie Ihren Datensätzen den angegebenen Wert zu. Ihr Domainanbieter kann diesen Begriff als „Daten“, „Weist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ angeben. Der Inhalt des Wertfelds variiert je nach Eintragstyp. A- und AAAA-Einträge haben IP-Adressen als Werte, während TXT-Einträge Strings sind.

Warten Sie, bis Ihr SSL-Zertifikat bereitgestellt wurde. Das dauert in der Regel einige Stunden, kann aber gelegentlich bis zu 24 Stunden dauern, nachdem Sie Ihr DNS auf Firebase App Hosting verweisen. In den meisten Fällen werden Ihre Einträge und Ihr SSL-Zertifikat innerhalb einer Stunde bereitgestellt, je nach Domainanbieter.

Warten auf die Bereitstellung des SSL-Zertifikats

App Hosting Es kann einige Stunden dauern, bis ein SSL-Zertifikat für Ihre Domain bereitgestellt wird, nachdem Sie Ihre DNS-Einträge aktualisiert haben. In einigen Fällen kann es bis zu 24 Stunden dauern, nachdem Sie Ihr DNS auf Firebase App Hosting verweisen.

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 oder Sie haben Probleme beim Verbinden mit Ihrer Domain. Das ist ein normaler Teil des Prozesses und das Problem wird behoben, sobald das Zertifikat Ihrer Domain verfügbar ist.

Hinweis:Mit Firebase App Hosting werden SSL-Zertifikate für benutzerdefinierte Domains bei Bedarf automatisch neu bereitgestellt.

DNS-Eintragstypen

Im App Hosting-Assistenten für benutzerdefinierte Domains werden Sie möglicherweise aufgefordert, je nach aktueller Konfiguration Ihrer Domain ein bis fünf DNS-Einträge hinzuzufügen. Der Typ eines Eintrags bestimmt seine Funktion. App Hosting kann nach den folgenden Datentypen fragen:

Typ Beschreibung Exklusiv
A Diese Einträge enthalten IPv4-Werte (z. B. 8.8.8.8), die Browsern mitteilen, welche Adresse beim Versuch, Ihre Domain zu kontaktieren, verwendet werden soll. Ja
AAAA Diese Einträge enthalten IPv6-Werte (z. B. 2001:4860:4860::8888), eine andere Art von Adresseintrag mit ungefähr derselben Funktion wie A-Einträge. App Hosting verwendet derzeit keine AAAA-Einträge. Wir bitten Sie jedoch, vorhandene Einträge aus unserer Domain zu entfernen, falls vorhanden. Ja
CNAME Diese Einträge enthalten einen separaten Domainnamen, der anstelle Ihrer aktuellen Domain verwendet werden sollte, um DNS-Abfragen zu lösen. CNAME-Einträge sind nur für Subdomains zulässig (z. B. www.beispiel.de). App Hosting verwendet CNAME-Einträge aus zwei Gründen:
  • Einfache Einrichtung: Sofern möglich, werden Sie von App Hosting aufgefordert, einen CNAME-Eintrag für eine vorab konfigurierte Domain zu erstellen, die mit _custom-domain... beginnt.
  • SSL-Zertifikatprüfung: App Hosting verwendet Cloud Certificate Manager, um SSL-Zertifikate für Ihre benutzerdefinierte Domain bereitzustellen. Mit einem CNAME-Eintrag in einer _acme-challenge...-Subdomain kann Certificate Manager Zertifikate für Sie erstellen und verlängern. Nach dem Onboarding darf dieser Eintrag nicht entfernt werden. Andernfalls erlischt die Zertifikatsabdeckung.
Ja
TXT Mit diesen Einträgen können Sie Ihrer Domain beliebige Metadaten zuordnen. Mit App Hosting können Sie ein bestimmtes Format für TXT-Einträge (fah-claim=[UUID]) verwenden, um anzugeben, für welche benutzerdefinierte Domain er in Ihrer Domain verwendet werden soll. Nein
CAA Diese Einträge dienen als Zulassungsliste für Zertifizierungsstellen, die berechtigt sind, SSL-Zertifikate für Ihre Domain auszustellen. App Hosting fordert nur dann CAA-Einträge an, wenn das Erstellen von Zertifikaten für Ihre Domain andernfalls blockiert ist. Nein

Schlüssel für die benutzerdefinierte Domain

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 eingeben. Unten finden Sie häufig verwendete Eingaben von beliebten Anbietern. Eine ausführliche Anleitung finden Sie in der Dokumentation Ihres Domainanbieters.

Domaintyp Benutzerdefinierter Domainschlüssel
Root-Domain

Gängige Eingaben:

  • @
  • Der Enddomainname (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)

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. Eine detaillierte Anleitung finden Sie in der Dokumentation Ihres Domainanbieters.

Statusbeschreibungen 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 App Hosting-Server übertragen.
    Tipp zur Fehlerbehebung: Wenn mehr als 24 Stunden vergangen sind, prüfen Sie, ob Sie Ihre Einträge auf Firebase App Hosting verweisen.

  • In seltenen Fällen können SSL-Herausforderungen fehlschlagen, da Ihre DNS-Einträge A- oder CNAME-Einträge enthalten, die auf andere Hostanbieter verweisen.
    Tipp zur Fehlerbehebung: Prüfen Sie, ob Ihre A-Einträge nur auf Firebase App Hosting verweisen, und entfernen Sie alle CNAME-Einträge.

Ausstehend

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

Gelegentlich können übermäßig restriktive CAA-Einträge die Erstellung eines SSL-Zertifikats für eine benutzerdefinierte Domain verzögern. Die Zertifizierungsstellen „letsencrypt.org“ und „pki.goog“ müssen berechtigt sein, SSL-Zertifikate für Ihre Domain zu erstellen.

Minting-Zertifikat

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 den Inhalt Ihrer Website bereitstellen.