Sottodomini Jamdesk
Il tuo sottodominio predefinito yourproject.jamdesk.app: regole di denominazione, come modificarlo e quando passare a un dominio personalizzato.
Ogni progetto Jamdesk riceve un sottodominio gratuito all'indirizzo yourproject.jamdesk.app. Questo è l'URL predefinito della documentazione e funziona subito dopo il primo deploy.
Come funzionano i sottodomini
Quando crei un progetto, Jamdesk assegna automaticamente un sottodominio basato sullo slug del progetto:
| Slug del progetto | Sottodominio |
|---|---|
my-docs | my-docs.jamdesk.app |
acme-api | acme-api.jamdesk.app |
company-help | company-help.jamdesk.app |
Il sottodominio diventa attivo non appena viene completato il primo build.
Regole per i nomi dei sottodomini
I sottodomini devono rispettare queste regole:
- Solo lettere minuscole, numeri e trattini
- Devono iniziare con una lettera
- Non possono iniziare o terminare con un trattino
- Devono contenere da 3 a 63 caratteri
- Devono essere univoci tra tutti i progetti Jamdesk
Modificare il sottodominio
Per modificare il sottodominio:
- Vai al tuo progetto nel Dashboard
- Apri Settings → General
- Aggiorna il campo Project Slug
- Fai clic su Save
La modifica del sottodominio interrompe i link esistenti. I motori di ricerca e i siti esterni che rimandano al vecchio sottodominio restituiranno errori 404. Se hai bisogno di mantenere stabili gli URL, valuta invece la configurazione di un dominio personalizzato.
Dopo la modifica:
- Il nuovo sottodominio è attivo immediatamente
- Il vecchio sottodominio restituisce 404
- I segnalibri e i link esterni smettono di funzionare
- Il posizionamento nei motori di ricerca viene azzerato
Certificati SSL
I certificati SSL vengono forniti automaticamente per tutti i sottodomini *.jamdesk.app. HTTPS è obbligatorio; le richieste HTTP vengono reindirizzate a HTTPS.
Limiti di frequenza
I sottodomini Jamdesk condividono l'infrastruttura con altri progetti. Per la documentazione ad alto traffico:
- Valuta un dominio personalizzato per ottenere risorse dedicate
- Contatta il supporto se prevedi un traffico elevato e costante
Quando usare un dominio personalizzato
Usa un dominio personalizzato quando:
- Hai bisogno di URL stabili (le modifiche al sottodominio interrompono i link)
- Vuoi pubblicare la documentazione all'indirizzo
docs.yourcompany.com - Devi utilizzare il dominio della tua azienda
- La documentazione è destinata ai clienti
Consulta Domini personalizzati per le istruzioni di configurazione.
Sottodominio o dominio personalizzato
| Funzionalità | Sottodominio | Dominio personalizzato |
|---|---|---|
| Tempo di configurazione | Immediato | 10-30 minuti |
| Costo | Gratuito | Gratuito (devi fornire il dominio) |
| Formato URL | project.jamdesk.app | docs.yourdomain.com |
| SSL | Automatico | Automatico |
| Branding | Con il branding Jamdesk | Il tuo branding |
| Stabilità dell'URL | Legata allo slug del progetto | Permanente |
