Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Connetti un dominio personalizzato

Non devi rinunciare ai tuoi nomi di dominio univoci 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, firmato da Let's Encrypt , per ciascuno dei tuoi domini e serve i tuoi contenuti su una rete 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 Hosting Firebase del tuo progetto in modo da avere un sito Hosting Firebase nel tuo progetto Firebase.

Passaggio 1 : aggiungi dominio

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

    • Se hai un solo sito di hosting, fai clic su Connetti dominio .
    • Se hai più di un sito di hosting , fai clic su Visualizza per il sito desiderato, quindi fai clic su Connetti dominio .

  2. Inserisci il nome di dominio personalizzato che desideri connettere al tuo sito di hosting.

  3. (Facoltativo) Seleziona la casella per reindirizzare tutte le richieste sul dominio personalizzato su un secondo dominio specificato (ad example.com reindirizzamento di example.com e www.example.com sullo stesso contenuto).

  4. Fai clic su Continua per avviare il processo di convalida.

Passaggio 2 : verifica la proprietà del dominio

Se richiesto nella procedura guidata di configurazione del dominio Connect , verificare il dominio apex.

Questi passaggi assicurano che il tuo dominio non sia già collegato a un progetto Firebase e che possiedi il 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 di mantenere questo record TXT continuamente 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 può elencare questo termine come "Tipo di record".

    • Host : inserisci la tua chiave di dominio apex .

      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 può 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 può elencare questo termine come "Dati".

  3. Attendere fino a 24 ore per la propagazione dei record TXT aggiornati, quindi fare clic su Verifica .

    Si noti che è possibile fare clic su Annulla per chiudere in modo sicuro la finestra Connetti dominio e riaprire in un secondo momento. Ciò non influisce sul tempo di propagazione, ma ti verrà richiesto di reinserire il tuo nome di dominio quando riapri la finestra.

    Dopo un ampio tempo di propagazione, facendo clic su Verifica nella finestra Connetti dominio della console di 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. Consultare la documentazione del proprio provider di dominio per istruzioni dettagliate sull'aggiunta di record TXT e tempi di propagazione.

    Se facendo clic su Verifica viene richiesto un messaggio di errore, i record non si sono propagati o i valori potrebbero essere errati.

Passaggio 3 : vai in diretta

Nella finestra Connetti dominio della console di Firebase, seleziona Installazione rapida per un nuovo sito o Installazione avanzata se hai già un sito in esecuzione su un altro provider di hosting e hai bisogno di una migrazione zero-downtime.

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 distribuiamo sulla nostra rete CDN globale entro 24 ore dopo aver 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. È possibile visualizzare questo certificato utilizzando gli strumenti di sicurezza del browser. Durante il provisioning del dominio, è possibile che venga visualizzato un certificato non valido che non include il nome del dominio. Questa è una parte normale del processo e si risolverà quando sarà disponibile il certificato del tuo dominio.

Per gli utenti di Installazione 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 in Connesso .

La tua chiave di dominio personalizzata

Quando si aggiungono o si modificano record DNS, diversi provider di dominio si aspettano di immettere input diversi per il campo Host nei rispettivi siti di gestione DNS. Di seguito abbiamo compilato input comuni da provider popolari. Fare riferimento alla documentazione del proprio provider di dominio per istruzioni dettagliate.

Tipo di dominio Chiave di dominio personalizzata
Dominio Apex

Gli input comuni includono:

  • @
  • Il nome di dominio dell'apice (ad esempio, example .com )
  • Lasciare 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 dominio comuni

Ecco alcuni provider di dominio comuni e i tipi di input che ciascuno potrebbe richiedere. Queste informazioni sono mantenute il più aggiornate possibile, ma fai riferimento alla documentazione del tuo provider di dominio per istruzioni dettagliate.

Descrizioni dello stato di installazione per domini personalizzati

Stato Descrizione
Ha bisogno di installazione

Potrebbe essere necessario modificare una configurazione con i record DNS.

  • Nella maggior parte dei casi, i record DNS A non si sono propagati dal provider del nome di dominio ai server di hosting Firebase.
    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 installazione avanzata, le sfide SSL potrebbero non riuscire perché:

    • I tuoi record DNS hanno record A o CNAME che puntano ad altri provider di hosting.
      Suggerimento per la risoluzione dei problemi: controlla che i tuoi record A puntino solo a Hosting Firebase e rimuovi tutti i record CNAME.
    • Migrazione non riuscita e il token (record TXT DNS o file caricato fornito al tuo sito) non è ora valido.
      Suggerimento per la risoluzione dei problemi: fare clic su Visualizza per il dominio, quindi fornire il nuovo token al dominio esistente.
in sospeso

Hai impostato correttamente il tuo dominio personalizzato, ma Firebase Hosting non ha fornito un certificato SSL.

Occasionalmente, i seguenti problemi possono interrompere il conio di un certificato SSL per un dominio personalizzato:

  • I tuoi record CAA sono troppo restrittivi.
    Suggerimento per la risoluzione dei problemi: assicurati che l'autorità di certificazione Let's Encrypt sia autorizzata a creare certificati SSL per il tuo dominio.
  • Il tuo codice sfida non è valido.
    Se si utilizza il flusso di installazione avanzata e la migrazione non è riuscita, il token (e il relativo codice di verifica) non sono ora validi.
    Suggerimento per la risoluzione dei problemi: fare 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 non più di 20 sottodomini su un dominio personalizzato apice, a causa dei limiti di conio del certificato SSL.
Collegato

Il tuo dominio personalizzato ha i record DNS corretti e un certificato SSL.
Puoi pubblicare i contenuti del tuo sito.

Richiede una nuova verifica

Firebase potrebbe richiedere di ricontrollare manualmente la proprietà del dominio se si verifica una delle seguenti situazioni:

  • Il record TXT è stato aggiunto quando inizialmente hai verificato che la proprietà del tuo dominio è stata modificata o rimossa dalle impostazioni DNS del tuo dominio.
    • Tieni presente che sono consentiti più record TXT con un token di verifica del sito Google su un singolo dominio.
    • Richiediamo che il record TXT sia continuamente presente nelle impostazioni DNS poiché ciò dimostra che sei il proprietario del dominio e ci autorizza ad assegnare e rinnovare i certificati SSL per il tuo sito.
  • La persona che ha dimostrato la proprietà del dominio è stata rimossa come membro del progetto Firebase.
Suggerimento per la risoluzione dei problemi: visita la pagina Hosting del tuo progetto per completare il processo di nuova verifica entro l'intervallo di tempo specificato (in genere 30 giorni) per evitare che il tuo dominio personalizzato venga disconnesso automaticamente da Firebase Hosting.