Algunos aspectos del comportamiento de Plesk y de varias de sus extensiones no puede gestionarse mediante el GUI, XML API o la línea de comandos. En su lugar, estos se rigen por entradas presentes en el archivo de configuración panel.ini. Por ejemplo, editando este archivo puede:

  • Prohibir el acceso a Plesk usando las credenciales “root” o “Administrator”.
  • Ocultar una dirección IP registrada en Plesk para que así esta no aparezca en el interfaz y no pueda asignarse a suscripciones ni revendedores.
  • Especificar otra URL para el catálogo de extensiones, etc.

Encontrará el archivo panel.ini en:

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

Si no encuentra este archivo en su servidor, cree un archivo vacío en la ubicación especificada y denomínelo panel.ini. También puede cambiar el nombre del archivo panel.ini.sample presente en el mismo directorio para que se denomine panel.ini. Así, el archivo incluirá distintos parámetros preconfigurados que puede usar como referencia.

Configuración de los parámetros presentes en panel.ini

Para configurar los parámetros mediante el archivo panel.ini debe editarlo de alguna de las siguientes dos formas:

  • Edite el archivo panel.ini usando un editor de texto.
  • Instale la extensión Panel.ini Editor y úsela para editar el archivo panel.ini en el GUI de Plesk.

Sea cual sea el método usado, para configurar uno o más parámetros mediante el archivo panel.ini debe añadirle entradas con el siguiente patrón:

[Section name]
Setting name = Value

Nota: si un parámetro acepta un valor boleano (“yes” o “no”), puede usar “true”, “on” o “yes” para activarlo y “false”, “off”, “no” o “none” para desactivarlo.

Los cambios se aplicarán de inmediato una vez se guarde el archivo. No es necesario reiniciar ningún servicio.

Por ejemplo, para desactivar IP Address Banning (Fail2Ban), añada las siguientes líneas al archivo panel.ini:

[fail2ban]
enabled = false

Como resultado, IP Address Banning (Fail2Ban) desaparecerá del grupo Seguridad presente en Herramientas y configuración y ya no podrá gestionarlo mediante comandos CLI.

Cada uno de los parámetros que pueden configurarse mediante el archivo panel.ini pertenece a una sección predefinida. Para personalizar algún parámetro deberá ponerlo en el archivo panel.ini dentro de la sección a la que pertenece. No incluya ninguna sección individual más de una vez. Si desea personalizar más de un parámetros perteneciente a una única sección, inclúyalo una vez y ponga todos los parámetros que desee personalizar en este.

Por ejemplo, para personalizar la URL del catálogo de aplicaciones y activar la personalización de este catálogo, añada las siguientes líneas al archivo panel.ini:

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

Para configurar parámetros mediante la extensión Panel.ini Editor , haga clic en Extensiones > Mis extensiones > Panel.ini Editor > Abrir.

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.

Restauración de la configuración predeterminada

Para restaurar un parámetro personalizado mediante el archivo panel.ini a su valor predeterminado, abra el archivo y elimine la entrada correspondiente o coméntela añadiendo el carácter “;” al principio de la línea tal y como se muestra a continuación:

[fail2ban]
; enabled = false

Este parámetro revierte el valor predeterminado de inmediato una vez guardado el archivo.

Para restaurar todos los parámetros personalizados mediante el archivo panel.ini a sus valores predeterminados, haga lo siguiente:

  • Acceda al servidor mediante SSH o RDP y elimine o cambie el nombre del archivo panel.ini.
  • Open the Panel.ini Editor extension and click Reset to defaults.

Referencia

A continuación se detallan algunos escenarios de personalización que pueden implementarse mediante el archivo panel.ini. Tenga en cuenta que esta lista no es exhaustiva. El comportamiento de algunas extensiones de Plesk puede personalizarse mediante el archivo panel.ini. Para más información al respecto, consulte la documentación de las extensiones.