Domini personalizzati
Servi la documentazione dal tuo dominio invece del sottodominio predefinito *.jamdesk.app. Configurazione DNS per sottodomini e domini apex, SSL e verifica.
Servi la documentazione dal tuo dominio invece del sottodominio predefinito *.jamdesk.app.
Panoramica della configurazione
Vai su Settings → Domain del tuo progetto e inserisci il dominio (ad esempio docs.example.com o example.com).
Aggiungi al tuo provider DNS i record mostrati nella dashboard. I record dipendono dal tipo di dominio (vedi sotto).
Jamdesk verifica la proprietà e predispone un certificato SSL.
Opzioni di hosting
Scegli una modalità di hosting quando aggiungi un dominio.
Dominio standard
Jamdesk serve la documentazione direttamente sul tuo dominio personalizzato:
docs.example.com → acme.jamdesk.appIl DNS punta a Jamdesk. Jamdesk emette e rinnova il certificato SSL.
Hosting su /docs (proxy, sottopercorso personalizzabile)
La documentazione si trova in un sottopercorso del tuo sito web esistente:
example.com/docs → acme.jamdesk.app/docs/docs è il valore predefinito. Puoi scegliere qualsiasi sottopercorso di un solo segmento (/help, /guide e così via) dallo stesso selettore. Configura un proxy (Cloudflare, Vercel, nginx, ecc.) per inoltrare a Jamdesk le richieste per quel sottopercorso. Consulta Hosting in un sottopercorso per le guide di configurazione e le regole per scegliere un sottopercorso.
Attivare o disattivare "Host at a subpath" o cambiare il sottopercorso avvia una nuova build. La struttura degli URL cambia.
Configurazione DNS
I record necessari dipendono dal fatto che tu stia usando un sottodominio o un dominio apex (radice).
Sottodomini (ad esempio docs.example.com)
| Tipo | Nome | Valore |
|---|---|---|
| CNAME | docs | cname.jamdesk.com |
| TXT | _jamdesk.docs | (mostrato nella dashboard) |
Il campo "Name" è la parte del sottodominio. Per docs.example.com, inserisci docs.
Domini apex (ad esempio example.com)
| Tipo | Nome | Valore |
|---|---|---|
| A | @ | 76.76.21.21 |
| TXT | _jamdesk | (mostrato nella dashboard) |
I domini apex usano un record A al posto del CNAME. Gli standard DNS (RFC 1034) vietano i record CNAME sull'apice della zona.
Le modifiche al DNS possono richiedere fino a 48 ore per propagarsi. La maggior parte si completa in pochi minuti. Controlla lo stato su whatsmydns.net.
Verifica
Jamdesk esegue questi passaggi dopo che hai aggiunto i record DNS:
- Rileva i tuoi record DNS (CNAME o record A, più TXT)
- Verifica la proprietà del dominio tramite il record TXT
- Predispone un certificato SSL tramite Let's Encrypt
- Instrada il traffico verso la tua documentazione
Controlla lo stato della verifica in Settings → Domain. Lo stato può essere:
- Pending - In attesa della propagazione DNS
- Active - Dominio verificato e attivo
- Needs Attention - Configurazione non corrispondente o conflitto (controlla la notifica via email)
- Error - Problema di configurazione (vedi i dettagli nella dashboard)
Fai clic su Refresh nella dashboard per controllare subito lo stato della verifica.
Certificati SSL
Jamdesk predispone i certificati SSL e li rinnova prima della scadenza. Le richieste HTTP vengono reindirizzate a HTTPS.
Domini radice
I domini radice (apex) come example.com funzionano. La dashboard mostra un record A che punta a 76.76.21.21 invece di un CNAME. Gli standard DNS vietano i record CNAME sull'apice della zona.
Più domini
Ogni progetto ha un solo dominio personalizzato. Per far puntare altri domini alla stessa documentazione:
- Configura il dominio principale in Jamdesk
- Configura i domini aggiuntivi per reindirizzare al principale a livello DNS/CDN
Rimozione di un dominio
- Vai su Settings → Domain
- Fai clic su Remove Domain
- La documentazione resta accessibile al sottodominio
*.jamdesk.app
Rimuovere un dominio con "Host at a subpath" attivo avvia una nuova build per aggiornare i percorsi degli URL. Jamdesk cancella anche qualsiasi sottopercorso personalizzato. Un dominio che ricolleghi in seguito ripartirà dal valore predefinito /docs.
Utenti Cloudflare
Segui questi passaggi se Cloudflare è il tuo provider DNS:
- Imposta lo stato del proxy su DNS only (icona nuvola grigia) durante la verifica del dominio
- Lascia che sia Vercel a gestire SSL: disattiva "Always Use HTTPS" di Cloudflare per il sottodominio della documentazione
- Dopo il completamento della verifica, puoi riattivare il proxy (nuvola arancione)
Usi un Cloudflare Worker? Il record DNS deve essere proxato (nuvola arancione) perché il Worker venga eseguito. Usa la nuvola grigia solo durante la verifica, poi ripristina l'arancione. Consulta configurazione dei Cloudflare Workers per i dettagli.
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| Dominio bloccato su "Pending" | Controlla i record DNS con dig (CNAME per i sottodomini, A per i domini apex) |
| Errori del certificato SSL | Assicurati che nessun record CAA blocchi Let's Encrypt |
| Loop di reindirizzamento | Se usi Cloudflare, imposta la nuvola grigia durante la verifica (vedi Utenti Cloudflare sopra) |
| CNAME non risolto | Verifica il record presso il provider DNS e attendi la propagazione |
| Dominio già in uso | Il dominio è registrato in Vercel da una configurazione precedente; la verifica di solito si completa automaticamente |
Verifica il DNS con dig
# Check CNAME record (subdomains)
dig CNAME docs.example.com
# Check A record (apex domains)
dig A example.com
# Check TXT record
dig TXT _jamdesk.example.comPer diagnosi dettagliate, consulta Risoluzione problemi DNS.
Il sottodominio jamdesk.app compete con il mio dominio nei risultati di ricerca?
No. Le pagine servite dal tuo sottodominio [slug].jamdesk.app includono un link canonico che punta al tuo dominio personalizzato attivo. I motori di ricerca attribuiscono al tuo dominio i segnali di ranking.