Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

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

GitHub Pages est disponible dans les dépôts publics avec GitHub Free et GitHub Free pour les organisations, et dans les dépôts publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server. Pour plus d’informations, consultez « Produits de GitHub ».

Domaines personnalisés pris en charge

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

Une fois que vous avez configuré un domaine personnalisé pour un site d’utilisateur ou d’organisation, le domaine personnalisé remplace la partie <user>.github.io ou <organization>.github.io de l’URL pour tous les sites de projet appartenant au compte qui sont publiés publiquement et qui n’ont pas de domaine personnalisé configuré. 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.

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

Pour plus d’informations sur chaque type de site et la gestion des domaines personnalisés, consultez « À propos de GitHub Pages. »

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 Enterprise Cloud.

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 de votre abonnement GitHub au niveau inférieur ».
  • 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