Come collego il mio dominio a GitHub Pages?

Cosa mi serve prima di collegare un dominio a GitHub Pages?

DotAlmanac è una guida alle estensioni dei domini e un registrar: confronta ogni estensione, poi registrala senza KYC e paga in crypto. Per seguire questa guida ti servono tre cose.

• Un dominio sui nameserver di DotAlmanac. Nella scheda Nameservers del dominio deve leggersi "Our nameservers". Se il dominio usa altri nameserver, aggiungi gli stessi record presso quel provider DNS.
• Un repository con GitHub Pages attivo. Può pubblicare da un branch o da un workflow di GitHub Actions.
• Il tuo nome utente o nome dell'organizzazione GitHub. Va nel record www. Mai il nome del repository.

Molti sviluppatori scelgono .dev o .app per il sito di un progetto. Controlla prima il rinnovo: secondo la griglia prezzi di DotAlmanac, .dev si rinnova al 44% in più rispetto al prezzo del primo anno e .app al 67% in più, al 29 ottobre 2026. Un .dev costa 8,99 USD/anno, poi 12,99 USD/anno. Entrambe le estensioni richiedono HTTPS, che GitHub Pages fornisce. Confrontale su .app vs .dev.

Posso incollare i record come file di zona?

Sì. Apri DNS › Importa / esporta › Importa file di zona, scegli "Aggiungi ai record esistenti" e incolla le righe qui sotto. Sostituisci octocat con il tuo nome utente. L'importazione legge la sintassi BIND standard, mostra un'anteprima e non invia nulla prima che tu salvi.

@    3600  IN  A      185.199.108.153
@    3600  IN  A      185.199.109.153
@    3600  IN  A      185.199.110.153
@    3600  IN  A      185.199.111.153
@    3600  IN  AAAA   2606:50c0:8000::153
@    3600  IN  AAAA   2606:50c0:8001::153
@    3600  IN  AAAA   2606:50c0:8002::153
@    3600  IN  AAAA   2606:50c0:8003::153
www  3600  IN  CNAME  octocat.github.io.

Devo usare il dominio senza www o con www su GitHub Pages?

Configura entrambi e inserisci quello che preferisci nel repository. Quando i record dell'apex e di www sono corretti, GitHub Pages reindirizza l'altro verso di esso.

GitHub supporta un dominio apex o un nome www per sito. Non supporta due domini apex, due nomi www, né un apex combinato con un altro sottodominio personalizzato. Per un progetto su un sottodominio, come docs.example.com, aggiungi un CNAME da docs a USERNAME.github.io e salta i record A.

Quanto tempo ci vuole perché il mio dominio funzioni su GitHub Pages?

Dipende dal TTL dei record che i resolver hanno visto prima della tua modifica. Il TTL è il numero di secondi per cui un resolver tiene una risposta nella sua cache.

• Un nome senza record precedenti si risolve appena salvi.
• Un record sostituito mantiene il vecchio valore in alcune cache finché il suo vecchio TTL non scade. I record del template usano 3600 secondi, cioè un'ora.
• Pianifica uno spostamento in anticipo: abbassa il TTL dei vecchi record a 300 secondi un giorno prima della modifica.

La documentazione di GitHub dice che le modifiche DNS possono richiedere fino a 24 ore per propagarsi. Il certificato HTTPS arriva dopo che il controllo DNS va a buon fine.

Perché GitHub dice che il mio dominio non è configurato correttamente?

Nella maggior parte dei casi, un vecchio record risponde ancora per lo stesso nome. Controlla questi punti in ordine:

• Record residui. Un vecchio record A, AAAA o ALIAS su @, o un record di parcheggio, compete con quelli di GitHub. Il template li rimuove; le modifiche manuali spesso ne saltano uno.
• Nome del repository nel CNAME. Il target di www è solo USERNAME.github.io.
• Record wildcard. GitHub avverte che un record come *.example.com crea un rischio di domain takeover. Eliminalo.
• Altri nameserver. Se il dominio usa un altro provider DNS, i record nella scheda DNS di DotAlmanac non vengono serviti.
• Record CAA. Se pubblichi record CAA, GitHub ne richiede almeno uno con il valore letsencrypt.org per HTTPS.

Prova il risultato con dig example.com +short o con qualsiasi lookup DNS online.