Résolution des problèmes liés aux domaines personnalisés et aux pages GitHub Pages

Vous pouvez rechercher des erreurs courantes pour résoudre les problèmes liés aux domaines personnalisés ou HTTPS pour votre site GitHub Pages.

Qui peut utiliser cette fonctionnalité ?

GitHub Pages est disponible dans les référentiels publics avec GitHub Free et GitHub Free pour les organisations, et dans les référentiels publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server. Pour plus d’informations, consultez « Plans de GitHub ».

GitHub Pages utilise désormais GitHub Actions pour exécuter la version de Jekyll. Lorsque vous utilisez une branche comme source de votre version, GitHub Actions doit être activé dans votre référentiel si vous souhaitez utiliser le flux de travail Jekyll prédéfini. Comme alternative, si GitHub Actions n’est pas disponible ou désactivé, l’ajout d’un fichier .nojekyll à la racine de votre branche source contournera le processus de version de Jekyll et déploiera le contenu directement. Pour plus d'informations sur l'activation des GitHub Actions, consultez « Gestion des paramètres de GitHub Actions pour un dépôt ».

Dans cet article

Erreurs de CNAME

Si vous publiez à partir d'un flux de travail GitHub Actions personnalisé, tout fichier CNAME est ignoré et n'est pas nécessaire.

Si vous publiez à partir d’une branche, les domaines personnalisés sont stockés dans un fichier CNAME à la racine de votre source de publication. Vous pouvez ajouter ou mettre à jour ce fichier via vos paramètres de dépôt, ou bien manuellement. Pour plus d’informations, consultez « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Pour que votre site soit rendu sur le domaine approprié, vérifiez que votre fichier CNAME existe toujours dans le dépôt. Par exemple, de nombreux générateurs de sites statiques forcent l’envoi (push) vers votre dépôt, ce qui peut remplacer le fichier CNAME qui a été ajouté à votre dépôt quand vous avez configuré votre domaine personnalisé. Si vous générez votre site localement et que vous poussez les fichiers générés vers GitHub, veillez à d’abord tirer (pull) le commit qui a ajouté le fichier CNAME à votre dépôt local, de sorte que le fichier soit inclus dans la build.

Vérifiez ensuite que le fichier CNAME est correctement mis en forme.

  • Le nom du fichier CNAME doit être en majuscules.
  • Le fichier CNAME ne peut contenir qu’un seul domaine. Pour faire pointer plusieurs domaines vers votre site, vous devez configurer une redirection via votre fournisseur DNS.
  • Le fichier CNAME doit contenir seulement le nom de domaine. Par exemple, www.example.com, blog.example.com ou example.com.
  • Le nom de domaine doit être unique parmi tous les sites GitHub Pages. Par exemple, si le fichier CNAME d’un autre dépôt contient example.com, vous ne pouvez pas utiliser example.com dans le fichier CNAME pour votre dépôt.

Configuration DNS incorrecte

Si vous rencontrez des problèmes pour faire pointer le domaine par défaut pour votre site vers votre domaine personnalisé, contactez votre fournisseur DNS.

Vous pouvez aussi utiliser une des méthodes suivantes pour tester si les enregistrements DNS de votre domaine personnalisé sont correctement configurés :

Noms de domaine personnalisés qui ne sont pas pris en charge

Si votre domaine personnalisé n’est pas pris en charge, il peut être nécessaire de changer votre domaine pour un domaine pris en charge. Vous pouvez aussi contacter votre fournisseur DNS pour voir s’il offre des services de transfert pour les noms de domaine.

Vérifiez que votre site :

  • N’utilise pas plusieurs domaines apex. Par exemple, example.com et anotherexample.com.

  • N’utilise pas plusieurs sous-domaines www. Par exemple, www.example.com et www.anotherexample.com.

  • N’utilise pas à la fois un domaine apex et un sous-domaine personnalisé. Par exemple, example.com et docs.example.com.

    La seule exception est le sous-domaine www. S’il est configuré correctement, le sous-domaine www est redirigé automatiquement vers le domaine apex. Pour plus d’informations, consultez « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Warning

Nous vous recommandons vivement de ne pas utiliser d’enregistrements DNS génériques, tels que *.example.com. Ces enregistrements vous exposent à un risque immédiat de prise de contrôle de domaine, même si vous vérifiez le domaine. Par exemple, si vous vérifiez example.com, vous empêchez un tiers d’utiliser a.example.com, mais cette personne peut toujours prendre le contrôle de b.a.example.com (couvert par l’enregistrement DNS générique). Pour plus d’informations, consultez « Vérification de votre domaine personnalisé pour GitHub Pages ».

Pour obtenir la liste des domaines personnalisés pris en charge, consultez À propos des domaines personnalisés et des pages GitHub.

Erreurs HTTPS

Les sites GitHub Pages en utilisant des domaines personnalisés correctement configurés avec des enregistrements DNS CNAME, ALIAS, ANAME ou A sont accessibles via HTTPS. Pour plus d’informations, consultez « Sécurisation de votre site GitHub Pages avec HTTPS ».

Cela peut prendre jusqu’à une heure pour que votre site devienne disponible via HTTPS après avoir configuré votre domaine personnalisé. Après avoir mis à jour les paramètres DNS existants, il peut être nécessaire de supprimer et de réajouter votre domaine personnalisé au dépôt de votre site pour déclencher le processus d’activation du protocole HTTPS. Pour plus d’informations, consultez « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Si vous utilisez des enregistrements d’autorisation d’autorité de certification (CAA), au moins un enregistrement CAA doit exister avec la valeur letsencrypt.org pour que votre site soit accessible via HTTPS. Pour plus d’informations, consultez Autorisation d’autorité de certification (CAA) dans la documentation Let’s Encrypt.

Mise en forme d’URL sur Linux

Si l’URL de votre site contient un nom d’utilisateur ou un nom d’organisation qui commence ou se termine par un tiret, ou contient des tirets consécutifs, les personnes qui naviguent avec Linux vont recevoir une erreur du serveur quand elles tentent de visiter votre site. Pour résoudre ce problème, modifiez votre nom d’utilisateur GitHub en y supprimant les caractères non alphanumériques. Pour plus d’informations, consultez « Modification de votre nom d’utilisateur GitHub ».

Cache du navigateur

Si vous avez récemment modifié ou supprimé votre domaine personnalisé et que vous ne pouvez pas accéder à la nouvelle URL dans votre navigateur, il peut être nécessaire d’effacer le cache de votre navigateur pour atteindre la nouvelle URL. Pour plus d’informations sur l’effacement de votre cache, consultez la documentation de votre navigateur.

Nom de domaine pris

Si vous essayez d’utiliser un domaine personnalisé et qu’il indique que le domaine est déjà utilisé, vous pouvez rendre le domaine disponible pour votre propre utilisation en le vérifiant d’abord. Pour plus d’informations, consultez « Vérification de votre domaine personnalisé pour GitHub Pages ».