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:
|
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:
|
| Subdomain | Zu den gängigen Eingaben gehören:
|
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
- Rufen Sie in der Firebase-Konsole Hosting und serverlos > App Hosting auf.
- Wählen Sie mit der Option Dashboard ansehen ein App Hosting-Backend aus.
- Wählen Sie den Tab Einstellungen aus und klicken Sie dann auf Benutzerdefinierte Domain hinzufügen.
- Geben Sie den benutzerdefinierten Domainnamen ein, den Sie mit Ihrer App Hosting-Website verbinden möchten.
- Optional: Klicken Sie das Kästchen an, um alle Anfragen an die benutzerdefinierte Domain an eine zweite angegebene Domain weiterzuleiten, sodass
example.comundwww.example.coman denselben Inhalt weitergeleitet werden. - 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
- Wählen Sie im Assistenten Domain einrichten den Tab Domain migrieren aus.
- 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.
- 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
- 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.
- 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
- Rufen Sie in der Firebase-Konsole Hosting und serverlos > App Hosting auf.
- Wählen Sie mit der Option Dashboard ansehen ein App Hosting-Backend aus.
- Wählen Sie den Tab Einstellungen aus und klicken Sie dann auf Benutzerdefinierte Domain hinzufügen.
- Geben Sie den benutzerdefinierten Domainnamen ein, den Sie mit Ihrer App Hosting-Website verbinden möchten.
- Optional: Klicken Sie das Kästchen an, um alle Anfragen an die benutzerdefinierte Domain an eine zweite angegebene Domain weiterzuleiten, sodass
example.comundwww.example.coman denselben Inhalt weitergeleitet werden. - 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
- 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.
- 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.
|
| 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. |