Non devi rinunciare ai tuoi nomi di dominio univoci e incentrati sul brand per le app di cui è stato eseguito il deployment su Firebase App Hosting. Puoi utilizzare un dominio personalizzato (come example.com o app.example.com) anziché un dominio generato da Firebase per il tuo sito ospitato su Firebase. Firebase App Hosting esegue il provisioning di un certificato SSL per ciascuno dei tuoi domini.
Il resto di questo documento illustra i passaggi per connettere un dominio personalizzato in uno dei seguenti modi:
Per evitare interruzioni del servizio, i record DNS devono essere aggiornati in un ordine specifico. Segui le istruzioni per eseguire la migrazione di un dominio in modo da prevenire tempi di inattività per la tua app.
Se i tempi di inattività non sono un problema, ad esempio quando colleghi un dominio nuovo alla tua app web, segui le istruzioni per collegare un nuovo dominio.
Prima di iniziare: tipi di record DNS
La procedura guidata App Hosting Configura dominio potrebbe chiederti di aggiungere o rimuovere da 1 a 5 record DNS, a seconda della configurazione attuale del dominio. Il tipo di un record ne determina la funzione. Questi sono i tipi di documenti che App Hosting potrebbe richiedere:
| Tipo | Descrizione | Esclusiva |
|---|---|---|
| A | Questi record contengono valori IPv4 (ad es. 8.8.8.8), che indicano ai browser quale indirizzo utilizzare quando tentano di contattare il tuo dominio. | Sì |
| AAAA | Questi record contengono valori IPv6 (ad es. 2001:4860:4860::8888), un tipo diverso di record di indirizzo con una funzione simile a quella dei record A. Al momento App Hosting non utilizza i record AAAA, ma ti chiederà di rimuovere quelli esistenti dal tuo dominio, se presenti. | Sì |
| CNAME | Questi record contengono un nome di dominio separato che deve essere utilizzato al posto del tuo dominio attuale per risolvere le query DNS. I record CNAME sono consentiti solo sui sottodomini (ad es. www.example.com). App Hosting utilizza i record CNAME per due motivi:
|
Sì |
| TXT | Questi record ti consentono di allegare metadati arbitrari al tuo dominio. App Hosting ti consente di utilizzare un formato specifico di record TXT, fah-claim=[UUID], per indicare quale dominio personalizzato deve essere utilizzato sul tuo dominio. |
No |
| CAA | Questi record fungono da lista consentita per specificare le autorità di certificazione autorizzate a generare certificati SSL per il tuo dominio. App Hosting richiede i record CAA solo se non è in grado di emettere certificati per il tuo dominio. | No |
Prima di iniziare: il tuo nome di dominio personalizzato
Quando aggiungi o modifichi i record DNS, i diversi provider di dominio si aspettano che tu inserisca input diversi per il campo Host (o Nome host) all'interno dei loro siti di gestione DNS. La procedura guidata per i domini personalizzati di App Hosting richiede di inserire lo stesso valore nel campo Nome.
Di seguito abbiamo raccolto gli input comuni dei provider più utilizzati. Per istruzioni dettagliate, consulta la documentazione del tuo provider di dominio.
| Tipo di dominio | Nome dominio personalizzato |
|---|---|
| Dominio apex |
Gli input più comuni includono:
|
| Sottodominio | Gli input più comuni includono:
|
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 consulta la documentazione del tuo provider di dominio per istruzioni dettagliate.
Esegui la migrazione di un dominio
Se vuoi trasferire il tuo dominio da un altro provider a App Hosting senza tempi di inattività, puoi utilizzare il flusso Esegui la migrazione di un dominio nella console Firebase. Questo flusso ti guida attraverso una procedura in due passaggi che prepara App Hosting a pubblicare contenuti sul tuo dominio prima di indirizzare il traffico ai server App Hosting.
Passaggio 1: aggiungi un dominio personalizzato
- Nella console Firebase, vai a Hosting e serverless > App Hosting.
- Seleziona un backend App Hosting utilizzando l'opzione Visualizza dashboard.
- Seleziona la scheda Impostazioni e poi fai clic su Aggiungi dominio personalizzato.
- Inserisci il nome di dominio personalizzato che vuoi collegare al tuo sito App Hosting.
- (Facoltativo) Seleziona la casella per reindirizzare tutte le richieste sul dominio personalizzato a un secondo dominio specificato (in modo che
example.comewww.example.comreindirizzino agli stessi contenuti). - Fai clic su Continua con la configurazione per configurare i record DNS e completare la configurazione del dominio personalizzato.
Passaggio 2: prepara il dominio
- Seleziona la scheda Esegui la migrazione di un dominio della procedura guidata Configura dominio.
- Segui le istruzioni del primo passaggio, Prepara il dominio, che include l'insieme di modifiche necessarie affinché App Hosting possa gestire il tuo backend preferito e stabilire connessioni TLS sicure per il tuo dominio. Aggiungi, rimuovi e salva i record del tuo dominio nel tuo provider DNS con i seguenti input per i record richiesti:
- Nome: inserisci il nome di dominio personalizzato per i record. L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio apex o un sottodominio. Il tuo provider di dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio".
- Tipo di record: aggiungi il record DNS fornito.
- Valore: assegna il valore fornito ai tuoi record. Il tuo provider di dominio potrebbe indicare questo termine come "Dati", "Punta a", "Contenuti", "Indirizzo" o "Indirizzo IP". Il contenuto del campo del valore varia in base al tipo di record. Ad esempio, i record TXT sono stringhe.
- Seleziona Verifica record. App Hosting tenterà di rilevare le modifiche apportate nel provider del dominio. La propagazione delle modifiche può richiedere fino a 24 ore. Puoi controllare lo stato nella visualizzazione Impostazioni > Domini nella dashboard di backend.
Passaggio 3: indirizza a App Hosting
- Dopo che App Hosting ha verificato gli aggiornamenti dei record del passaggio precedente,
la procedura guidata passa al passaggio finale Indirizza a App Hosting. Questo passaggio mostra gli aggiornamenti dei record che devi apportare per indirizzare il traffico del tuo dominio ai server App Hosting. Come prima, aggiungi, rimuovi e salva i record del tuo dominio nel provider DNS con i seguenti input per i record richiesti:
- Nome: inserisci il nome di dominio personalizzato per i record. L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio apex o un sottodominio. Il tuo provider di dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio".
- Tipo di record: aggiungi il record DNS fornito.
- Valore: assegna il valore fornito ai tuoi record. Il tuo provider di dominio potrebbe indicare questo termine come "Dati", "Punta a", "Contenuti", "Indirizzo" o "Indirizzo IP". Il contenuto del campo del valore varia in base al tipo di record. Ad esempio, i record TXT sono stringhe.
- Seleziona Verifica record. App Hosting tenterà di rilevare le modifiche apportate nel provider del dominio. La propagazione delle modifiche può richiedere fino a 24 ore. Puoi controllare lo stato nella visualizzazione Impostazioni > Domini nella dashboard di backend.
Collega un nuovo dominio
Se i tempi di inattività non sono un problema, ad esempio quando colleghi un dominio nuovo per la tua app web, segui le istruzioni riportate in questa sezione.
Passaggio 1: aggiungi un dominio personalizzato
- Nella console Firebase, vai a Hosting e serverless > App Hosting.
- Seleziona un backend App Hosting utilizzando l'opzione Visualizza dashboard.
- Seleziona la scheda Impostazioni e poi fai clic su Aggiungi dominio personalizzato.
- Inserisci il nome di dominio personalizzato che vuoi collegare al tuo sito App Hosting.
- (Facoltativo) Seleziona la casella per reindirizzare tutte le richieste sul dominio personalizzato a un secondo dominio specificato (in modo che
example.comewww.example.comreindirizzino agli stessi contenuti). - Fai clic su Continua con la configurazione per configurare i record DNS e completare la configurazione del dominio personalizzato.
Passaggio 2: verifica i record DNS
- La procedura guidata Configura dominio della console Firebase mostrerà i record necessari che devono essere aggiornati per indirizzare la tua pagina a Firebase App Hosting. Aggiungi, rimuovi e salva i record del tuo dominio nel tuo provider DNS con i seguenti input:
- Nome: inserisci il nome di dominio personalizzato per i record. L'host che indichi è il dominio su cui vuoi pubblicare i contenuti. Questo dominio può essere un dominio apex o un sottodominio. Il tuo provider di dominio potrebbe indicare questo termine come "Nome host", "Nome" o "Dominio".
- Tipo di record: aggiungi il record DNS fornito.
- Valore: assegna il valore fornito ai tuoi record. Il tuo provider di dominio potrebbe indicare questo termine come "Dati", "Punta a", "Contenuti", "Indirizzo" o "Indirizzo IP". Il contenuto del campo del valore varia in base al tipo di record. Ad esempio, i record TXT sono stringhe.
- Seleziona Verifica record. App Hosting tenterà di rilevare le modifiche apportate nel provider del dominio. La propagazione delle modifiche può richiedere fino a 24 ore. Puoi controllare lo stato nella visualizzazione Impostazioni > Domini nella dashboard di backend.
Attendi il provisioning del certificato SSL
App Hosting può richiedere fino a qualche ora per eseguire il provisioning di un certificato SSL per il tuo dominio dopo l'aggiornamento dei record DNS. In alcuni casi, potrebbero essere necessarie fino a 24 ore dopo aver indirizzato il DNS a Firebase App Hosting.
Puoi visualizzare questo certificato utilizzando gli strumenti di sicurezza del browser. Durante il provisioning del dominio, potresti visualizzare un certificato non valido o riscontrare problemi di connessione al dominio. Si tratta di una parte normale del processo e il problema verrà risolto quando il certificato del tuo dominio sarà disponibile.
Nota: Firebase App Hosting esegue automaticamente il provisioning dei certificati SSL, se necessario, per i domini personalizzati.
Descrizioni degli stati per i domini personalizzati
| Stato | Descrizione |
|---|---|
| Configurazione richiesta |
Potresti dover modificare una configurazione con i record DNS.
|
| In attesa | Hai configurato correttamente il tuo dominio personalizzato, ma Firebase App Hosting non ha eseguito il provisioning di un certificato SSL. In alcuni casi, record CAA eccessivamente restrittivi possono bloccare la creazione di un certificato SSL per un dominio personalizzato. Assicurati che le autorità di certificazione "letsencrypt.org" e "pki.goog" siano autorizzate a creare certificati SSL per il tuo dominio. |
| Creazione del certificato | È in corso la creazione di un certificato SSL per il tuo dominio. |
| Connesso | Il tuo dominio personalizzato dispone dei record DNS corretti e di un certificato SSL. |