--- title: Dépannage DNS description: "Résolvez propagation DNS, conflits CNAME et échecs de vérification TXT sur vos domaines personnalisés. Commandes dig et correctifs par fournisseur inclus." --- Les problèmes DNS sont la cause la plus fréquente des difficultés liées aux domaines personnalisés. ## Vérifier la propagation DNS Les modifications DNS peuvent prendre jusqu'à 48 heures pour se propager dans le monde entier, bien que la plupart soient effectuées en quelques heures. Vérifiez l'état de la propagation : ```bash # Check if your CNAME is resolving dig CNAME docs.yourdomain.com # Or use nslookup nslookup -type=CNAME docs.yourdomain.com ``` Le résultat attendu montre votre CNAME pointant vers `cname.jamdesk.com` : ```text docs.yourdomain.com. 300 IN CNAME cname.jamdesk.com. ``` Des outils en ligne comme [whatsmydns.net](https://www.whatsmydns.net/) affichent la propagation dans plusieurs régions. ## Problèmes courants ### CNAME non résolu **Symptôme** : `dig` ne renvoie aucun enregistrement CNAME ou affiche une cible incorrecte. **Causes** : - Enregistrement non enregistré chez le fournisseur DNS - Faute de frappe dans le nom ou la valeur de l'enregistrement - Propagation DNS encore en cours **Correctif** : 1. Connectez-vous à votre fournisseur DNS 2. Vérifiez que l'enregistrement CNAME existe avec les valeurs correctes 3. Attendez 15 à 30 minutes et vérifiez à nouveau ### CNAME au domaine racine **Symptôme** : Le fournisseur DNS rejette un enregistrement CNAME pour `yourdomain.com` (sans sous-domaine). **Cause** : Les normes DNS (RFC 1034) interdisent les enregistrements CNAME à l'apex de zone (domaine racine). **Correctif** : Le dashboard Jamdesk affiche automatiquement un enregistrement A (`76.76.21.21`) à la place du CNAME pour les domaines apex. Si votre dashboard affiche toujours un CNAME pour un domaine apex, cliquez sur **Actualiser** pour obtenir les enregistrements mis à jour. ### Conflits avec le proxy Cloudflare **Symptôme** : Erreurs SSL ou boucles de redirection lors de l'utilisation de Cloudflare. **Cause** : Le proxy Cloudflare (nuage orange) peut interférer avec le SSL de Vercel. **Correctif** : 1. Dans les paramètres DNS Cloudflare, cliquez sur l'icône de nuage orange 2. Passez en mode « DNS uniquement » (nuage gris) pour votre sous-domaine de documentation 3. Laissez Vercel gérer le SSL ### Enregistrements conflictuels **Symptôme** : La vérification CNAME échoue même si l'enregistrement semble correct. **Cause** : Un enregistrement A existant entre en conflit avec le CNAME. **Correctif** : 1. Vérifiez la présence d'enregistrements A sur le même sous-domaine 2. Supprimez les enregistrements A conflictuels 3. Assurez-vous que seul le CNAME subsiste ```bash # Check for A records dig A docs.yourdomain.com ``` ### Échec de la vérification TXT **Symptôme** : L'enregistrement TXT pour l'hébergement en sous-chemin ne se vérifie pas. **Causes** : - Enregistrement ajouté au mauvais domaine - Faute de frappe dans la valeur de l'enregistrement - Enregistrements TXT existants causant des problèmes **Correctif** : 1. Vérifiez que l'enregistrement TXT est bien à `_jamdesk.yourdomain.com` 2. Copiez la valeur de vérification exacte depuis le dashboard 3. Vérifiez la présence d'enregistrements TXT conflictuels ```bash # Check TXT records dig TXT _jamdesk.yourdomain.com ``` ### Certificat SSL non émis **Symptôme** : Le domaine reste indéfiniment en statut « en attente ». **Causes** : - Des enregistrements CAA bloquent l'émission du certificat - DNS pas encore entièrement propagé - Domaine inaccessible **Correctif** : Vérifiez la présence d'enregistrements CAA : ```bash dig CAA yourdomain.com ``` Si des enregistrements CAA existent, ajoutez-en un autorisant Let's Encrypt : ```text yourdomain.com. CAA 0 issue "letsencrypt.org" ``` ## Commandes de diagnostic ```bash # Full DNS lookup dig +trace docs.yourdomain.com # Check all record types dig ANY docs.yourdomain.com # Check specific nameservers dig @8.8.8.8 docs.yourdomain.com # Check TTL (time to live) dig +noall +answer docs.yourdomain.com ``` ## Notes spécifiques aux fournisseurs DNS ### Cloudflare - Réglez le statut du proxy sur « DNS uniquement » (nuage gris) pendant la vérification du domaine - Une fois la vérification terminée, repassez en mode proxifié (nuage orange) - **Vous utilisez un Worker ?** L'enregistrement DNS doit être proxifié (nuage orange) pour que le Worker s'exécute. Nuage gris uniquement pendant la vérification, puis repassez en orange. - Désactivez « Always Use HTTPS » pour le sous-domaine de documentation afin d'éviter les conflits SSL avec Vercel ### GoDaddy - La cible CNAME ne doit PAS se terminer par un point - Les modifications peuvent prendre plus de temps à se propager ### Namecheap - Utilisez le type « CNAME Record » - Le champ Host correspond uniquement au sous-domaine (`docs`, pas `docs.yourdomain.com`) ### Route 53 - La cible CNAME DOIT se terminer par un point (`cname.jamdesk.com.`) - Evaluate target health : Non ## Quand contacter le support Contactez le support si : - Les enregistrements DNS sont vérifiés comme corrects mais le domaine reste en attente après 48 heures - Des erreurs de certificat SSL persistent après avoir suivi toutes les étapes - Vous constatez des erreurs spécifiques à l'infrastructure Jamdesk Incluez dans votre demande de support : - Votre nom de domaine - Le nom de votre fournisseur DNS - Le résultat des commandes `dig` - Une capture d'écran de la configuration DNS ## Et ensuite ? Erreurs SSL, échecs de vérification et chargement du mauvais site Guide complet de configuration des domaines personnalisés Hébergez à yourdomain.com/docs Joignez le résultat de dig et des captures d'écran DNS