Certains aspects de Plesk et de ses extensions ne peuvent pas être gérés via l’interface graphique utilisateur, l’API XML ou l’interface de ligne de commande. Ces aspects sont gérés via des entrées dans le fichier de configuration panel.ini. En éditant ce fichier, vous pouvez par exemple :

  • Interdire la connexion à Plesk à l’aide des identifiants d’accès « root » ou « administrateur ».
  • Masquer une adresse IP enregistrée dans Plesk, afin qu’elle n’apparaisse pas dans l’interface et ne puisse pas être affectée à des abonnements ou à des revendeurs.
  • Fournir une URL personnalisée vers le Catalogue des extensions, etc.

Le fichier panel.ini est disponible ici :

  • (Plesk pour Linux) /usr/local/psa/admin/conf/panel.ini
  • (Plesk pour Windows)  %plesk_dir%\admin\conf\panel.ini

Si le fichier n’est pas disponible sur votre serveur, créez un fichier vierge à l’emplacement mentionné ci-dessus et intitulez ce fichier panel.ini. Vous pouvez également renommer le fichier panel.ini.sample disponible dans le même répertoire en panel.ini. Dans ce cas, le fichier contiendra un certain nombre de paramètres préconfigurés que vous pouvez utiliser en tant que référence.

Configurer les paramètres dans le fichier panel.ini

Pour configurer les paramètres via le fichier panel.ini, vous devez éditer ce fichier selon l’une de ces méthodes :

  • Éditez le fichier panel.ini avec un éditeur de texte.
  • Installez l’extension Panel.ini Editor puis utilisez-la pour éditer le fichier panel.ini dans l’interface de Plesk.

Quelle que soit l’option que vous choisissez pour configurer des paramètres via le fichier panel.ini, vous devez y ajouter des entrées selon le modèle suivant :

[Section name]
Setting name = Value

Note: si un paramètre est configuré avec une valeur booléenne ( » yes  » ou  » no  »), vous pouvez utiliser  » true  »,  » on  » ou  » yes  » pour l’activer, et  » false  »,  » off  »,  » no  » ou  » none  » pour le désactiver.

Les modifications sont effectives dès que vous avez enregistré le fichier. Vous n’avez besoin de redémarrer aucun service.

Par exemple, si vous voulez désactiver le Bannissement d’adresses IP (Fail2Ban), ajoutez les lignes suivantes au fichier panel.ini :

[fail2ban]
enabled = false

Par conséquent, l’option Bannissement d’adresses IP (Fail2Ban) disparaît du groupe Sécurité de l’écran Outils & Paramètres. Vous ne pourrez plus non plus gérer cette option via les commandes de la CLI.

Tous les paramètres qui peuvent être configurés via le fichier panel.ini sont des éléments d’une section prédéfinie. Pour personnaliser un paramètre, vous devez placer ce paramètre ainsi que la section à laquelle il correspond dans le fichier panel.ini. Chaque section ne doit être incluse qu’une seule fois. Si vous voulez personnaliser plusieurs paramètres au sein d’une même section, incluez une seule fois cette section. Placez-y tous les paramètres que vous voulez personnaliser.

Par exemple, pour personnaliser l’URL du Catalogue des extensions et activer la personnalisation du Catalogue des extensions, ajoutez les lignes suivantes au fichier panel.ini :

[aps]
catalogUrl = "http://exemple.com"
catalogsCustomization = on

Pour configurer des paramètres via l’extension Panel.ini Editor, allez sous Extensions > Mes extensions > Panel.ini Editor > Ouvrir.

image-79685.png

Sur cette page, dans l’onglet  » Viewer  », vous pouvez voir la liste complète des paramètres pouvant être gérés via le fichier panel.ini, classés par section. La colonne  » Setting  » affiche le nom du paramètre tel qu’il est lisible par la machine et la colonne  » Value  » affiche la valeur active.

Les paramètres ajoutés au fichier panel.ini sont affichés en gras. Pour les paramètres dont la valeur a été personnalisée, la valeur par défaut est indiquée entre parenthèses, à côté de la valeur actuelle. Par exemple, sur la capture d’écran suivante, le paramètre catalogUrl a la valeur http://exemple.com à la place de la valeur par défaut (http://cdn.apscatalog.plesk.com).

Pour chercher un paramètre précis, cliquez sur le image-78511.png bouton pour ouvrir le menu de recherche.

image-79686.png

Pour modifier le fichier panel.ini, allez sur l’onglet  » Editor  » et ajoutez-y des entrées selon le processus décrit précédemment.

Restauration des paramètres par défaut

Pour réinitialiser la valeur d’un paramètre que vous avez personnalisé via le fichier panel.ini, ouvrez le fichier pour l’éditer. Ensuite, supprimez la ligne correspondante ou commentez-la en ajoutant le caractère  » ;  » au début de la ligne. Par exemple :

[fail2ban]
; enabled = false

La valeur par défaut est alors restaurée immédiatement après enregistrement du fichier.

Vous pouvez restaurer les valeurs par défaut de tous les paramètres personnalisés via le fichier panel.ini selon l’une de ces méthodes :

  • Connectez-vous au serveur via SSH ou RDP et ouvrez le fichier panel.ini dans un éditeur de texte.
  • Ouvrez l’extension Panel.ini Editor et cliquez sur Rétablir les valeurs par défaut.

Référence

Voici quelques scénarios utilisateur personnalisés que vous pouvez implémenter via le fichier panel.ini. Notez que la liste est non exhaustive. Vous pouvez personnaliser les réactions de certaines extensions de Plesk via le fichier panel.ini. Consultez la documentation des extensions pour en savoir plus.