Benutzerdefinierte Domain verbinden

Sie müssen Ihre eindeutigen, markenbezogenen Domainnamen für Anwendungen, die in Firebase App Hosting bereitgestellt werden, nicht aufgeben. Sie können für Ihre von Firebase gehostete Website eine benutzerdefinierte Domain (z. B. example.com oder app.example.com) anstelle einer von Firebase generierten Domain verwenden. Firebase App Hosting stellt für jede Ihrer Domains ein SSL-Zertifikat bereit.

Im weiteren Verlauf dieses Dokuments werden die Schritte zum Verbinden einer benutzerdefinierten Domain auf eine der folgenden Arten beschrieben:

Damit der Dienst nicht unterbrochen wird, müssen die DNS-Einträge in einer bestimmten Reihenfolge aktualisiert werden. Folgen Sie der Anleitung unter Domain migrieren, um Ausfallzeiten für Ihre App zu vermeiden.

Wenn Ausfallzeiten kein Problem sind, z. B. wenn Sie eine Domain verbinden, die neu für Ihre Webanwendung ist, folgen Sie der Anleitung zum Verbinden einer neuen Domain.

Vorbereitung: DNS-Eintragstypen

Der App Hosting-Assistent Domain einrichten fordert Sie möglicherweise auf, je nach aktueller Konfiguration Ihrer Domain 1 bis 5 DNS-Einträge hinzuzufügen oder zu entfernen. Der Typ eines A-Eintrags bestimmt seine Funktion. App Hosting kann die folgenden Arten von Datensätzen anfordern:

Typ Beschreibung Exklusiv
A Diese Einträge enthalten IPv4-Werte (z.B. 8.8.8.8), die Browsern mitteilen, welche Adresse sie verwenden sollen, wenn sie versuchen, Ihre Domain zu kontaktieren. 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, fordert Sie aber auf, vorhandene AAAA-Einträge aus Ihrer Domain zu entfernen. Ja
CNAME Diese Einträge enthalten einen separaten Domainnamen, der anstelle Ihrer aktuellen Domain zum Auflösen von DNS-Abfragen verwendet werden soll. 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:
  • Einfaches Onboarding: Wenn möglich, werden Sie von App Hosting aufgefordert, einen CNAME-Eintrag für eine vorkonfigurierte Domain zu erstellen, die mit _custom-domain... beginnt.
  • SSL-Zertifikatsprüfung: App Hosting verwendet den Cloud-Zertifikatmanager, um SSL-Zertifikate für Ihre benutzerdefinierte Domain bereitzustellen. Mit einem CNAME-Eintrag in einer _acme-challenge...-Subdomain kann der Zertifikatmanager Zertifikate für Sie erstellen und verlängern. Nach dem Onboarding darf dieser Eintrag nicht entfernt werden, da sonst die Zertifikatsabdeckung erlischt.
Ja
TXT Mit diesen Einträgen können Sie Ihrer Domain beliebige Metadaten hinzufügen. Mit App Hosting können Sie ein bestimmtes Format des TXT-Eintrags (fah-claim=[UUID]) verwenden, um anzugeben, welche benutzerdefinierte Domain auf Ihrer Domain bereitgestellt werden soll. Nein
CAA Diese Einträge fungieren als Zulassungsliste, um Zertifizierungsstellen anzugeben, die berechtigt sind, SSL-Zertifikate für Ihre Domain zu erstellen. App Hosting fordert nur dann CAA-Einträge an, wenn es anderweitig daran gehindert wird, Zertifikate für Ihre Domain zu erstellen. Nein

Vorbereitung: Ihr benutzerdefinierter Domainname

Wenn Sie DNS-Einträge hinzufügen oder bearbeiten, erwarten verschiedene Domainanbieter unterschiedliche Eingaben für das Feld Host (oder Hostname) auf ihren DNS-Verwaltungswebsites. Im Assistenten für benutzerdefinierte Domains von App Hosting müssen Sie denselben Wert in das Feld Name eingeben.

Unten finden Sie gängige Eingaben von beliebten Anbietern. Eine ausführliche Anleitung finden Sie in der Dokumentation Ihres Domainanbieters.

Domaintyp Name der benutzerdefinierten Domain
Apex-Domain

Zu den gängigen Eingaben gehören:

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

Gängige Domainanbieter

Hier sind einige gängige 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 in der Dokumentation Ihres Domainanbieters.

Domain migrieren

Wenn Sie Ihre Domain ohne Ausfallzeiten von einem anderen Anbieter zu App Hosting übertragen möchten, können Sie den Ablauf Domain migrieren in der Firebase-Konsole verwenden. Dieser Ablauf führt Sie durch einen zweistufigen Prozess, bei dem App Hosting darauf vorbereitet wird, Inhalte auf Ihrer Domain bereitzustellen, bevor Traffic an App Hosting-Server weitergeleitet wird.

Schritt 1: Benutzerdefinierte Domain hinzufügen

  1. Rufen Sie in der Firebase-Konsole Hosting und serverlos > App Hosting auf.
  2. Wählen Sie mit der Option Dashboard ansehen ein App Hosting-Backend aus.
  3. Wählen Sie den Tab Einstellungen aus und klicken Sie 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: Klicken Sie das Kästchen an, um alle Anfragen an die benutzerdefinierte Domain an eine zweite angegebene Domain weiterzuleiten, sodass example.com und www.example.com an denselben Inhalt weitergeleitet werden.
  6. Klicken Sie auf Weiter zur Einrichtung, um Ihre DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domain abzuschließen.

Schritt 2: Domain vorbereiten

  1. Wählen Sie im Assistenten Domain einrichten den Tab Domain migrieren aus.
  2. Folgen Sie der Anleitung im ersten Schritt, Domain vorbereiten. Dazu gehören die Änderungen, die erforderlich sind, damit App Hosting Ihr bevorzugtes Backend bereitstellen und sichere TLS-Verbindungen für Ihre Domain herstellen kann. Fügen Sie Einträge für Ihre Domain bei Ihrem DNS-Anbieter hinzu, entfernen Sie sie und speichern Sie sie mit den folgenden Eingaben für die erforderlichen Einträge:
    • Name: Geben Sie den benutzerdefinierten Domainnamen für die Einträge ein. Der von Ihnen angegebene Host ist die Domain, auf der Sie Inhalte bereitstellen möchten. Diese Domain kann eine Apex-Domain oder eine Subdomain sein. Ihr Domainanbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.
    • Eintragstyp: Fügen Sie den bereitgestellten DNS-Eintrag hinzu.
    • Wert: Weisen Sie Ihren Datensätzen den angegebenen Wert zu. Ihr Domainanbieter führt diesen Begriff möglicherweise als „Daten“, „Verweist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auf. Der Inhalt des Wertfelds variiert je nach Eintragstyp. TXT-Einträge sind beispielsweise Strings.
  3. Wählen Sie Einträge bestätigen aus. App Hosting versucht, die Änderungen zu erkennen, die Sie bei Ihrem Domainanbieter vorgenommen haben. Es kann bis zu 24 Stunden dauern, bis die Änderungen wirksam werden. Den Status können Sie im Backend-Dashboard unter Einstellungen > Domains einsehen.

Schritt 3: Weiterleitung zu App Hosting

  1. Nachdem App Hosting die Eintragsaktualisierungen aus dem vorherigen Schritt überprüft hat, geht der Assistent zum letzten Schritt An App Hosting weiterleiten über. In diesem Schritt werden die Eintragsaktualisierungen angezeigt, die Sie vornehmen müssen, um den Traffic Ihrer Domain an App Hosting-Server weiterzuleiten. Fügen Sie wie zuvor Einträge Ihrer Domain bei Ihrem DNS-Anbieter hinzu, entfernen Sie sie und speichern Sie sie mit den folgenden Eingaben für die erforderlichen Einträge:
    • Name: Geben Sie den benutzerdefinierten Domainnamen für die Einträge ein. Der von Ihnen angegebene Host ist die Domain, auf der Sie Inhalte bereitstellen möchten. Diese Domain kann eine Apex-Domain oder eine Subdomain sein. Ihr Domainanbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.
    • Eintragstyp: Fügen Sie den bereitgestellten DNS-Eintrag hinzu.
    • Wert: Weisen Sie Ihren Datensätzen den angegebenen Wert zu. Ihr Domainanbieter führt diesen Begriff möglicherweise als „Daten“, „Verweist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auf. Der Inhalt des Wertfelds variiert je nach Eintragstyp. TXT-Einträge sind beispielsweise Strings.
  2. Wählen Sie Einträge bestätigen aus. App Hosting versucht, die Änderungen zu erkennen, die Sie bei Ihrem Domainanbieter vorgenommen haben. Es kann bis zu 24 Stunden dauern, bis die Änderungen wirksam werden. Den Status können Sie im Backend-Dashboard unter Einstellungen > Domains einsehen.

Neue Domain verbinden

Wenn Ausfallzeiten kein Problem sind, z. B. wenn Sie eine Domain verbinden, die für Ihre Webanwendung neu ist, folgen Sie der Anleitung in diesem Abschnitt.

Schritt 1: Benutzerdefinierte Domain hinzufügen

  1. Rufen Sie in der Firebase-Konsole Hosting und serverlos > App Hosting auf.
  2. Wählen Sie mit der Option Dashboard ansehen ein App Hosting-Backend aus.
  3. Wählen Sie den Tab Einstellungen aus und klicken Sie 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: Klicken Sie das Kästchen an, um alle Anfragen an die benutzerdefinierte Domain an eine zweite angegebene Domain weiterzuleiten, sodass example.com und www.example.com an denselben Inhalt weitergeleitet werden.
  6. Klicken Sie auf Weiter zur Einrichtung, um Ihre DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domain abzuschließen.

Schritt 2: DNS-Einträge prüfen

  1. Im Assistenten Domain einrichten der Firebase-Konsole werden die erforderlichen Einträge angezeigt, die aktualisiert werden müssen, damit Ihre Seite auf Firebase App Hosting verweist. Fügen Sie Einträge aus Ihrer Domain bei Ihrem DNS-Anbieter hinzu, entfernen Sie sie und speichern Sie sie mit den folgenden Eingaben:
    • Name: Geben Sie den benutzerdefinierten Domainnamen für die Einträge ein. Der von Ihnen angegebene Host ist die Domain, auf der Sie Inhalte bereitstellen möchten. Diese Domain kann eine Apex-Domain oder eine Subdomain sein. Ihr Domainanbieter führt diesen Begriff möglicherweise als „Hostname“, „Name“ oder „Domain“ auf.
    • Eintragstyp: Fügen Sie den bereitgestellten DNS-Eintrag hinzu.
    • Wert: Weisen Sie Ihren Datensätzen den angegebenen Wert zu. Ihr Domainanbieter führt diesen Begriff möglicherweise als „Daten“, „Verweist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auf. Der Inhalt des Wertfelds variiert je nach Eintragstyp. TXT-Einträge sind beispielsweise Strings.
  2. Wählen Sie Einträge bestätigen aus. App Hosting versucht, die Änderungen zu erkennen, die Sie bei Ihrem Domainanbieter vorgenommen haben. Es kann bis zu 24 Stunden dauern, bis die Änderungen wirksam werden. Den Status können Sie im Backend-Dashboard unter Einstellungen > Domains einsehen.

Auf die Bereitstellung des SSL-Zertifikats warten

Es kann einige Stunden dauern, bis App Hosting ein SSL-Zertifikat für Ihre Domain bereitstellt, 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 verwiesen haben.

Sie können dieses Zertifikat mit den Sicherheitstools des Browsers aufrufen. Während die Domain bereitgestellt wird, wird möglicherweise ein ungültiges Zertifikat angezeigt oder es treten Probleme beim Herstellen einer Verbindung zu Ihrer Domain auf. Das ist ein normaler Teil des Prozesses und wird behoben, sobald das Zertifikat Ihrer Domain verfügbar ist.

Hinweis: Firebase App Hosting stellt SSL-Zertifikate für benutzerdefinierte Domains bei Bedarf automatisch neu bereit.

Statusbeschreibungen für benutzerdefinierte Domains

Status Beschreibung
Einrichtung erforderlich

Möglicherweise müssen Sie eine Konfiguration in Ihren DNS-Einträgen ändern.

  • In den meisten Fällen wurden Ihre DNS-A-Einträge nicht von Ihrem Domainnamen-Anbieter an die Firebase App Hosting-Server weitergegeben.
    Tipp zur Fehlerbehebung: Wenn mehr als 24 Stunden vergangen sind, prüfen Sie, ob Sie Ihre Einträge auf Firebase App Hosting verwiesen haben.

  • In selteneren Fällen können SSL-Anforderungen fehlschlagen, weil Ihre DNS-Einträge A-Einträge 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 richtig 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 verhindern. Achten Sie darauf, dass die Zertifizierungsstellen „letsencrypt.org“ und „pki.goog“ SSL-Zertifikate für Ihre Domain erstellen dürfen.

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.