Non devi rinunciare ai tuoi nomi di dominio unici e incentrati sul brand con
Firebase Hosting. Puoi utilizzare un dominio personalizzato (ad esempio example.com o
app.example.com) anziché un dominio generato da Firebase per il tuo
sito ospitato su Firebase.
Firebase Hosting esegue il provisioning di un certificato SSL per ciascuno dei tuoi domini
e pubblica i tuoi contenuti
su una rete CDN globale.
La parte restante di questo documento ti guiderà attraverso questi passaggi per collegare i tuoi account
dominio.
Configurare il dominio per Hosting
Assicurati di aver completato la sezione "Inizia" dalla configurazione guidata del progetto
Firebase Hosting pagina
in modo da avere un sito Firebase Hosting nel progetto Firebase.
Passaggio 1: aggiungi un dominio personalizzato
Dalla
Hosting pagina del progetto,
accedi alla procedura guidata per il collegamento di un dominio personalizzato:
Se hai un solo sito Hosting, fai clic su Aggiungi dominio personalizzato.
Se hai più di un sito Hosting, fai clic su
Visualizza per il sito che ti interessa, poi fai clic su Aggiungi dominio personalizzato.
Inserisci il nome di dominio personalizzato che vuoi collegare al tuo sito Hosting.
(Facoltativo) Seleziona la casella a cui reindirizzare tutte le richieste sul dominio personalizzato.
un secondo dominio specificato (ad esempio example.com e
www.example.com reindirizzano agli stessi contenuti).
Fai clic su Continua per configurare i record DNS e completare la configurazione del dominio personalizzato.
Passaggio 2: configura il dominio personalizzato
Se richiesto nella configurazione guidata di Connect Domain,
verificare il dominio Apex.
Questi passaggi assicurano che il tuo dominio non sia già collegato a un
progetto Firebase e di essere il proprietario del dominio specificato.
Sul sito del tuo provider di dominio, individua la pagina di gestione DNS.
Aggiungi e salva un nuovo record con i seguenti input:
Tipo: aggiungi un record TXT.
Firebase Hosting richiede la conservazione continua di questo record TXT
presente nelle impostazioni DNS per dimostrare che il dominio è di tua proprietà e per
autorizzare Firebase ad assegnare e rinnovare i certificati SSL per il tuo sito.
Il tuo provider di dominio potrebbe elencare questo termine come "Tipo di record".
La dimostrazione della proprietà di un dominio di primo livello o principale dimostra la proprietà di tutti i relativi sottodomini.
Il tuo provider di dominio potrebbe indicare questo termine come "Nome host" e "Nome".
o "Dominio".
Valore: copia il valore di verifica univoco nel campo.
Firebase Hosting controlla questo valore per dimostrare la proprietà del dominio.
Il tuo provider di dominio potrebbe indicare questo termine come "Dati".
Attendi fino a 24 ore per la propagazione dei record TXT aggiornati, quindi fai clic su
Verifica.
Tieni presente che puoi fare clic su Annulla per chiudere in modo sicuro Connect Domain (Connetti dominio).
e riaprirla in un secondo momento. Ciò non influisce sulla propagazione
volta, ma ti verrà chiesto di
reinserisci il tuo nome di dominio quando
riapri la finestra.
Dopo un tempo di propagazione sufficiente, fai clic su Verifica nella finestra Collega dominio della console Firebase per avviare la procedura di provisioning del certificato SSL.
Nella maggior parte dei casi, la propagazione dei record e la verifica del dominio
avviene entro qualche ora, a seconda del provider del dominio. Consulta
la documentazione del provider del tuo dominio per istruzioni dettagliate su come aggiungere
Record TXT e tempi di propagazione.
Se facendo clic su Verifica viene visualizzato un messaggio di errore, i record non sono stati
propagati o i valori potrebbero non essere corretti.
Nella procedura guidata Aggiungi dominio personalizzato della console Firebase, seleziona Configurazione rapida o Configurazione avanzata.
La configurazione rapida può essere utilizzata per i nuovi domini che al momento non ricevono
traffico o domini che stai tentando di trasferire da un altro Hosting
sito. La configurazione avanzata può essere utilizzata se hai già un dominio che riceve
richieste su un altro provider host e necessitano di una migrazione senza tempi di inattività.
La procedura guidata Configurazione avanzata ti aiuterà a stabilire un certificato SSL e una rivendicazione della proprietà per consentire a Hosting di pubblicare il traffico sul dominio prima di riceverlo.
Configurazione rapida
La procedura guidata Aggiungi dominio personalizzato della console Firebase
mostrerà i record necessari che devono essere aggiornati per indirizzare la pagina a
Firebase Hosting. Aggiungi, rimuovi e salva i record del tuo dominio nel tuo
provider DNS con i seguenti input:
L'host indicato è il dominio su cui vuoi pubblicare gli annunci
contenuti; può essere un dominio o un sottodominio Apex.
Il provider del dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio".
Valore: assegna gli indirizzi IP forniti al valore dei record.
Il tuo provider di dominio potrebbe elencare questo termine come "Dati", "Rimanda a",
"Contenuti", "Indirizzo" o "Indirizzo IP".
Attendi il provisioning del certificato SSL.
Questa operazione può richiedere fino a 24 ore dal punto di accesso del DNS a
Firebase Hosting.
Nella maggior parte dei casi, la propagazione dei record
il provisioning del certificato SSL avverrà entro poche ore,
a seconda del provider di dominio.
di Gemini Advanced.
Configurazione avanzata
La sezione Aggiungi dominio personalizzato
la modalità di configurazione Avanzata della procedura guidata consente di configurare Hosting
gestire il dominio in modo sicuro prima di indirizzare il traffico ai suoi server. In
generale, Hosting ha bisogno di tre elementi per pubblicare correttamente il traffico su un
dominio:
Record di proprietà: un record TXT indica a Hosting quale sito mostrare sul dominio
Certificato SSL: un certificato specifico per il dominio che consente la comunicazione criptata tra i server Hosting e gli utenti finali
Record IP di hosting: uno o più record A e AAAA
che indirizzano tutte le richieste del dominio ai server Hosting
La configurazione avanzata ti guida nella configurazione del dominio
per consentire a Hosting di gestire in anticipo i primi due requisiti, quindi
che sia pronto per pubblicare i contenuti corretti prima di iniziare a ricevere
per il tuo dominio.
Questa procedura guidata rappresenta questo processo come un flusso di lavoro in due fasi:
Prepara il dominio
Aggiorna i record DNS: aggiungi uno o più record a
il tuo dominio:
Proprietà: un record TXT nel modulo
"hosting-site=[site_id]".
CAA (facoltativo): una coppia di record CAA
che consente alle autorità di certificazione di Hosting di emettere un certificato SSL per il tuo dominio. Solo
presenti se Hosting rileva record CAA esistenti che impediscono
di eseguire il provisioning di un certificato.
Configura certificato SSL: la procedura guidata fornisce un
ACME:
verifica che le autorità di certificazione di Hosting utilizzeranno per
creare un certificato SSL per il tuo dominio. Puoi scegliere tra una verifica DNS
o HTTP:
Verifica DNS: visita il DNS del tuo provider di dominio.
siti di gestione. Aggiungere un record TXT con la sfida ACME
e il valore fornito. Attendi fino a 24 ore per
la propagazione dei tuoi record TXT.
Verifica HTTP:
Carica il file di testo fornito sul tuo sito esistente all'indirizzo
dell'URL specificato e verificarne l'esistenza.
Hosting tenterà di convalidare le sfide ACME
prima di richiedere la verifica alla sua CA. Se la CA non riesce a verificare le tue verifiche per qualsiasi motivo, ad esempio per problemi di servizio intermittenti. Hosting dovrà generare un nuovo insieme di
sfide per te. Se la verifica va a buon fine, possono essere necessarie fino a alcune ore prima che Hosting esegui il provisioning di un certificato SSL e ne consenta la propagazione.
Indirizza gli utenti a Hosting
Dopo che Hosting avrà stabilito la tua proprietà del dominio e avrà eseguito il provisioning di un certificato SSL, torna al tuo provider DNS e aggiungi i record DNS A/AAAA che indirizzano le richieste a Hosting:
Tipo: aggiungi i record DNS A/AAAA richiesti.
Organizzatore:
Inserisci la chiave di dominio personalizzata per entrambi i record.
L'host indicato
è il dominio su cui vuoi pubblicare i contenuti; questo dominio può essere un
o un sottodominio Apex. Il provider del dominio potrebbe indicare questo termine come
"Nome host", "Nome" o "Dominio".
Valore: assegnane uno
a ogni record DNS A/AAAA per indirizzare il dominio all'IP specificato
indirizzi IP esterni.
Il provider del dominio potrebbe indicare questo termine come "Dati", "Punti
di destinazione", "Contenuti", "Indirizzo" o "Indirizzo IP".
Attendi il provisioning del certificato SSL
Dopo aver verificato la proprietà del dominio, eseguiamo il provisioning di un certificato SSL per
dominio ed eseguirne il deployment sulla nostra rete CDN globale entro 24 ore dall'indirizzamento
Record DNS A per Firebase Hosting.
Il tuo dominio verrà elencato come uno dei Nomi alternativi del soggetto (SAN) nella
Certificato SSL FirebaseApp. Puoi visualizzare questo certificato utilizzando la proprietà
strumenti di sicurezza. Durante il provisioning del dominio, potresti visualizzare un certificato non valido che non include il tuo nome di dominio. Si tratta di una parte normale
e si risolverà non appena il certificato del dominio sarà disponibile.
Per gli utenti che utilizzano la configurazione avanzata, il sito web sarà ospitato sul sito di hosting precedente.
fino a quando
stato di configurazione nel tuo
del progetto
Pagina Firebase Hosting
aggiornamenti a Connesso.
La tua chiave di dominio personalizzata
Quando aggiungi o modifichi i record DNS, i diversi provider di dominio ti richiedono di inserire input diversi per il campo Host all'interno dei loro siti di gestione DNS. Abbiamo raccolto alcuni input comuni provenienti dai provider più noti qui sotto.
Per istruzioni dettagliate, consulta la documentazione del provider del dominio.
Tipo di dominio
Chiave del dominio personalizzato
Dominio Apex
Gli input più comuni includono:
@
Il nome di dominio di primo livello (ad esempio
example.com)
Lasciare vuoto il campo Host
Sottodominio
Gli input più comuni includono:
Il nome completo del sottodominio
(ad esempio app.example.com)
Solo la parte del sottodominio (ad esempio solo app,
senza .example.com)
Solo www per il sottodominio di
www.example.com
Provider di dominio comuni
Di seguito sono riportati alcuni provider di dominio comuni e i tipi di input che ciascuno potrebbe richiedere.
Queste informazioni vengono sempre aggiornate il più possibile, ma fai riferimento alle
documentazione del provider di dominio
per istruzioni dettagliate.
Cloudflare
Tipo
Organizzatore
Valore
Input dei record TXT DNS
TXT
example.com
valore di verifica fornito nella console Firebase
Input dei record A DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Tipo
Organizzatore
Valore
Input dei record TXT DNS
TXT
example.com
valore di verifica fornito nella console Firebase
Input dei record A DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
NameCheap
Tipo
Organizzatore
Valore
Input dei record TXT DNS
TXT
@
valore di verifica fornito nella console Firebase
Input dei record A DNS
A
@
199.36.158.100
A
www
199.36.158.100
Squarespace
Tipo
Organizzatore
Valore
Input dei record TXT DNS
TXT
@
valore di verifica fornito nella console Firebase
Input dei record A DNS
A
@
199.36.158.100
A
www
199.36.158.100
Descrizioni degli stati per i domini personalizzati
Stato
Descrizione
Richiede la configurazione
Potrebbe essere necessario modificare una configurazione dei record DNS.
Nella maggior parte dei casi, i record DNS A non sono stati propagati
dal provider del nome di dominio ai server Firebase Hosting.
Suggerimento per la risoluzione dei problemi: se sono trascorse più di 24 ore, verifica che
hai indirizzato i tuoi record a Firebase Hosting.
In casi più rari, in particolare se utilizzi il flusso di configurazione avanzata, le verifiche SSL potrebbero non riuscire perché:
Le verifiche del certificato SSL non sono riuscite e il token (DNS TXT
record o file caricati
file fornito al tuo sito) non è più valido.
Suggerimento per la risoluzione dei problemi: fai clic su Visualizza per il dominio, quindi fornisci il nuovo token al dominio esistente.
In attesa
Hai configurato correttamente il tuo dominio personalizzato, ma Firebase Hosting
non ha eseguito il provisioning di un certificato SSL.
A volte, i seguenti problemi possono bloccare la creazione di un certificato SSL per un dominio personalizzato:
I tuoi record CAA sono troppo restrittivi.
Suggerimento per la risoluzione dei problemi: assicurati che le autorità di certificazione
"letsencrypt.org" e "pki.goog" possono creare certificati SSL per
il tuo dominio.
Il tuo codice di verifica non è valido. Se utilizzi il flusso di configurazione avanzata e la migrazione non è riuscita, il tuo token (e il relativo codice di verifica) non sono più validi.
Suggerimento per la risoluzione dei problemi: fai clic su Visualizza per il dominio
quindi fornire il nuovo token al dominio esistente.
Hai richiesto certificati per troppi sottodomini.
Suggerimento per la risoluzione dei problemi: in genere, Firebase Hosting consiglia di non
più di 20 sottodomini in un dominio personalizzato Apex a causa di SSL
limiti di minting dei certificati.
Certificato di minting
È in corso la produzione di un certificato SSL per il tuo dominio.
Connesso
Il tuo dominio personalizzato dispone dei record DNS corretti e di un protocollo SSL
certificato.
Puoi pubblicare i contenuti del tuo sito.