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 Seite App Hosting Ihres Projekts.
- Wählen Sie über die 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 in der benutzerdefinierten Domain an eine zweite angegebene Domain weiterzuleiten, sodass
example.comundwww.example.comzum gleichen Inhalt 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
Der Assistent Benutzerdefinierte Domain hinzufügen der Firebase Console zeigt die erforderlichen Datensätze an, 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 gibt diesen Begriff möglicherweise als „Daten“, „Verweist auf“, „Inhalt“, „Adresse“ oder „IP-Adresse“ an. 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.
Es kann einige Zeit dauern, bis Ihr SSL-Zertifikat bereitgestellt wird. Dies dauert in der Regel einige Stunden. Gelegentlich kann es aber auch bis zu 24 Stunden dauern, nachdem Sie Ihr DNS auf Firebase App Hosting ausgerichtet haben. 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
Nachdem Sie Ihre DNS-Einträge aktualisiert haben, kann es einige Stunden dauern, bis App Hosting ein SSL-Zertifikat für Ihre Domain bereitstellt. 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 es können Probleme beim Herstellen einer Verbindung zu Ihrer Domain auftreten. 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 Datensätze 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.example.com). 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 eines TXT-Eintrags fah-claim=[UUID] verwenden, um anzugeben, welche benutzerdefinierte Domain in Ihrer Domain bereitgestellt 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
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 vornehmen. 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 |
|---|---|
| Apex-Domain |
Häufige Eingaben sind:
|
| Subdomain | Gängige Eingaben:
|
Gängige Domain-Anbieter
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 korrekt eingerichtet, aber Firebase App Hosting hat kein SSL-Zertifikat bereitgestellt. Gelegentlich können übermäßig restriktive CAA-Einträge das Erstellen 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 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. |