Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Connetti un dominio personalizzato

Non devi rinunciare ai tuoi nomi di dominio unici e incentrati sul marchio con Firebase Hosting. È possibile utilizzare un dominio personalizzato (come example.com o app.example.com ) al posto di un dominio Firebase generati per il tuo sito Firebase-hosted.

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

Assicurarsi di aver completato la procedura guidata "Get Started" dal del progetto pagina Hosting Firebase in modo da avere un sito di hosting Firebase nel progetto Firebase.

Fase 1: Add dominio

  1. Dal progetto è la pagina di hosting , accedere alla procedura guidata per il collegamento di un dominio personalizzato:

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

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

  3. (Facoltativo) Selezionare la casella per reindirizzare tutte le richieste sul dominio personalizzato a un secondo dominio specificato (in modo tale che example.com e www.example.com redirect allo stesso contenuto).

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

Fase 2: Verificare la proprietà del dominio

Se richiesto nella procedura di installazione guidata Connetti Dominio, verificare il dominio apice.

Questi passaggi assicurano 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: Inserire la chiave di dominio apice .

      Dimostrare la tua proprietà di un dominio apex, o dominio radice, 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: Copiare il valore unico verifica 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. Lasciare fino a 24 ore per la propagazione dei tuoi record TXT aggiornati, quindi fare clic su Verifica.

    Si noti che è possibile fare clic su Annulla per sicurezza Chiudere la finestra Connetti dominio e riaprire in un secondo momento. Questo non influisce sul tempo di propagazione, ma verrà richiesto di inserire nuovamente il nome di dominio quando si riapre la finestra.

    Dopo tutto il tempo di propagazione, facendo clic Verificare nella finestra Connetti dominio della console Firebase consente di iniziare il processo di provisioning certificato SSL.

    Nella maggior parte dei casi, la propagazione dei tuoi record e la verifica del tuo dominio avverrà entro poche ore, a seconda del tuo provider di dominio. Fare riferimento alla documentazione del provider di dominio per istruzioni dettagliate sull'aggiunta di record TXT e tempi di propagazione.

    Se facendo clic Verificare i prompt un messaggio di errore, i record non si sono propagate oi tuoi valori potrebbero non essere corretti.

Fase 3: Vai in diretta

Nella finestra Connetti dominio della console Firebase, selezionare installazione rapida per un nuovo sito o di configurazione avanzata se si dispone già di un sito in esecuzione su un altro fornitore di hosting e bisogno di una migrazione a zero i tempi di inattività.

Attendi il provisioning del certificato SSL

Dopo aver verificato la proprietà del dominio, forniamo un certificato SSL per il tuo dominio e lo implementiamo nella nostra rete CDN globale entro 24 ore dopo che 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 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 avanzati di configurazione, il vostro sito sarà ospitato dal precedente fornitore di hosting fino a quando la status di configurazione nel del progetto Firebase Hosting pagina aggiornamenti Connected.

La tua chiave di dominio personalizzata

Quando si aggiunge o si modifica record DNS, diversi fornitori di dominio si aspettano di inserire input diversi per il campo Host all'interno dei loro siti di gestione DNS. Di seguito abbiamo compilato input comuni da fornitori popolari. Fare riferimento alla documentazione del provider di dominio per istruzioni dettagliate.

Tipo di dominio Chiave di dominio personalizzata
Dominio Apex

Gli ingressi comuni includono:

  • @
  • Il nome di dominio apice (ad esempio, example .com )
  • Lasciando il campo vuoto Host
Sottodominio

Gli ingressi comuni includono:

  • Il nome completo sottodominio (ad esempio, app. example .com )
  • Solo la porzione sottodominio (ad esempio, app solo, e lasciando fuori . example .com )
  • Solo www per il sottodominio di www. example .com

Provider di domini comuni

Ecco alcuni provider di domini 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.

Descrizioni dello stato di configurazione per i domini personalizzati

Stato Descrizione
Ha bisogno di configurazione

Potrebbe essere necessario modificare una configurazione con i 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, verifica di aver indirizzato i tuoi record a Firebase Hosting.

  • In casi più rari, soprattutto se stai utilizzando il flusso di configurazione avanzata, le sfide 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) non è più valido.
      Risoluzione dei problemi consiglio: Fare clic su Visualizza per il dominio, quindi fornire il nuovo token al dominio esistente.
In attesa di

Hai impostato 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 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 challenge non è valido.
    Se stai utilizzando il flusso di configurazione avanzata e la migrazione non è riuscita, il tuo token (e il relativo codice challenge) ora non sono validi.
    Risoluzione dei problemi consiglio: Fare clic su Visualizza per il dominio, quindi fornire il nuovo token al dominio esistente.
  • Hai richiesto i certificati per troppi sottodomini.
    Suggerimento per la risoluzione dei problemi: generalmente, 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 servire il contenuto del tuo sito.

Ha bisogno di una nuova verifica

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

  • Il record TXT aggiunto quando inizialmente verificato la proprietà del dominio è stato alterato o rimosso dalle impostazioni DNS del dominio.
    • Tieni presente che più record TXT con un token di verifica del sito di Google sono consentiti su un singolo dominio.
    • Richiediamo che il record TXT sia continuamente presente nelle tue impostazioni DNS in quanto ciò dimostra che possiedi il dominio e ci autorizza ad assegnare e rinnovare i certificati SSL per il tuo sito.
  • La persona che ha verificato la proprietà del dominio non viene più assegnato un ruolo IAM che contiene l'autorizzazione necessaria per verificare la proprietà del dominio. Questi ruoli includono Proprietario, Editor, Amministratore Firebase e Amministratore sviluppo Firebase.
Risoluzione dei problemi suggerimento: Visita del progetto pagina di hosting per completare il processo di ri-verifica all'interno della finestra di tempo specificato (in genere 30 giorni) per evitare il vostro dominio personalizzato automaticamente il distacco dal Firebase Hosting.