Skip to main content

À propos des domaines personnalisés et des pages GitHub

GitHub Pages prend en charge l’utilisation de domaines personnalisés ou la modification de la racine de l’URL de votre site par défaut, par exemple octocat.github.io, en n’importe quel domaine que vous possédez.

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 ».

Domaines personnalisés pris en charge

Conseil : nous vous recommandons de vérifier votre domaine personnalisé avant de l’ajouter à votre dépôt afin d’améliorer la sécurité et d’éviter les attaques de prise de contrôle. Pour plus d’informations, consultez « Vérification de votre domaine personnalisé pour GitHub Pages ».

Sur GitHub.com, GitHub Pages fonctionne avec deux types de domaines : les sous-domaines et les domaines apex. Pour obtenir la liste des domaines personnalisés non pris en charge, consultez « Résolution des problèmes liés aux domaines personnalisés et aux pages GitHub Pages ».

Type de domaines personnalisés pris en chargeExemple
Sous-domaine wwwwww.example.com
Sous-domaine personnaliséblog.example.com
Domaine apexexample.com

Vous pouvez configurer l’une ou l’autre des configurations apex et du sous-domaine www pour votre site. Pour plus d’informations sur les domaines apex, consultez « Utilisation d’un domaine apex pour votre siteGitHub Pages ».

Nous vous recommandons toujours d’utiliser un sous-domaine www, même si vous utilisez également un domaine apex. Lorsque vous créez un nouveau site avec un domaine apex, nous tentons automatiquement de sécuriser le sous-domaine www à utiliser lors du service du contenu de votre site, mais vous devez apporter des modifications DNS pour utiliser le sous-domaine www. Si vous configurez un sous-domaine www, nous essayons automatiquement de sécuriser le domaine apex associé. Pour plus d’informations, consultez « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Utilisation d’un domaine personnalisé sur plusieurs dépôts

Si vous définissez un domaine personnalisé pour un site utilisateur ou d’organisation, par défaut, il est également utilisé pour tous les sites de projets appartenant au même compte. Pour plus d’informations sur les types de sites, consultez « À propos de GitHub Pages ».

Par exemple, si le domaine personnalisé de votre site utilisateur est www.octocat.com et que vous disposez d’un site de projet sans domaine personnalisé configuré à partir d’un référentiel appelé octo-project, le site GitHub Pages pour ce référentiel sera disponible à l’adresse www.octocat.com/octo-project.

Vous pouvez remplacer le domaine personnalisé par défaut en ajoutant un domaine personnalisé au dépôt individuel.

Remarque : Les URL des sites de projet publiés en privé ne sont pas affectées par le domaine personnalisé de votre site d’utilisateur ou d’organisation. Pour plus d’informations sur les sites publiés en privé, consultez « Modification de la visibilité de votre site pages GitHub » dans la documentation GitHub Enterprise Cloud.

Pour supprimer le domaine personnalisé par défaut, vous devez le supprimer de votre site utilisateur ou d’organisation.

Utilisation d’un sous-domaine pour votre site GitHub Pages

Un sous-domaine fait partie d’une URL avant le domaine racine. Vous pouvez configurer votre sous-domaine en tant que www ou en tant que section distincte de votre site, comme blog.example.com.

Les sous-domaines sont configurés avec un enregistrement CNAME via votre fournisseur DNS. Pour plus d’informations, consultez « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Sous-domaines www

Un sous-domaine www est le type de sous-domaine le plus couramment utilisé. Par exemple, www.example.com inclut un sous-domaine www.

Les sous-domaines www sont le type de domaine personnalisé le plus stable, car les sous-domaines www ne sont pas affectés par les modifications apportées aux adresses IP des serveurs de GitHub.

Créer des sous-domaines

Un sous-domaine personnalisé est un type de sous-domaine qui n’utilise pas la variante standard www . Les sous-domaines personnalisés sont principalement utilisés lorsque vous souhaitez avoir deux sections distinctes de votre site. Par exemple, vous pouvez créer un site appelé blog.example.com et personnaliser cette section indépendamment de www.example.com.

Utilisation d’un domaine apex pour votre site GitHub Pages

Un domaine apex est un domaine personnalisé qui ne contient pas de sous-domaine, tel que example.com. Les domaines Apex sont également appelés domaines de base, nus, apex racine ou apex de zone.

Un domaine apex est configuré avec un enregistrement A, ALIAS ou ANAME via votre fournisseur DNS. Pour plus d’informations, consultez « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Si vous utilisez un domaine apex comme domaine personnalisé, nous vous recommandons également de configurer un sous-domaine www. Si vous configurez les enregistrements appropriés pour chaque type de domaine à travers votre fournisseur DNS, GitHub Pages crée automatiquement les redirections entre les domaines. Par exemple, si vous configurez www.example.com comme domaine personnalisé pour votre site et que vous avez des enregistrements DNS GitHub Pages configurés pour les domaines www et apex, example.com redirige vers www.example.com. Notez que les redirections automatiques s’appliquent uniquement au sous-domaine www. Les redirections automatiques ne s’appliquent à aucun autre sous-domaine, par exemple, blog. Pour plus d’informations, consultez « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Sécurisation d’un domaine apex pour votre site GitHub Pages

Si votre site GitHub Pages est désactivé, mais qu’un domaine personnalisé est configuré, il est exposé à un risque de prise de contrôle du domaine. Avoir un domaine personnalisé configuré avec votre fournisseur DNS alors que votre site est désactivé peut potentiellement laisser une autre personne héberger un site sur l’un de vos sous-domaines.

La vérification de votre domaine personnalisé empêche les autres utilisateurs GitHub d’utiliser votre domaine avec leurs dépôts. Si votre domaine n’est pas vérifié et que votre site GitHub Pages est désactivé, vous devez tout de suite mettre à jour ou supprimer vos enregistrements DNS avec votre fournisseur DNS. Pour plus d’informations, consultez « Vérification de votre domaine personnalisé pour GitHub Pages » et « Gestion d’un domaine personnalisé pour votre site GitHub Pages ».

Il existe quelques raisons pour lesquelles votre site peut être automatiquement désactivé.

  • Si vous passez de la version GitHub Pro à la version GitHub Free, tous les sites GitHub Pages qui sont actuellement publiés à partir de dépôts privés dans votre compte ne seront pas publiés. Pour plus d’informations, consultez « Passage à une version antérieure du plan de votre compte ».
  • Si vous transférez un dépôt privé vers un compte personnel qui utilise GitHub Free, le référentiel perd l’accès à la fonctionnalité GitHub Pages et le site actuellement publié GitHub Pages ne sera pas publié. Pour plus d’informations, consultez « Transfert d’un dépôt ».

Pour aller plus loin