Sie müssen Ihre eindeutigen, markenorientierten Domainnamen für auf Firebase App Hosting bereitgestellte Apps 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 weiteren Verlauf 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
- Öffnen Sie die App Hosting-Seite Ihres Projekts.
- Wählen Sie über die Option Dashboard ansehen ein App Hosting-Backend aus.
- Klicken Sie auf den Tab Einstellungen und dann auf Benutzerdefinierte Domain hinzufügen.
- Geben Sie den benutzerdefinierten Domainnamen ein, den Sie mit Ihrer App Hosting-Website verknüpfen möchten.
- Optional: Setzen Sie ein Häkchen, um alle Anfragen an die benutzerdefinierte Domain an eine zweite angegebene Domain weiterzuleiten, sodass
example.comundwww.example.comzu denselben Inhalten weiterleiten. - Klicken Sie auf Weiter, um Ihre DNS-Einträge zu konfigurieren und die Einrichtung Ihrer benutzerdefinierten Domain abzuschließen.
Schritt 2: Benutzerdefinierte Domain einrichten
Im Firebase Console-Assistenten Benutzerdefinierte Domain hinzufügen werden die erforderlichen Einträge angezeigt, 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. 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.
Wert: Weisen Sie den Einträgen 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:Firebase App Hosting stellt bei Bedarf automatisch SSL-Zertifikate für benutzerdefinierte Domains bereit.
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:
|
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
Wenn Sie DNS-Einträge hinzufügen oder bearbeiten, erwarten verschiedene Domainanbieter, dass Sie auf ihren DNS-Verwaltungswebsites unterschiedliche Eingaben für das Feld Host eingeben. Unten finden Sie häufig verwendete Eingaben von beliebten Anbietern. Eine ausführliche Anleitung finden Sie in der Dokumentation Ihres Domainanbieters.
| Domaintyp | Schlüssel für benutzerdefinierte Domain |
|---|---|
| Root-Domain |
Gängige Eingaben:
|
| Subdomain | Gängige Eingaben:
|
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.
|
| 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 verzögern. Die Zertifizierungsstellen „letsencrypt.org“ und „pki.goog“ müssen berechtigt sein, SSL-Zertifikate für Ihre Domain zu erstellen. |
| Zertifikat für die Erstellung | Für Ihre Domain wird ein SSL-Zertifikat erstellt. |
| Verbunden | Ihre benutzerdefinierte Domain hat die richtigen DNS-Einträge und ein SSL-Zertifikat. |