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.

Gestion d’un domaine personnalisé pour votre site GitHub Pages

Vous pouvez configurer ou mettre à jour certains enregistrements DNS et vos paramètres de dépôt pour pointer le domaine par défaut de votre site GitHub Pages vers un domaine personnalisé.

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

Les personnes disposant d’autorisations d’administrateur sur un dépôt peuvent configurer un domaine personnalisé pour un site GitHub Pages.

À propos de la configuration de domaines personnalisés

Veillez à ajouter votre domaine personnalisé à votre site GitHub Pages avant de configurer votre domaine personnalisé auprès de votre fournisseur DNS. La configuration de votre domaine personnalisé auprès de votre fournisseur DNS sans ajouter votre domaine personnalisé à GitHub peut entraîner la possibilité pour une autre personne d’héberger un site sur un de vos sous-domaines.

La commande dig, qui peut être utilisée pour vérifier la configuration correcte des enregistrements DNS, n’est pas incluse dans Windows. Avant de pouvoir vérifier que vos enregistrements DNS sont correctement configurés, vous devez installer BIND.

Remarque : La propagation des modifications DNS peut prendre jusqu’à 24 heures.

Configuration d’un sous-domaine

Pour configurer un sous-domaine www ou personnalisé, comme www.example.com ou blog.example.com, vous devez ajouter votre domaine dans les paramètres du dépôt. Ensuite, configurez un enregistrement CNAME auprès de votre fournisseur DNS.

  1. Dans GitHub, accédez au dépôt de votre site. 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Bouton Paramètres du dépôt

  2. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Pages.

  3. Sous « Domaine personnalisé », entrez votre domaine personnalisé, puis cliquez sur Enregistrer. Si vous publiez votre site à partir d’une branche, cela crée un commit qui ajoute un fichier CNAME à la racine de votre branche source. Si vous publiez votre site avec un workflow GitHub Actions personnalisé, aucun fichier CNAME n’est créé. Pour plus d’informations sur votre source de publication, consultez « Configuration d’une source de publication pour votre site GitHub Pages ». Bouton Enregistrer un domaine personnalisé

    Remarque : si votre domaine personnalisé est un nom de domaine internationalisé, vous devez entrer la version Punycode encodée.

    Pour plus d’informations sur Punycode, consultez Nom de domaine internationalisé.

  4. Accédez à votre fournisseur DNS et créez un enregistrement CNAME qui fait pointer votre sous-domaine vers le domaine par défaut de votre site. Par exemple, si vous voulez utiliser le sous-domaine www.example.com pour votre site utilisateur, créez un enregistrement CNAME qui fait pointer www.example.com vers <user>.github.io. Si vous voulez utiliser le sous-domaine another.example.com pour votre site d’organisation, créez un enregistrement CNAME qui fait pointer another.example.com vers <organization>.github.io. L’enregistrement CNAME doit toujours pointer vers <user>.github.io ou vers <organization>.github.io, à l’exclusion du nom du dépôt. Pour plus d’informations sur la création de l’enregistrement approprié, consultez la documentation de votre fournisseur DNS. Pour plus d’informations sur le domaine par défaut de votre site, consultez « À propos de GitHub Pages ».

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

    1. Ouvrez TerminalTerminalGit Bash.
  5. Pour vérifier que votre enregistrement DNS est correctement configuré, utilisez la commande dig, en remplaçant WWW.EXAMPLE.COM par votre sous-domaine.

    $ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
        > ;WWW.EXAMPLE.COM.                    IN      A
        > WWW.EXAMPLE.COM.             3592    IN      CNAME   YOUR-USERNAME.github.io.
        > YOUR-USERNAME.github.io.      43192   IN      CNAME   GITHUB-PAGES-SERVER .
        > GITHUB-PAGES-SERVER .         22      IN      A       192.0.2.1
  6. Si vous utilisez un générateur de site statique pour générer votre site localement et poussez les fichiers générés vers GitHub, tirez le commit qui a ajouté le fichier CNAME à votre dépôt local. Pour plus d’informations, consultez « Résolution des problèmes liés aux domaines personnalisés et à GitHub Pages ». 1. Pour appliquer un chiffrement HTTPS à votre site, vous pouvez sélectionner Appliquer le protocole HTTPS. Jusqu’à 24 heures peuvent s’écouler avant que cette option soit disponible. Pour plus d’informations, consultez « Sécurisation de votre site GitHub Pages avec Jekyll ». Appliquer le protocole HTTPS pour l’option des domaines personnalisés

Configuration d’un domaine apex

Pour configurer un domaine apex, comme example.com, vous devez configurer un domaine personnalisé dans vos paramètres de dépôt et au moins un enregistrement ALIAS, ANAME ou A avec votre fournisseur DNS.

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 « Configuration d’un sous-domaine ».

  1. Dans GitHub, accédez au dépôt de votre site. 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Bouton Paramètres du dépôt

  2. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Pages.

  3. Sous « Domaine personnalisé », entrez votre domaine personnalisé, puis cliquez sur Enregistrer. Si vous publiez votre site à partir d’une branche, cela crée un commit qui ajoute un fichier CNAME à la racine de votre branche source. Si vous publiez votre site avec un workflow GitHub Actions personnalisé, aucun fichier CNAME n’est créé. Pour plus d’informations sur votre source de publication, consultez « Configuration d’une source de publication pour votre site GitHub Pages ». Bouton Enregistrer un domaine personnalisé

  4. Accédez à votre fournisseur DNS et créez un enregistrement ALIAS, ANAME ou A. Vous pouvez aussi créer des enregistrements AAAA pour la prise en charge d’IPv6. Pour plus d’informations sur la création de l’enregistrement approprié, consultez la documentation de votre fournisseur DNS.

    • Pour créer un enregistrement ALIAS ou ANAME, faites pointer votre domaine apex vers le domaine par défaut pour votre site. Pour plus d’informations sur le domaine par défaut de votre site, consultez « À propos de GitHub Pages ».
    • Pour créer des enregistrements A, faites pointer votre domaine apex vers les adresses IP pour GitHub Pages.
      185.199.108.153
      185.199.109.153
      185.199.110.153
      185.199.111.153
    • Pour créer des enregistrements AAAA, faites pointer votre domaine apex vers les adresses IP pour GitHub Pages.
      2606:50c0:8000::153
      2606:50c0:8001::153
      2606:50c0:8002::153
      2606:50c0:8003::153

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

    1. Ouvrez TerminalTerminalGit Bash.
  5. Pour vérifier que votre enregistrement DNS est correctement configuré, utilisez la commande dig, en remplaçant EXAMPLE.COM par votre domaine apex. Vérifiez que les résultats correspondent aux adresses IP pour GitHub Pages ci-dessus.

    • Pour les enregistrements A.
      $ dig EXAMPLE.COM +noall +answer -t A
      > EXAMPLE.COM    3600    IN A     185.199.108.153
      > EXAMPLE.COM    3600    IN A     185.199.109.153
      > EXAMPLE.COM    3600    IN A     185.199.110.153
      > EXAMPLE.COM    3600    IN A     185.199.111.153
    • Pour les enregistrements AAAA.
      $ dig EXAMPLE.COM +noall +answer -t AAAA
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8000::153
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8001::153
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8002::153
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8003::153
  6. Si vous utilisez un générateur de site statique pour générer votre site localement et poussez les fichiers générés vers GitHub, tirez le commit qui a ajouté le fichier CNAME à votre dépôt local. Pour plus d’informations, consultez « Résolution des problèmes liés aux domaines personnalisés et à GitHub Pages ». 1. Pour appliquer un chiffrement HTTPS à votre site, vous pouvez sélectionner Appliquer le protocole HTTPS. Jusqu’à 24 heures peuvent s’écouler avant que cette option soit disponible. Pour plus d’informations, consultez « Sécurisation de votre site GitHub Pages avec Jekyll ». Appliquer le protocole HTTPS pour l’option des domaines personnalisés

Configuration d’un domaine apex et de la variante de sous-domaine www

Lors de l’utilisation d’un domaine apex, nous vous recommandons de configurer votre site GitHub Pages pour héberger du contenu à la fois au niveau du domaine apex et de la variante de sous-domaine www de ce domaine.

Pour configurer un sous-domaine www à côté du domaine apex, vous devez d’abord configurer un domaine apex en créant un enregistrement ALIAS, ANAME ou A auprès de votre fournisseur DNS. Pour plus d’informations, consultez Configuration d’un domaine apex.

Après avoir configuré le domaine apex, vous devez configurer un enregistrement CNAME auprès de votre fournisseur DNS.

  1. Accédez à votre fournisseur DNS et créez un enregistrement CNAME qui fait pointer www.example.com vers le domaine par défaut pour votre site : <user>.github.io ou <organization>.github.io. N’incluez pas le nom du dépôt. Pour plus d’informations sur la création de l’enregistrement approprié, consultez la documentation de votre fournisseur DNS. Pour plus d’informations sur le domaine par défaut de votre site, consultez « À propos de GitHub Pages ».
  2. Pour vérifier que votre enregistrement DNS est correctement configuré, utilisez la commande dig, en remplaçant WWW.EXAMPLE.COM par votre variante de sous-domaine www.
    $ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
        > ;WWW.EXAMPLE.COM                     IN      A
        > WWW.EXAMPLE.COM.              3592    IN      CNAME   YOUR-USERNAME.github.io.
        > YOUR-USERNAME.github.io.      43192   IN      CNAME   GITHUB-PAGES-SERVER.
        > GITHUB-PAGES-SERVER.         22      IN      A       192.0.2.1

Suppression d’un domaine personnalisé

  1. Dans GitHub, accédez au dépôt de votre site. 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Bouton Paramètres du dépôt

  2. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Pages.

  3. Sous « Domaine personnalisé », cliquez sur Supprimer. Bouton Enregistrer un domaine personnalisé

Sécurisation de votre domaine personnalisé

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

Pour aller plus loin