Benutzerdefinierte Domain verbinden

Sie müssen Ihre eindeutigen, markenbezogenen Domainnamen für Apps nicht aufgeben, die in Firebase App Hostingbereitgestellt werden. Sie können für Ihre in Firebase gehostete Website eine benutzerdefinierte Domain wie 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 Rest 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 zum Migrieren einer Domain, 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

Im Assistenten App Hosting Domain einrichten werden Sie möglicherweise aufgefordert, je nach aktueller Konfiguration Ihrer Domain 1 bis 5 DNS-Einträge hinzuzufügen oder zu entfernen. Der Typ eines Eintrags bestimmt seine Funktion. Dies sind die Arten von Einträgen, die von App Hosting möglicherweise angefordert werden:

Typ Beschreibung Exklusiv
A Diese Einträge enthalten IPv4-Werte (z.B. 8.8.8.8), die Browsern mitteilen, welche Adresse verwendet werden soll, 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 Adresseneintrag mit ungefähr der gleichen Funktion wie A-Einträge. App Hosting verwendet derzeit keine AAAA-Einträge, fordert Sie aber auf, alle vorhandenen 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 aufzulö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:
  • Einfaches Onboarding: Wenn möglich, fordert App Hosting Sie auf, einen CNAME-Eintrag zu einer vorkonfigurierten Domain zu erstellen, die mit _custom-domain... beginnt.
  • SSL-Zertifikatüberprüfung: App Hosting verwendet Cloud Certificate Manager, um SSL-Zertifikate für Ihre benutzerdefinierte Domain bereitzustellen. Mit einem CNAME-Eintrag für eine _acme-challenge...-Subdomain kann Zertifikatmanager Zertifikate für Sie erstellen und verlängern. Nach dem Onboarding darf dieser Eintrag nicht entfernt werden, da sonst Ihr Zertifikat abläuft.
 Ja
TXT Mit diesen Einträgen können Sie Ihrer Domain beliebige Metadaten anhängen. App Hosting ermöglicht Ihnen die Verwendung eines bestimmten Formats von TXT-Einträgen, fah-claim=[UUID], 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 CAA-Einträge nur an, wenn die Erstellung von Zertifikaten für Ihre Domain auf andere Weise blockiert ist. Nein

Vorbereitung: Ihr benutzerdefinierter Domainname

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

Wir haben unten häufige Eingaben von beliebten Anbietern zusammengestellt. Detaillierte Anweisungen finden Sie in der Dokumentation Ihres Domainanbieters.

Domaintyp Benutzerdefinierter Domainname
Apex-Domain

Häufige Eingaben sind:

  • @
  • Der Name der Apex-Domain (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)

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. Detaillierte Anweisungen finden Sie jedoch 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 in der Firebase Console den Ablauf Domain migrieren verwenden. Dieser Ablauf führt Sie durch einen zweistufigen Prozess, bei dem App Hosting vorbereitet wird, Inhalte auf Ihrer Domain bereitzustellen, bevor Traffic an die App Hosting-Server weitergeleitet wird.

Schritt 1: Benutzerdefinierte Domain hinzufügen

  1. Rufen Sie in der Firebase Console Hosting & Serverless > App Hosting auf.
  2. Wählen Sie mit der Option Dashboard ansehen ein App Hosting Back-End aus.
  3. Wählen Sie den Tab Einstellungen aus und klicken Sie dann auf Benutzerdefinierte Domain hinzufügen.
  4. Geben Sie den Domainnamen der benutzerdefinierten Domain ein, die 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 auf denselben Inhalt weiterleiten.
  6. Klicken Sie auf Mit der Einrichtung fortfahren , 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. Dieser umfasst die Änderungen, die erforderlich sind, damit App Hosting Ihr bevorzugtes Back-End bereitstellen und sichere TLS-Verbindungen für Ihre Domain herstellen kann. Fügen Sie in Ihrem DNS-Anbieter Einträge aus Ihrer Domain hinzu, entfernen Sie sie und speichern Sie sie. Verwenden Sie dabei die folgenden Eingaben für die erforderlichen Einträge:
    • Name: Geben Sie Ihren 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 kann diesen Begriff als „Hostname“, „Name“ oder „Domain“ auflisten.
    • Eintragstyp: Fügen Sie den angegebenen DNS-Eintrag hinzu.
    • Wert: Weisen Sie den angegebenen Wert Ihren Einträgen zu. Ihr Domainanbieter kann diesen Begriff als „Daten“, „Verweist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auflisten. 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. Sie können den Status im Back-End-Dashboard unter Einstellungen > Domains prüfen.

Schritt 3: Zu App Hosting weiterleiten

  1. Nachdem App Hosting die Eintragaktualisierungen aus dem vorherigen Schritt bestätigt hat, wird im Assistenten der letzte Schritt Zu App Hosting weiterleiten angezeigt. In diesem Schritt werden die Eintragaktualisierungen angezeigt, die Sie vornehmen müssen, um den Traffic Ihrer Domain an die App Hosting Server weiterzuleiten. Fügen Sie wie zuvor in Ihrem DNS-Anbieter Einträge aus Ihrer Domain hinzu, entfernen Sie sie und speichern Sie sie. Verwenden Sie dabei die folgenden Eingaben für die erforderlichen Einträge:
    • Name: Geben Sie Ihren 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 kann diesen Begriff als „Hostname“, „Name“ oder „Domain“ auflisten.
    • Eintragstyp: Fügen Sie den angegebenen DNS-Eintrag hinzu.
    • Wert: Weisen Sie den angegebenen Wert Ihren Einträgen zu. Ihr Domainanbieter kann diesen Begriff als „Daten“, „Verweist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auflisten. 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. Sie können den Status im Back-End-Dashboard unter Einstellungen > Domains prüfen.

Neue Domain verbinden

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

Schritt 1: Benutzerdefinierte Domain hinzufügen

  1. Rufen Sie in der Firebase Console Hosting & Serverless > App Hosting auf.
  2. Wählen Sie mit der Option Dashboard ansehen ein App Hosting Back-End aus.
  3. Wählen Sie den Tab Einstellungen aus und klicken Sie dann auf Benutzerdefinierte Domain hinzufügen.
  4. Geben Sie den Domainnamen der benutzerdefinierten Domain ein, die 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 auf denselben Inhalt weiterleiten.
  6. Klicken Sie auf Mit der Einrichtung fortfahren , um Ihre DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domain abzuschließen.

Schritt 2: DNS-Einträge bestätigen

  1. Im Assistenten Domain einrichten der Firebase Console werden die erforderlichen Einträge angezeigt, die aktualisiert werden müssen, damit Ihre Seite auf Firebase App Hosting verweist. Fügen Sie in Ihrem DNS-Anbieter Einträge aus Ihrer Domain hinzu, entfernen Sie sie und speichern Sie sie. Verwenden Sie dabei die folgenden Eingaben:
    • Name: Geben Sie Ihren 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 kann diesen Begriff als „Hostname“, „Name“ oder „Domain“ auflisten.
    • Eintragstyp: Fügen Sie den angegebenen DNS-Eintrag hinzu.
    • Wert: Weisen Sie den angegebenen Wert Ihren Einträgen zu. Ihr Domainanbieter kann diesen Begriff als „Daten“, „Verweist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ auflisten. 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. Sie können den Status im Back-End-Dashboard unter Einstellungen > Domains prüfen.

Auf die Bereitstellung des SSL-Zertifikats warten

App Hosting 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 Ihre DNS-Einträge auf Firebase App Hosting verweisen lassen.

Sie können dieses Zertifikat mit den Sicherheitstools des Browsers ansehen. 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 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 App Hosting Server weitergegeben.
    Tipp zur Fehlerbehebung: Wenn bereits mehr als 24 Stunden vergangen sind, prüfen Sie, ob Sie Ihre Einträge auf Firebase App Hosting verweisen lassen.

  • In selteneren Fällen schlagen SSL-Herausforderungen möglicherweise fehl, weil Ihre DNS-Einträge A-Einträge oder CNAME-Einträge enthalten, die auf andere Hostinganbieter verweisen.
    Tipp zur Fehlerbehebung: Prüfen Sie, ob Ihre A-Einträge nur auf Firebase App Hosting, und entfernen Sie alle CNAME-Einträge.
Ausstehend

Sie haben Ihre benutzerdefinierte Domain korrekt eingerichtet, aber Firebase App Hosting hat noch 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. 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.