Cosa configurerai
- Aggiungere un sottodominio o un dominio apex in Impostazioni → Domini e ottenere i record DNS da creare presso il tuo registrar.
- Verificare la proprietà — Elido esegue il polling DNS finché i tuoi record non sono visibili, di solito entro 60 secondi.
- Ottenere un certificato TLS Let's Encrypt fornito automaticamente da Caddy dopo la verifica.
Un dominio personalizzato sostituisce i nostri domini predefiniti f.elido.me / s.elido.me / b.elido.me nei tuoi URL abbreviati. La maggior parte dei team usa un sottodominio come links.acme.com o go.acme.com; funzionano anche i domini apex.
Prima di iniziare#
Hai bisogno di:
- Un workspace su piano Pro o Business (il piano Free usa solo il nostro dominio condiviso).
- Accesso ai record DNS del tuo registrar di domini.
- Circa cinque minuti — la maggior parte dei quali è attesa per la propagazione DNS.
Aggiungilo nella dashboard#
- Impostazioni → Domini → Aggiungi dominio.
- Digita l'hostname. Sottodominio (
links.acme.com) o apex (acme.link) — funzionano entrambi. - Mostriamo i record DNS da creare. Per i sottodomini è un singolo
CNAME. Per l'apex sono due recordA(Hetzner FRA + OVH FRA) e un recordAAAA(IPv6). - Aggiungi i record nel tuo registrar.
- Fai clic su Verifica. Eseguiamo il polling DNS finché non vediamo i tuoi record (di solito meno di un minuto, occasionalmente fino a un'ora per propagazione lenta).
TLS#
Una volta verificato il dominio, Caddy provvede automaticamente a un certificato TLS tramite Let's Encrypt. La prima richiesta dopo la verifica potrebbe richiedere 1–3 secondi mentre il certificato viene emesso; le richieste successive sono immediate. Teniamo traccia della scadenza del certificato e lo rinnoviamo a 30 giorni, con avvisi se il rinnovo fallisce.
Note DNS#
- Record CAA: se il tuo dominio ha record CAA, aggiungi
letsencrypt.orgtra le CA autorizzate. Altrimenti l'emissione del certificato fallisce. - Proxy Cloudflare: disattiva il cloud arancione per il record. I record proxati nascondono l'IP del visitatore, il che rompe le nostre analisi geo, e interferiscono anche con il handshake TLS on-demand di Caddy.
- AAAA / IPv6: opzionale ma consigliato. Le reti mobili in Europa sono sempre più solo IPv6.
Wildcard#
I piani Business possono configurare un dominio wildcard (*.links.acme.com). Utile quando vuoi un host per link abbreviati per business unit ma un solo record DNS da gestire.
Risoluzione dei problemi#
Se il pulsante Verifica rimane grigio per più di un'ora:
- Esegui
dig links.acme.com CNAMEdal tuo laptop. Se il record non è ancora lì, il tuo registrar non ha ancora propagato. - Verifica che il target del CNAME corrisponda esattamente a quello che ti abbiamo mostrato — i refusi sono la causa #1 delle verifiche bloccate.
- Controlla la nostra pagina di stato per eventuali problemi DNS/TLS in corso.
Se sei ancora bloccato, incolla l'output di dig nella chat e lo risolveremo insieme.