Comment ajouter un domaine à cPanel : Guide technique complet

Ajouter un domaine à cPanel signifie enregistrer un nom de domaine supplémentaire dans votre panneau de contrôle d’hébergement afin que le serveur sache où router les requêtes entrantes et où servir les fichiers. Dans cPanel, cela est géré via l’interface Domains ou Addon Domains, qui crée un répertoire racine de documents dédié, configure l’entrée d’hôte virtuel et configure éventuellement un sous-domaine pour la gestion interne — le tout dans un seul flux de travail.

Ce guide couvre chaque étape de ce processus en profondeur technique : des prérequis DNS et de la configuration du domaine dans cPanel, au déploiement de fichiers via le Gestionnaire de fichiers, jusqu’à la mise en service de la base de données MySQL. Il s’applique directement à tout environnement VPS avec cPanel, y compris les instances VPS AlexHost fonctionnant avec LiteSpeed et un stockage NVMe.

Prérequis avant d’ajouter un domaine dans cPanel

Ignorer l’étape DNS est la raison la plus courante pour laquelle un domaine nouvellement ajouté ne se résout pas. Avant de toucher à cPanel, confirmez les points suivants :

• La propagation DNS est en cours ou terminée. L’enregistrement A de votre domaine doit pointer vers l’adresse IP publique du serveur. La propagation prend généralement entre 15 minutes et 48 heures selon le registrar et les valeurs TTL.
• Votre compte cPanel dispose de slots de domaines addon disponibles. Sur un VPS avec accès root et WHM, cela est contrôlé par compte sous « Modifier un compte ». Sur les plans partagés, cela dépend du forfait d’hébergement.
• Vous possédez ou contrôlez le domaine. Si vous l’avez enregistré ailleurs, vous avez besoin d’accéder au panneau de gestion DNS du registrar. Si vous avez besoin d’un nouveau domaine, l’enregistrement de domaine via AlexHost centralise la gestion DNS.
• SSL est planifié dès le départ. Ajouter le domaine d’abord, puis demander un certificat, est le bon ordre. AutoSSL dans cPanel tentera l’émission automatiquement une fois que le domaine se résout vers le serveur.

Étape 1 : Ajouter le domaine dans cPanel

Connectez-vous à votre compte cPanel (généralement à yourdomain.com:2083 ou via le lien « Aller à cPanel » de WHM).

Accéder à l’interface de gestion des domaines

Dans le thème moderne Jupiter de cPanel, le flux de gestion des domaines a été consolidé :

1. Depuis l’écran d’accueil de cPanel, localisez la section Domains.
2. Cliquez sur Domains (l’interface unifiée introduite dans cPanel 76+, qui remplace les anciennes icônes séparées « Addon Domains », « Subdomains » et « Aliases »).
3. Cliquez sur le bouton Create A New Domain dans le coin supérieur droit.

Configurer la nouvelle entrée de domaine

Vous verrez un formulaire avec les champs suivants :

• Domain : Entrez le nom de domaine pleinement qualifié, par exemple example.com. N’incluez pas www — cPanel gère automatiquement l’alias de sous-domaine www.
• Document Root : cPanel remplit automatiquement ce champ en fonction du nom de domaine, se résolvant généralement en /home/username/public_html/example.com. Vous pouvez remplacer ce chemin, mais la valeur par défaut convient à la plupart des déploiements.
• Case à cocher « Share document root with main domain » : Laissez cette case décochée sauf si vous souhaitez intentionnellement que ce domaine serve les mêmes fichiers que votre domaine principal. La cocher est une erreur courante qui fait afficher un contenu identique sur les deux domaines.

Cliquez sur Submit (ou Add Domain selon votre version de cPanel). cPanel va :

• Créer le répertoire racine de documents.
• Écrire un nouveau bloc de configuration d’hôte virtuel Apache ou LiteSpeed.
• Créer une entrée de sous-domaine (par ex., example.com.yourmainaccount.com) pour le routage interne.
• Ajouter le domaine à la file d’attente SSL/TLS si AutoSSL est activé.

Vérifier que le domaine a été ajouté correctement

Après la soumission, revenez à la liste Domains. La nouvelle entrée doit apparaître avec son chemin de racine de documents et une option pour gérer le DNS. Si vous utilisez les serveurs de noms intégrés de cPanel, cliquez sur Manage à côté du domaine pour inspecter la zone DNS et confirmer que l’enregistrement A pointe vers la bonne IP.

Étape 2 : Télécharger les fichiers du site via le Gestionnaire de fichiers

Une fois le domaine configuré, le serveur est prêt à servir du contenu depuis la racine de documents. L’étape suivante consiste à déployer vos fichiers de site web.

Accéder au Gestionnaire de fichiers

1. Depuis l’écran d’accueil de cPanel, ouvrez File Manager dans la section Files.
2. Dans l’arborescence de répertoires à gauche, naviguez vers public_html/ puis dans le dossier portant le nom de votre domaine (par ex., example.com/).
3. Alternativement, le Gestionnaire de fichiers s’ouvre par défaut sur public_html — vous pouvez naviguer à partir de là.

Télécharger des fichiers sous forme d’archive

Le Gestionnaire de fichiers de cPanel impose une méthode de téléchargement qui nécessite que les fichiers soient regroupés dans un format d’archive. Télécharger des fichiers individuels un par un est à la fois lent et, sur de nombreuses configurations serveur, restreint pour des raisons de performance.

Formats d’archive pris en charge pour l’extraction :

• .zip
• .tar.gz / .tgz
• .tar.bz2
• .gz

La procédure de téléchargement correcte :

1. Compressez vos fichiers de site web localement dans une archive .zip. Pour une installation WordPress, cela signifie compresser l’intégralité du contenu du répertoire du site (pas le dossier lui-même, sauf si vous souhaitez un niveau de sous-répertoire supplémentaire).
2. Dans le Gestionnaire de fichiers, naviguez vers le dossier racine de documents de votre domaine.
3. Cliquez sur Upload dans la barre d’outils supérieure.
4. Sélectionnez votre fichier d’archive et attendez que le téléchargement soit terminé. Le Gestionnaire de fichiers affiche un indicateur de progression.
5. Une fois le téléchargement terminé, cliquez sur Go Back to le répertoire.
6. Faites un clic droit sur l’archive téléchargée et sélectionnez Extract. Confirmez que le chemin d’extraction est le répertoire actuel.
7. Supprimez l’archive après l’extraction pour garder la racine de documents propre.

Détail critique : Si votre archive contient un dossier de niveau supérieur (par ex., mysite/index.php au lieu de index.php à la racine), votre site sera servi depuis example.com/mysite/ plutôt que depuis example.com/. Vérifiez toujours la structure des répertoires après l’extraction. Déplacez les fichiers d’un niveau vers le haut en utilisant la fonction Move du Gestionnaire de fichiers si nécessaire.

Alternative : Déployer via SFTP

Pour les sites plus volumineux ou les déploiements automatisés, SFTP est nettement plus efficace que le Gestionnaire de fichiers. Utilisez un client SFTP (FileZilla, WinSCP, ou sftp en ligne de commande) avec les paramètres suivants :

• Hôte : L’adresse IP ou le nom d’hôte de votre serveur
• Port : 22 (SSH/SFTP)
• Nom d’utilisateur : Le nom d’utilisateur de votre compte cPanel
• Authentification : Mot de passe ou paire de clés SSH

Naviguez directement vers /home/username/public_html/example.com/ et transférez les fichiers. Cette méthode contourne l’exigence d’archive et prend en charge les transferts reprenables.

Étape 3 : Créer une base de données MySQL pour votre site web

La plupart des plateformes CMS — WordPress, Joomla, Drupal, Magento — nécessitent une base de données relationnelle. cPanel fournit deux outils pour cela : MySQL Databases (contrôle manuel et granulaire) et MySQL Database Wizard (guidé, étape par étape). Pour les configurations simples, l’Assistant est plus rapide.

Utiliser le MySQL Database Wizard

1. Depuis l’accueil de cPanel, naviguez vers Databases > MySQL Database Wizard.
2. Étape 1 — Créer une base de données : Entrez un nom pour la base de données. cPanel préfixe automatiquement le nom d’utilisateur de votre compte (par ex., username_dbname). Notez ce nom complet — vous en aurez besoin lors de l’installation du CMS.
3. Étape 2 — Créer un utilisateur de base de données : Entrez un nom d’utilisateur et un mot de passe fort. Utilisez le Password Generator de cPanel pour créer un mot de passe cryptographiquement fort. Le nom d’utilisateur complet sera également préfixé (par ex., username_dbuser).
4. Étape 3 — Ajouter l’utilisateur à la base de données : Sélectionnez l’utilisateur que vous venez de créer et attribuez des privilèges. Pour un CMS standard, accordez All Privileges. Cliquez sur Next Step.
5. L’Assistant confirme la base de données, l’utilisateur et l’attribution des privilèges. Enregistrez les trois valeurs : nom de la base de données, nom d’utilisateur et mot de passe.

Utiliser MySQL Databases (Avancé)

Pour les environnements nécessitant plusieurs utilisateurs avec différents niveaux de privilèges, ou lors de la gestion de plusieurs bases de données par domaine :

1. Allez dans Databases > MySQL Databases.
2. Créez la base de données sous Create New Database.
3. Faites défiler jusqu’à Add New User et créez l’utilisateur avec un mot de passe fort.
4. Sous Add User to Database, sélectionnez l’utilisateur et la base de données, puis définissez des privilèges granulaires (SELECT, INSERT, UPDATE, DELETE, etc.) plutôt que ALL PRIVILEGES en bloc.

Note de sécurité : N’utilisez jamais le même utilisateur de base de données sur plusieurs sites du même compte. Si un site est compromis, des identifiants de base de données isolés limitent les mouvements latéraux vers d’autres bases de données.

Valeur de l’hôte de base de données

Lors de la configuration de votre installateur CMS, l’hôte de base de données est presque toujours localhost sur un VPS cPanel standard. C’est parce que le serveur MySQL fonctionne sur la même machine et écoute sur le socket local. Utiliser 127.0.0.1 fonctionne également mais force TCP au lieu du socket Unix, ajoutant une légère surcharge.

Étape 4 : Configurer SSL pour le nouveau domaine

Un domaine sans HTTPS sera signalé par les navigateurs et pénalisé dans les classements de recherche. La fonctionnalité AutoSSL de cPanel (propulsée par Let’s Encrypt ou Sectigo selon la configuration du serveur) gère l’émission de certificats automatiquement une fois que le domaine se résout correctement.

Vérifier la couverture AutoSSL

1. Naviguez vers Security > SSL/TLS Status.
2. Votre nouveau domaine devrait apparaître dans la liste. Si AutoSSL a déjà été exécuté, il affichera un cadenas vert et une date d’expiration.
3. Si le domaine apparaît comme en attente ou échoué, cliquez sur Run AutoSSL pour déclencher une tentative immédiate.

Raisons courantes d’échec d’AutoSSL :

• L’enregistrement A du domaine ne pointe pas encore vers le serveur (DNS non propagé).
• Un enregistrement DNS CAA sur le domaine restreint l’émission à une autre CA.
• Le domaine est derrière un proxy (par ex., Cloudflare orange-cloud) qui intercepte le défi ACME HTTP-01.

Pour les domaines nécessitant une validation étendue ou une couverture wildcard au-delà de ce que fournit AutoSSL, vous pouvez installer manuellement un certificat SSL tiers via le SSL/TLS Manager de cPanel.

Addon Domains vs. Subdomains vs. Parked Domains : Différences clés

Comprendre quel type de domaine ajouter évite les mauvaises configurations et le temps de dépannage perdu.

L’interface moderne Domains de cPanel consolide ces options en un seul écran, mais le comportement sous-jacent reste distinct. Lorsque vous ajoutez un domaine et laissez « Share document root » décoché, vous créez ce qui était historiquement appelé un Addon Domain.

Problèmes courants et comment les résoudre

Le domaine affiche « Index of / » (Listage de répertoire)

Cela signifie que la racine de documents est vide ou ne contient pas de fichier index.php / index.html. Soit vos fichiers n’ont pas été téléchargés, soit ils ont été extraits dans un sous-répertoire. Vérifiez la structure des fichiers dans le Gestionnaire de fichiers.

Erreur 500 Internal Server Error après le téléchargement

Généralement causée par des permissions de fichiers incorrectes ou un fichier .htaccess malformé. Vérifiez que les répertoires sont définis sur 755 et les fichiers sur 644. Dans le Gestionnaire de fichiers, faites un clic droit sur n’importe quel fichier ou dossier et sélectionnez Change Permissions.

Erreur de connexion à la base de données lors de l’installation du CMS

Vérifiez que vous utilisez le nom de base de données et le nom d’utilisateur complets avec préfixe (par ex., username_dbname, et non simplement dbname). Confirmez que le mot de passe ne contient pas de caractères spéciaux qui pourraient être mal interprétés par l’analyseur de configuration du CMS — ou encadrez la valeur entre guillemets dans le fichier de configuration.

Le domaine se résout vers le mauvais site

Si deux domaines sur le même compte se résolvent vers le même contenu, la racine de documents a été partagée accidentellement lors de la configuration. Allez dans Domains, modifiez l’entrée et corrigez le chemin de la racine de documents vers le répertoire dédié.

Aller au-delà d’un seul compte cPanel

Lorsque vous dépassez les capacités d’un seul compte cPanel — que ce soit en termes de nombre de domaines, de volume de trafic ou d’exigences d’isolation des ressources — les options d’architecture divergent :

• Plusieurs comptes cPanel sur un seul VPS via WHM : Chaque compte a ses propres limites de ressources, racines de documents et utilisateurs de base de données. Idéal pour les agences gérant des sites clients.
• Serveur dédié avec WHM/cPanel : Isolation matérielle complète, aucun effet de voisin bruyant, et la possibilité de personnaliser la configuration LiteSpeed ou Apache au niveau du serveur. Les serveurs dédiés AlexHost prennent en charge l’accès root WHM complet.
• Plusieurs instances VPS : Chaque VPS exécute un environnement cPanel indépendant. Utile lorsque les sites ont des exigences de sécurité ou de conformité différentes.

Pour la plupart des déploiements petits à moyens, un seul compte VPS Hosting avec cPanel hébergeant 5 à 20 domaines est l’architecture la plus rentable. Le stockage NVMe garantit que même les opérations à forte intensité d’I/O comme les requêtes de base de données et la mise en cache des opcodes PHP restent rapides sur tous les domaines hébergés.

Liste de contrôle des points techniques essentiels

Avant de considérer un domaine pleinement opérationnel dans cPanel, vérifiez chaque élément :

• L’enregistrement A DNS pointe vers la bonne IP du serveur et a été propagé (vérifiez avec dig example.com A ou un vérificateur DNS en ligne).
• La racine de documents est un répertoire dédié, non partagé avec le domaine principal.
• Les fichiers sont extraits au bon niveau de répertoire — index.php doit être directement dans la racine de documents, pas dans un sous-répertoire.
• Les permissions de fichiers sont définies sur 755 pour les répertoires et 644 pour les fichiers.
• Les identifiants de base de données (nom complet avec préfixe, nom d’utilisateur, mot de passe, hôte localhost) sont enregistrés et testés.
• Le certificat SSL est actif et couvre à la fois example.com et www.example.com.
• Le renouvellement d’AutoSSL ou du certificat manuel est confirmé — les certificats Let’s Encrypt expirent tous les 90 jours.
• .htaccess contient une règle de redirection HTTPS valide si vous souhaitez imposer SSL.
• L’hébergement de messagerie pour le nouveau domaine est configuré si nécessaire — la section Email Accounts de cPanel, ou une solution d’hébergement de messagerie dédiée si vous avez besoin de fonctionnalités avancées de délivrabilité.

FAQ

L’ajout d’un domaine dans cPanel configure-t-il automatiquement le DNS ?

Seulement si votre domaine utilise les serveurs de noms de cPanel. Si le domaine est enregistré ailleurs et utilise des serveurs de noms externes, vous devez ajouter manuellement l’enregistrement A chez votre registrar ou fournisseur DNS pointant vers l’IP de votre serveur. cPanel crée le fichier de zone en interne, mais les résolveurs externes ne l’utiliseront pas sauf si le domaine délègue aux serveurs de noms de cPanel.

Combien de domaines puis-je ajouter à un seul compte cPanel ?

La limite est définie dans WHM sous la configuration du compte. Sur un VPS avec accès root, vous pouvez la définir sur illimité. Sur les plans d’hébergement partagé géré, la limite dépend du niveau du forfait. Il n’y a pas de plafond technique strict dans cPanel lui-même — la limite pratique est la capacité des ressources du serveur.

Quelle est la différence entre le MySQL Database Wizard et MySQL Databases dans cPanel ?

L’Assistant vous guide à travers la création de base de données, la création d’utilisateur et l’attribution de privilèges dans un flux linéaire en trois étapes — idéal pour les configurations rapides. L’interface MySQL Databases vous donne un contrôle granulaire sur plusieurs utilisateurs, les attributions de privilèges individuels et les outils de réparation/optimisation de base de données. Pour les environnements de production avec des exigences de sécurité, utilisez l’interface manuelle.

Pourquoi mon domaine affiche-t-il une page par défaut de cPanel après avoir été ajouté ?

La page par défaut de cPanel (cgi-sys/defaultwebpage.cgi) apparaît lorsque la racine de documents est vide. Téléchargez et extrayez vos fichiers de site, ou placez un fichier index.html dans la racine de documents pour le remplacer immédiatement.

Puis-je ajouter un domaine à cPanel sans accès root au serveur ?

Oui. Les comptes utilisateurs cPanel standard (non-root) peuvent ajouter des domaines jusqu’à la limite définie par le fournisseur d’hébergement. L’accès root n’est requis que pour modifier les limites au niveau du compte, installer des logiciels à l’échelle du serveur ou modifier des configurations en dehors du répertoire personnel de l’utilisateur cPanel.