Alcuni aspetti del comportamento di Plesk e diverse estensioni Plesk non possono essere gestiti tramite GUI, XML API o la riga di comando. Vengono invece gestite dalle voci nel file di configurazione panel.ini. Ad esempio, modificando questo file puoi:

  • Impedire l’accesso a Plesk utilizzando le credenziali “root” o “Administrator”.
  • Nascondere un indirizzo IP registrato in Plesk, in modo che non venga visualizzato nell’interfaccia e non possa essere assegnato ad abbonamenti o rivenditori.
  • Specificare un URL personalizzato per il Catalogo estensioni, ecc.

Il file panel.ini è disponibile qui:

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

Se il file non è presente sul server, crea un file vuoto nel percorso specifico e e denominalo panel.ini. Puoi anche rinominare il file panel.ini.sample presente nella stessa directory in panel.ini. In questo modo il file conterrà varie impostazioni pre-configurate utilizzabili come riferimento.

Configurazione delle impostazioni in panel.ini

Per configurare le impostazioni con il file panel.ini è necessario modificarlo in uno dei modi seguenti:

  • Modifica il file panel.ini con un editor di testo.
  • Installa l’estensione Panel.ini Editor e utilizzarla per modificare il file panel.ini nella GUI di Plesk.

Indipendentemente dall’opzione che scegli, per configurare una o più impostazioni tramite il file panel.ini, devi aggiungere elementi al file secondo il modello seguente:

[Section name]
Setting name = Value

Nota: se un’0impostazione accetta valori booleani (“sì” o “no”), puoi utilizzare “true”, “on” o “sì” per abilitarlo e “false”, “off”, “no” o “nessuno” per disabilitarlo.

Le modifiche avranno effetto immediatamente una volta salvato il file. Non è quindi necessario riavviare alcun servizio.

Ad esempio, per disattivare Ban dell’indirizzo IP (Fail2Ban), aggiungi le righe seguenti al file panel.ini:

[fail2ban]
enabled = false

Di conseguenza, Esclusione indirizzo IP (Fail2Ban) scompare dal gruppo Sicurezza nella schermata Strumenti e impostazioni e non potrai più gestirlo tramite i comandi CLI.

Ogni impostazione che può essere configurata tramite il file panel.ini appartiene a una sezione predefinita. Per personalizzare un’impostazione, devi posizionarla nel file panel.ini all’interno della sezione a cui appartiene. Non includere ciascuna sezione più di una volta. Per personalizzare diverse impostazioni che fanno parte di una sola sezione, inseriscila una volta e posiziona tutte le impostazioni da personalizzare in quella sezione.

Ad esempio, per personalizzare l’URL del catalogo applicazioni e consentirne la personalizzazione, aggiungi le righe seguenti al file panel.ini:

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

Per configurare le impostazioni con le estensioni Panel.ini Editor passa a Estensioni > Le mie estensioni > Panel.ini Editor > Apri.

image-79685.png

Here, on the «Viewer» tab, you can see the complete list of all settings that can be managed via the panel.ini file, broken down by section. The «Setting» column displays the machine-readable parameter name, the «Value» column displays its currently assigned value, and the «Description» column can show the description of a setting.

You can easily tell which settings were added to the panel.ini file: their values are shown in bold, and their default value is shown in parentheses after the currently assigned one.

For example, on the screenshot below, the setting catalogUrl was assigned the value http://example.com instead of the default one (http://cdn.apscatalog.plesk.com).

image-example

Nota: Certain settings have no default values. For these settings, only the currently assigned value is displayed even if the settings were added to the panel.ini file.

To see only those settings that were added to the panel.ini file, click Modified. To return to the full list of settings, click All. You can also search for a specific setting using the search box.

To add settings to the panel.ini file via Panel.ini Editor:

  1. Go to Extensions > My Extensions > Panel.ini Editor > Open.
  2. Select one or more settings that you want to add to panel.ini and click Copy settings. You can select settings that belong to the same section or different sections.
  3. Go to the «Editor» tab and click Paste settings. Panel.ini Editor will paste the copied setting or settings.
  4. Click Save to save the current panel.ini configuration.

Descriptions of panel.ini Settings

Some settings in Panel.ini Editor have descriptions. When Panel.ini Editor is installed or updated, you receive the descriptions that were approved by the Plesk team. However, you can also fill in the missing descriptions or edit the existing ones yourself. You do it differently depending on your Plesk version.

Nota: When Panel.ini Editor is updated, it preserves both new descriptions added by you and the changes you made to default descriptions.

Nota: If you feel that other Plesk users can benefit from your descriptions, share them! Approved descriptions become available to other Panel.ini Editor users. Read how to share the descriptions.

(Plesk 18.0) To edit descriptions of settings in Panel.ini Editor:

  1. Go to Extensions > My Extensions > Panel.ini Editor > Open.
  2. Click the image-pencil_icon icon in the row of a setting which description you want to fill in or edit.
  3. Type the description and then click image-checkmark to save changes.

(Plesk 17.8 and earlier) To edit descriptions of settings in Panel.ini Editor:

  1. Open the following file:

    • (Plesk for Linux) /usr/local/psa/var/modules/panel-ini-editor/default-descriptions/en-US.json
    • (Plesk for Windows) %plesk_dir% \var\modules\panel-ini-editor\default-descriptions\en-US.json
  2. Add descriptions complying with the JSON file structure:

    {
      "section1": {
        "setting1": "description",
        "setting2": "description"
      },
      " section2": {
        "setting1": "description"
      }
    }
    

    For example, if you want to add a description for the file setting

    image-setting-example

    then the JSON entry will look like this:

    {
      "log": {
        "file": "description"
      }
    }
    
  3. Save changes made to the en-US.json file.

Editing panel.ini via Panel.ini Editor Using Presets

You can make switching between different configurations easier using presets. A preset is a configuration of panel.ini settings, which is created once and then can be loaded on demand without the necessity to manually add or remove settings.

To create a preset:

  1. Go to Extensions > My Extensions > Panel.ini Editor > Open.
  2. Go to the «Editor» tab and edit the panel.ini file to create the desired configuration.
  3. Click Add, give the preset a name, and then click Save.

The preset was created. You can now load the desired configuration of settings at any time by loading the preset.

To load a preset:

  1. Go to Extensions > My Extensions > Panel.ini Editor > Open.
  2. Go to the «Editor» tab.
  3. Click Load and select the desired preset.
  4. The «Editor» tab now shows the configuration of settings that were saved in the preset. Click Save to apply it to the panel.ini file.

Now the panel.ini file contains the chosen configuration of settings. You can delete unneeded presets by clicking Delete and selecting the preset that you want to delete.

Ripristino delle impostazioni predefinite

Per ripristinare al valore predefinito un’impostazione personalizzata tramite il file panel.ini, apri il file per la modifica e rimuovi la riga corrispondente oppure escludila aggiungendo il carattere “;” all’inizio della riga, come segue:

[fail2ban]
; enabled = false

L’impostazione torna al valore predefinito dopo il salvataggio dle file.

Per riportare ai valori predefiniti tutte le impostazioni personalizzate tramite il file panel.ini, procedi in uno dei modi seguenti:

  • Accedi al server via SSH o RDP e rimuovi o rinomina il file panel.ini.
  • Open the Panel.ini Editor extension and click Reset to defaults.

Riferimento

Qui vengono riportati alcuni scenari di personalizzazione implementabili tramite il file panel.ini. Si tratta di un elenco non esaustivo. Il comportamento di alcune estensioni Plesk può essere personalizzato tramite il file panel.ini - consultare la documentazione delle estensioni per ulteriori dettagli.