Con Firebase Hosting non devi rinunciare ai tuoi nomi di dominio unici e incentrati sul brand. 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 rimanente di questo documento descrive i passaggi per collegare il tuo dominio personalizzato.
Configurare il dominio per Hosting
Assicurati di aver completato la procedura guidata "Inizia" dalla pagina Firebase Hosting del progetto in modo da avere un sito Firebase Hosting nel progetto Firebase.
Passaggio 1: aggiungi il 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, quindi su Aggiungi dominio personalizzato.
Inserisci il nome di dominio personalizzato che vuoi collegare al tuo sito Hosting.
(Facoltativo) Seleziona la casella per reindirizzare tutte le richieste sul dominio personalizzato a un secondo dominio specificato (in modo che
example.com
ewww.example.com
reindirizzino 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 procedura guidata di configurazione Collega dominio, verifica il dominio di primo livello.
Questi passaggi ti assicurano che il tuo dominio non sia già collegato a un progetto Firebase e che tu ne sia il proprietario.
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 di mantenere questo record TXT costantemente presente nelle impostazioni DNS per dimostrare la proprietà del dominio e autorizzare Firebase ad assegnare e rinnovare i certificati SSL per il tuo sito.
Il tuo provider di dominio potrebbe indicare questo termine come "Tipo di record".
Host: inserisci la chiave del dominio principale.
La dimostrazione della proprietà di un dominio di primo livello o principale dimostra la proprietà di tutti i relativi sottodomini.
Il provider del dominio potrebbe indicare questo termine come "Nome host", "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 sicurezza la finestra Connetti dominio e riaprirla in un secondo momento. Ciò non influisce sul tempo di propagazione, ma ti verrà chiesto di reinserire il 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 poche ore, a seconda del fornitore del dominio. Per istruzioni dettagliate sull'aggiunta di record TXT e sui tempi di propagazione, consulta la documentazione del provider del tuo dominio.
Se fai clic su Verifica viene visualizzato un messaggio di errore, significa che i record non sono stati propagati o che 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 per i domini che stai tentando di trasferire da un altro sito Hosting. La configurazione avanzata può essere utilizzata se hai già un dominio che riceve richieste su un altro provider di hosting e hai bisogno di una migrazione senza tempi di riposo.
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 da aggiornare per indirizzare la tua pagina a Firebase Hosting. Aggiungi, rimuovi e salva i record del tuo dominio nel tuo provider DNS con i seguenti input:
- Tipo: aggiungi il record DNS fornito.
- Host: inserisci la chiave del dominio personalizzato per i record.
- Valore: assegna gli indirizzi IP forniti al valore dei record.
- Attendi il provisioning del certificato SSL. L'operazione potrebbe richiedere fino a 24 ore dopo aver impostato il DNS su Firebase Hosting. Nella maggior parte dei casi, la propagazione dei record e il provisioning del certificato SSL avvengono entro poche ore, a seconda del provider del dominio.
L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio di primo livello o un sottodominio.
Il provider del dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio".
Il tuo provider di dominio potrebbe indicare questo termine come "Dati", "Indica", "Contenuti", "Indirizzo" o "Indirizzo IP".
Configurazione avanzata
La modalità di configurazione Avanzata della procedura guidata Aggiungi dominio personalizzato ti consente di configurare Hosting per pubblicare il tuo 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 per il dominio ai server Hosting
La configurazione Avanzata ti guida nella configurazione del tuo dominio per consentire a Hosting di occuparsi in anticipo dei primi due requisiti, in modo che sia pronto a pubblicare i contenuti corretti prima di iniziare a ricevere traffico per il tuo dominio. Questa procedura guidata rappresenta questa procedura come un flusso di lavoro in due passaggi:
- Prepara il dominio
- Aggiorna i record DNS: aggiungi uno o più record al tuo dominio:
- Proprietà: un record TXT nel formato `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. È presente solo se Hosting rileva record CAA esistenti che impediscono il provisioning di un certificato.
- Configura il certificato SSL: la procedura guidata fornisce una sfida ACME che le autorità di certificazione di Hosting utilizzeranno per emettere un certificato SSL per il tuo dominio. Puoi scegliere tra una verifica DNS
o HTTP:
- DNS challenge: visita i siti di gestione DNS del tuo provider di dominio. Aggiungi un record TXT con la chiave del sottodominio della verifica ACME e il valore fornito. Attendi fino a 24 ore per la propagazione dei record TXT.
- Prova HTTP: carica il file di testo fornito sul tuo sito esistente all'URL specificato e verifica la sua esistenza.
- Diretto a Hosting
- Tipo: aggiungi i record DNS A/AAAA richiesti.
- Host:
inserisci la chiave del dominio personalizzato per entrambi i record.
L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio principale o un sottodominio. Il provider del dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio".
- Valore: assegna un valore a ogni record A/AAAA DNS per indirizzare il tuo dominio agli indirizzi IP specificati.
Il tuo provider di dominio potrebbe indicare questo termine come "Dati", "Punti di destinazione", "Contenuti", "Indirizzo" o "Indirizzo IP".
Hosting tenterà di convalidare le sfide ACME prima di richiedere la verifica alla propria 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.
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:
Attendi il provisioning del certificato SSL
Dopo aver verificato la proprietà del dominio, eseguiamo il provisioning di un certificato SSL per il tuo dominio e lo implementiamo nella nostra CDN globale entro 24 ore dal puntamento dei tuoi record A DNS a Firebase Hosting.
Il tuo dominio verrà elencato come uno dei nomi alternativi dell'oggetto (SAN) nel certificato SSL di FirebaseApp. Puoi visualizzare questo certificato utilizzando gli strumenti di sicurezza del browser. Durante il provisioning del dominio, potresti visualizzare un certificato non valido che non include il tuo nome di dominio. Si tratta di una procedura normale che verrà risolta quando il certificato del tuo dominio sarà disponibile.
Per gli utenti della configurazione avanzata, il sito web verrà ospitato dal provider di hosting precedente finché il stato di configurazione nella Firebase Hosting pagina del progetto non verrà aggiornato in Connesso.
La chiave del tuo dominio personalizzato
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. Di seguito abbiamo raccolto gli input comuni dei fornitori più diffusi. Per istruzioni dettagliate, consulta la documentazione del provider del dominio.
Tipo di dominio | Chiave del dominio personalizzato |
---|---|
Dominio Apex |
Gli input più comuni includono:
|
Sottodominio | Gli input più comuni includono:
|
Provider di domini comuni
Di seguito sono riportati alcuni fornitori di dominio comuni e i tipi di input che potrebbero richiedere. Queste informazioni vengono aggiornate il più possibile, ma consulta la documentazione del fornitore del tuo 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 DNS A | ||
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 DNS A | ||
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 DNS A | ||
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 DNS A | ||
A | @ | 199.36.158.100 |
A | www | 199.36.158.100 |
Descrizioni dello stato di configurazione per i domini personalizzati
Stato | Descrizione |
---|---|
Richiede la configurazione |
Potrebbe essere necessario modificare una configurazione dei record DNS.
|
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:
|
Minting Certificate | È 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 certificato SSL. |