Benutzerdefinierte Domain verbinden

Sie müssen Ihre einzigartigen, markenzentrierten Domainnamen für Apps die in Firebase App Hostingbereitgestellt werden, nicht aufgeben. Sie können für Ihre in 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 Rest dieses Dokuments werden die Schritte zum Verbinden einer benutzerdefinierten Domain auf eine der folgenden Arten beschrieben:

• Domain migrieren
• Neue Domain verbinden

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 für Ihre Web-App neu ist, folgen Sie der Anleitung zum Verbinden einer neuen Domain.

Vorbereitung: DNS-Eintragstypen

Im Assistenten App Hosting Domain einrichten von App Hosting 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 angefordert werden können:

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 derselben 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.	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-Zertifikatbestätigung: 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 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 auf ihren DNS-Verwaltungswebsites unterschiedliche Eingaben für das Feld Host (oder Hostname) machen. Der Assistent für benutzerdefinierte Domains App Hosting erfordert, dass Sie denselben Wert im 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.

Cloudflare

Host	Eingabe
example.com.	@
www.example.com.	www

Google Cloud DNS

Host	Eingabe
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

Host	Eingabe
example.com.	@
www.example.com.	www

Squarespace

Host	Eingabe
example.com.	@
www.example.com.	www

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 der Traffic an 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 Namen der benutzerdefinierten Domain ein, die Sie mit Ihrer App Hosting Website verbinden möchten.
5. (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 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 Ihren Einträgen den angegebenen Wert 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's an 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 Ihren Einträgen den angegebenen Wert 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 für Ihre Web-App neu 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 Namen der benutzerdefinierten Domain ein, die Sie mit Ihrer App Hosting Website verbinden möchten.
5. (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 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, um Ihre Seite auf Firebase App Hosting zu verweisen. 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 Ihren Einträgen den angegebenen Wert 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 auf Firebase App Hosting verwiesen haben.

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, nachdem das Zertifikat Ihrer Domain verfügbar ist.

Hinweis: Firebase App Hosting stellt SSL-Zertifikate bei Bedarf automatisch für benutzerdefinierte Domains 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 verwiesen haben. 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.