Sous-domaines automatiques dans ISPmanager

ISPmanager peut créer automatiquement des sous-domaines pour un domaine existant — sans aucune modification manuelle de la configuration. Un sous-domaine devient actif dès que vous créez le répertoire correspondant au bon endroit.

Activer les sous-domaines automatiques

Rendez-vous dans Domaines WWW, ouvrez les propriétés du domaine à configurer et, dans la section Sous-domaines automatiques, sélectionnez le mode souhaité.

Mode : « Répertoire séparé »

Chaque sous-domaine dispose de son propre dossier indépendant, sans aucun lien avec les fichiers du domaine principal.

Exemple :

• Le domaine principal example.com se trouve dans www/example.com
• Vous souhaitez créer domain.example.com

Placez les fichiers du sous-domaine ici :

www/domain.example.com

Mode : « Sous-répertoire du domaine WWW »

Les fichiers du sous-domaine sont placés dans le dossier du domaine principal et sont accessibles à la fois via l'URL du sous-domaine et via un chemin du domaine principal.

Exemple :

• Le domaine principal example.com se trouve dans www/example.com
• Vous souhaitez créer domain.example.com

Placez les fichiers du sous-domaine ici :

www/example.com/domain

Ces mêmes fichiers seront également accessibles à l'adresse example.com/domain.

Fonctionnement technique

Les sous-domaines automatiques reposent sur le module Apache mod_vhost_alias, qui doit être activé dans la configuration d'ISPmanager. Vous pouvez également utiliser l'option ForceAutoSubdomain dans le fichier de configuration du panel.

Lorsque vous activez les sous-domaines automatiques, ISPmanager effectue automatiquement les modifications suivantes :

• Pour le mode « Répertoire séparé », cette directive est ajoutée à la configuration du virtual host :

VirtualDocumentRoot /home/username/data/www/%0

• Pour le mode « Sous-répertoire du domaine WWW » :

VirtualDocumentRoot /home/username/data/www/example.com/%1

• Un enregistrement wildcard *.example.com est ajouté à la directive ServerAlias
• Un enregistrement DNS de type A avec le wildcard * est ajouté pour le domaine, pointant vers son adresse IP

Dépannage & FAQ

Où dois-je placer les fichiers du sous-domaine ?

Cela dépend du mode choisi :

• « Répertoire séparé » → www/nom.complet.du.sous-domaine
• « Sous-répertoire du domaine WWW » → www/nom-du-domaine/nom-du-sous-domaine

J'ai activé les sous-domaines automatiques, mais le domaine ne résout pas

La propagation DNS prend du temps — jusqu'à 24–48 heures dans certains cas. Vérifiez également que votre domaine est délégué aux mêmes serveurs de noms qu'ISPmanager utilise.

Après l'activation des sous-domaines automatiques, mes autres sous-domaines renvoient des erreurs 404

Lorsque les sous-domaines automatiques sont activés, un enregistrement wildcard *.example.com est ajouté à la configuration Apache, ce qui fait transiter toutes les requêtes par ce domaine. Pour résoudre le problème, renseignez dans le champ Alias uniquement les sous-domaines dont vous avez réellement besoin.

Les enregistrements DNS pointant vers d'autres adresses IP ne fonctionnent plus

Un enregistrement wildcard * dans les paramètres DNS est prioritaire sur les entrées plus spécifiques. Vous avez deux options : désactiver les sous-domaines automatiques, ou ajouter manuellement tous les enregistrements de type A nécessaires dans les paramètres DNS.

Les sous-domaines www ne fonctionnent pas (par ex. www.example.com ou www.domain.example.com)

Les variantes www nécessitent la création manuelle de liens symboliques (symlinks).

Pour le mode « Répertoire séparé », créez les symlinks dans le répertoire www :

lrwxr-xr-x  www.example.com -> example.com
lrwxr-xr-x  www.domain.example.com -> domain.example.com

Pour le mode « Sous-répertoire du domaine WWW », créez les symlinks dans le répertoire propre au domaine :

lrwxr-xr-x  www -> .
lrwxr-xr-x  www.domain -> domain

Utilisez la commande ln -s pour les créer :

ln -s domain www.domain
ln -s . www