Collega un dominio personalizzato

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 fornisce i tuoi contenuti su una 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 un dominio personalizzato

  1. Dalla pagina Hosting del tuo progetto, entra nella procedura guidata per connettere un dominio personalizzato:

    • Se disponi di un solo sito di hosting, fai clic su Aggiungi dominio personalizzato .
    • Se disponi di più siti di hosting , fai clic su Visualizza per il sito desiderato, quindi fai clic su Aggiungi dominio personalizzato .
  2. Inserisci il nome di dominio personalizzato che desideri connettere al tuo sito Hosting.

  3. (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).

  4. Fai clic su Continua per configurare i tuoi record DNS e completare la configurazione del tuo dominio personalizzato.

Passaggio 2 : imposta il dominio personalizzato

Se richiesto nella procedura guidata di configurazione Connetti dominio , verifica il tuo dominio apex.

Questi passaggi garantiscono che il tuo dominio non sia già collegato a un progetto Firebase e che tu sia il proprietario del dominio specificato.

  1. Nel sito del tuo provider di dominio, individua la pagina di gestione DNS.

  2. 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".

    • Host : inserisci la chiave del tuo dominio Apex .

      Dimostrare la tua proprietà di un dominio apex, o dominio root, 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 verifica questo valore per dimostrare la proprietà del tuo dominio.

      Il tuo provider di dominio potrebbe elencare questo termine come "Dati".

  3. Consenti 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à richiesto di inserire nuovamente il nome del tuo dominio quando riapri la finestra.

    Dopo un ampio tempo di propagazione, facendo clic su Verifica nella finestra Connetti dominio della console Firebase è possibile avviare 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 provider del tuo dominio. Fai riferimento alla documentazione del tuo provider di 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 si sono propagati oppure i valori potrebbero essere errati.

Nella procedura guidata Aggiungi dominio personalizzato della console Firebase, seleziona Configurazione rapida o Configurazione avanzata .

La configurazione rapida può essere utilizzata per nuovi domini che attualmente non ricevono traffico o domini che stai tentando di trasferire da un altro sito di 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 inattività.

La procedura guidata di configurazione avanzata ti aiuterà a stabilire un certificato SSL e una dichiarazione di proprietà per consentire all'hosting di servire il traffico sul dominio prima di ricevere il traffico.

Attendi il provisioning del certificato SSL

Dopo aver verificato la proprietà del dominio, forniamo un certificato SSL per il tuo dominio e lo distribuiamo sulla nostra CDN globale entro 24 ore dal momento in cui hai indirizzato i tuoi record DNS A a Firebase Hosting.

Il tuo dominio verrà elencato come uno dei nomi alternativi soggetto (SAN) nel certificato SSL 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. Questa è una parte normale del processo e si risolverà quando il certificato del tuo dominio sarà disponibile.

Per gli utenti con configurazione avanzata , il tuo sito web sarà ospitato dal tuo precedente provider di hosting fino a quando lo stato di configurazione nella pagina Hosting Firebase del tuo progetto non verrà aggiornato a Connesso .

La tua chiave di dominio personalizzata

Quando si aggiungono o si modificano 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 provider del tuo dominio per istruzioni dettagliate.

Configura le descrizioni dello stato per i domini personalizzati

Stato Descrizione
Necessita di configurazione

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 provider del nome 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 si utilizza il flusso di 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 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 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 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" siano autorizzate a creare certificati SSL per il tuo dominio.
  • Il tuo codice di sfida non è valido.
    Se stai utilizzando il flusso di configurazione avanzata e la migrazione non è riuscita, il tuo token (e il relativo codice di verifica) ora non sono più validi.
    Suggerimento per la risoluzione dei problemi: fai clic su Visualizza per il dominio, quindi fornisci il nuovo token al 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 dei certificati SSL.
Certificato di conio

È in corso la produzione di un certificato SSL per il tuo dominio.

Collegato

Il tuo dominio personalizzato ha i record DNS corretti e dispone di un certificato SSL.
Puoi servire il contenuto del tuo sito.