Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Non devi rinunciare ai tuoi nomi di dominio unici e incentrati sul marchio con Firebase Hosting. Puoi utilizzare un dominio personalizzato (come example.com o app.example.com ) invece di un dominio generato da Firebase per il tuo sito ospitato da Firebase.
Firebase Hosting fornisce un certificato SSL per ciascuno dei tuoi domini e serve i tuoi contenuti su un CDN globale.
Il resto di questo documento ti guida attraverso questi passaggi per connettere il tuo dominio personalizzato.
Configura il tuo dominio per l'hosting
Assicurati di aver completato la procedura guidata "Inizia" dalla pagina di hosting Firebase del tuo progetto in modo da avere un sito di hosting Firebase nel tuo progetto Firebase.
Passaggio 1 : aggiungi il dominio
Dalla pagina Hosting del tuo progetto, accedi alla procedura guidata per la connessione di un dominio personalizzato:
Se disponi di un solo sito di hosting, fai clic su Aggiungi dominio personalizzato .
Se disponi di più di un sito di hosting , fai clic su Visualizza per il sito desiderato, quindi fai clic su Aggiungi dominio personalizzato .
Inserisci il nome di dominio personalizzato che desideri connettere al tuo sito di hosting.
(Facoltativo) Seleziona la casella per reindirizzare tutte le richieste sul dominio personalizzato a un secondo dominio specificato (ad esempio example.com e www.example.com reindirizzano allo stesso contenuto).
Fare clic su Continua per avviare il processo di convalida.
Passaggio 2 : verifica la proprietà del dominio
Se richiesto nella configurazione guidata di Connect Domain , verifica il tuo dominio apex.
Questi passaggi assicurano che il tuo dominio non sia già collegato a un progetto Firebase e che tu possieda il dominio specificato.
Nel sito del tuo provider di dominio, individua la pagina di gestione del DNS.
Aggiungi e salva un nuovo record con i seguenti input:
Tipo : aggiungi un record TXT.
Firebase Hosting richiede che tu mantenga questo record TXT continuamente presente nelle tue impostazioni DNS per dimostrare la tua proprietà del dominio 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".
Dimostrare la tua proprietà di un dominio apex, o dominio principale, dimostra la tua proprietà di tutti i suoi sottodomini.
Il tuo provider di dominio potrebbe elencare 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 tuo dominio.
Il tuo provider di dominio potrebbe elencare questo termine come "Dati".
Attendi fino a 24 ore per la propagazione dei record TXT aggiornati, quindi fai clic su Verifica .
Si noti che è possibile fare clic su Annulla per chiudere in modo sicuro la finestra Connetti dominio e riaprirla in un secondo momento. Ciò non influisce sul tempo di propagazione, ma ti verrà chiesto di reinserire il tuo nome di dominio quando riapri la finestra.
Dopo un lungo periodo di propagazione, facendo clic su Verifica nella finestra Connetti dominio della console Firebase è possibile iniziare il processo di provisioning del certificato SSL.
Nella maggior parte dei casi, la propagazione dei tuoi record e la verifica del tuo dominio avverranno entro poche ore, a seconda del tuo provider di dominio. Consulta la documentazione del tuo provider di dominio per istruzioni dettagliate sull'aggiunta di record TXT e sui tempi di propagazione.
Se facendo clic su Verifica viene visualizzato un messaggio di errore, i record non sono stati propagati oppure i valori potrebbero non essere corretti.
Passaggio 3 : vai in diretta
Nella finestra Connetti dominio della console Firebase, seleziona Configurazione rapida per un nuovo sito o Configurazione avanzata se disponi già di un sito in esecuzione su un altro provider di hosting e hai bisogno di una migrazione senza tempi di inattività.
Configurazione rapida
Torna al sito di gestione DNS del provider del tuo nome di dominio per creare record DNS A che indirizzino la tua pagina a Firebase Hosting. Aggiungi e salva i record con i seguenti input:
L'host che indichi è il dominio su cui vuoi servire il contenuto; questo dominio può essere un dominio apex o un sottodominio.
Il tuo provider di dominio potrebbe elencare questo termine come "Nome host", "Nome" o "Dominio".
Valore : assegna un valore a ciascun record DNS A per indirizzare il tuo dominio agli indirizzi IP specificati.
Il tuo provider di dominio potrebbe elencare questo termine come "Dati", "Punta a", "Contenuto", "Indirizzo" o "Indirizzo IP".
Attendere il tempo per il provisioning del certificato SSL . Potrebbero essere necessarie fino a 24 ore dopo che avrai indirizzato i tuoi record A a Firebase Hosting. Nella maggior parte dei casi, la propagazione dei tuoi record e il provisioning del tuo certificato SSL avverrà entro poche ore, a seconda del tuo provider di dominio.
Impostazioni avanzate
La finestra Connetti dominio della console Firebase ti chiederà di fornire un token per migrare il tuo sito esistente. Devi solo completare una delle seguenti operazioni per fornire il token:
Aggiorna i record DNS TXT : visita il sito di gestione DNS del tuo provider di dominio. Aggiungi un record TXT con la tua chiave di dominio e il valore fornito.
Attendi fino a 24 ore per la propagazione dei tuoi record TXT.
Carica un file su un sito esistente : carica il token sul tuo sito esistente all'URL specificato e verificane l'esistenza.
Questa pagina deve essere pubblicata su HTTPS e non deve essere valida o sicura. Il token crittografato è valido solo per un tentativo. Se la migrazione non riesce, verrà generato un nuovo token per i tuoi record.
Attendere il tempo per il provisioning del certificato SSL . L'operazione potrebbe richiedere fino a 24 ore. Nella maggior parte dei casi, la propagazione dei tuoi record e il provisioning del tuo certificato SSL avverranno entro poche ore, a seconda del tuo provider di dominio.
Dopo aver eseguito il provisioning del certificato SSL, torna al sito di gestione DNS del tuo provider DNS per aggiungere i record DNS A che indirizzano la tua pagina a Firebase Hosting. Aggiungi e salva i record con i seguenti input:
L'host che indichi è il dominio su cui vuoi servire il contenuto; questo dominio può essere un dominio apex o un sottodominio.
Il tuo provider di dominio potrebbe elencare questo termine come "Nome host", "Nome" o "Dominio".
Valore : assegna un valore a ciascun record DNS A per indirizzare il tuo dominio agli indirizzi IP specificati.
Il tuo provider di dominio potrebbe elencare questo termine come "Dati", "Punta a", "Contenuto", "Indirizzo" o "Indirizzo IP".
Attendi il provisioning del certificato SSL
Dopo aver verificato la proprietà del dominio, effettuiamo il provisioning di un certificato SSL per il tuo dominio e lo distribuiamo nel nostro CDN globale entro 24 ore dall'indirizzamento dei tuoi record DNS A a Firebase Hosting.
Il tuo dominio verrà elencato come uno dei nomi alternativi del soggetto (SAN) nel certificato SSL FirebaseApp. È possibile visualizzare questo certificato utilizzando gli strumenti di sicurezza del browser. Durante il provisioning del dominio, potresti vedere un certificato non valido che non include il tuo nome di dominio. Questa è una parte normale del processo e si risolverà dopo che il certificato del tuo dominio sarà disponibile.
Per gli utenti della configurazione avanzata , il tuo sito web sarà ospitato dal tuo provider di hosting precedente fino a quando lo stato di configurazione nella pagina Firebase Hosting del tuo progetto non verrà aggiornato a Connesso .
La tua chiave di dominio personalizzata
Quando aggiungi o modifichi i record DNS, diversi provider di dominio si aspettano che tu inserisca input diversi per il campo Host all'interno dei loro siti di gestione DNS. Di seguito abbiamo raccolto input comuni da fornitori popolari. Consulta la documentazione del tuo provider di dominio per istruzioni dettagliate.
Tipo di dominio
Chiave di dominio personalizzata
Dominio dell'apice
Gli input comuni includono:
@
Il nome di dominio apex (ad esempio example .com )
Lasciando vuoto il campo Host
Sottodominio
Gli input comuni includono:
Il nome completo del sottodominio (ad esempio, app. example .com )
Solo la parte del sottodominio (ad esempio, solo app e tralasciando . example .com )
Solo www per il sottodominio di www. example .com
Provider di domini comuni
Ecco alcuni provider di dominio comuni e i tipi di input che ciascuno potrebbe richiedere. Queste informazioni vengono mantenute aggiornate il più possibile, ma fai riferimento alla documentazione del tuo provider di dominio per istruzioni dettagliate.
Cloudflare
Tipo
Ospite
Valore
Input di record TXT DNS
TXT
example .com
valore di verifica fornito nella console Firebase
DNS A registra gli input
UN
example .com
199.36.158.100
UN
www
199.36.158.100
Google Domains
Tipo
Ospite
Valore
Input di record TXT DNS
TXT
@
valore di verifica fornito nella console Firebase
DNS A registra gli input
UN
@
199.36.158.100
UN
www
199.36.158.100
DNS di Google Cloud
Tipo
Ospite
Valore
Input di record TXT DNS
TXT
example .com
valore di verifica fornito nella console Firebase
DNS A registra gli input
UN
example .com
199.36.158.100
UN
www
199.36.158.100
NomeCheap
Tipo
Ospite
Valore
Input di record TXT DNS
TXT
@
valore di verifica fornito nella console Firebase
DNS A registra gli input
UN
@
199.36.158.100
UN
@
199.36.158.100
Squarespace
Tipo
Ospite
Valore
Input di record TXT DNS
TXT
@
valore di verifica fornito nella console Firebase
DNS A registra gli input
UN
@
199.36.158.100
UN
www
199.36.158.100
Configura le descrizioni dello stato per i domini personalizzati
Stato
Descrizione
Necessita di installazione
Potrebbe essere necessario modificare una configurazione con i tuoi record DNS.
Nella maggior parte dei casi, i tuoi record DNS A non si sono propagati dal tuo provider di nomi di dominio ai server Firebase Hosting. Suggerimento per la risoluzione dei problemi: se sono trascorse più di 24 ore, controlla di aver indirizzato i tuoi record a Firebase Hosting.
In casi più rari, soprattutto se utilizzi il flusso Configurazione avanzata, le verifiche SSL potrebbero non riuscire perché:
I tuoi record DNS hanno record A o record CNAME che puntano ad altri provider di hosting. Suggerimento per la risoluzione dei problemi: verifica che i tuoi record A puntino solo a Firebase Hosting e rimuovi tutti i record CNAME.
La migrazione non è riuscita e il token (record DNS TXT o file caricato fornito al tuo sito) ora non è valido. Suggerimento per la risoluzione dei problemi: fai clic su Visualizza per il dominio, quindi fornisci il nuovo token al tuo dominio esistente.
In attesa di
Hai configurato correttamente il tuo dominio personalizzato, ma Firebase Hosting non ha fornito un certificato SSL.
Occasionalmente, i seguenti problemi possono bloccare il conio di un certificato SSL per un dominio personalizzato:
I tuoi registri CAA sono troppo restrittivi. Suggerimento per la risoluzione dei problemi: assicurati che le autorità di certificazione `letsencrypt.org` e `pki.goog` siano autorizzate a creare certificati SSL per il tuo dominio.
Il tuo codice sfida non è valido. Se stai utilizzando il flusso Configurazione avanzata e la migrazione non è riuscita, il tuo token (e il relativo codice di verifica) ora non sono validi. Suggerimento per la risoluzione dei problemi: fai clic su Visualizza per il dominio, quindi fornisci il nuovo token al tuo dominio esistente.
Hai richiesto certificati per troppi sottodomini. Suggerimento per la risoluzione dei problemi: in genere, Firebase Hosting consiglia non più di 20 sottodomini su un dominio personalizzato apex, a causa dei limiti di conio del certificato SSL.
Collegato
Il tuo dominio personalizzato ha i record DNS corretti e ha un certificato SSL. Puoi pubblicare i contenuti del tuo sito.
Necessita di una nuova verifica
Firebase potrebbe richiedere di verificare nuovamente manualmente la proprietà del dominio se il record TXT aggiunto durante la verifica iniziale della proprietà del dominio è stato modificato o rimosso dalle impostazioni DNS del dominio.
Tieni presente che su un singolo dominio sono consentiti più record TXT con un token di verifica del sito di Google.
Richiediamo che il record TXT sia continuamente presente nelle tue impostazioni DNS in quanto ciò dimostra che sei il proprietario del dominio e ci autorizzi ad assegnare e rinnovare i certificati SSL per il tuo sito.
Suggerimento per la risoluzione dei problemi: visita la pagina di hosting del tuo progetto per completare il processo di nuova verifica entro il periodo di tempo specificato (in genere 30 giorni) per evitare che il tuo dominio personalizzato venga automaticamente disconnesso da Firebase Hosting.