Некоторыми аспектами поведения Plesk и его расширений невозможно управлять через пользовательский интерфейс, XML API или командную строку. Однако ими можно управлять при помощи записей в конфигурационном файле panel.ini. Например, редактируя этот файл, вы можете:

  • запретить вход в Plesk под учетной записью „root“ или „Administrator“;
  • скрыть IP-адрес, зарегистрированный в Plesk, так, что его не будет видно в интерфейсе, и нельзя будет присвоить его подпискам или реселлерам;
  • указать произвольный URL для каталога расширений и так далее.

Файл panel.ini можно найти здесь:

  • (Plesk для Linux) /usr/local/psa/admin/conf/panel.ini
  • (Plesk for Windows)  %plesk_dir%admin\conf\panel.ini

Если файл отсутствует на вашем сервере, создайте пустой файл по указанному выше пути и назовите его panel.ini. Вы также можете переименовать файл panel.ini.sample, находящийся в этой же папке, в panel.ini. В этом случае файл будет содержать ряд предопределенных настроек, которые вы можете использовать для справки.

Изменение настроек в panel.ini

Чтобы изменить настройки через файл panel.ini, вам необходимо отредактировать его одним из следующих способов:

  • Внести изменения в файл panel.ini, используя текстовый редактор.
  • Установить расширение Panel.ini Editor и отредактировать файл panel.ini в интерфейсе Plesk с помощью этого расширения.

Какой бы из этих способов вы ни выбрали, для изменения одной или более настроек через файл panel.ini вам надо добавить в него записи согласно следующему шаблону:

[Section name]
Setting name = Value

Примечание: Если настройка принимает значения типа boolean („yes“ или „no“), вы можете задать для ее включения любое из значений „true“, „on“ или „yes“ и любое из значений „false“, „off“, „no“ или „none“ ― для ее выключения.

Изменения вступают в силу сразу после сохранения файла. Никакие службы перезапускать не требуется.

Например, чтобы выключить Блокировку IP-адресов (Fail2Ban), добавьте в файл panel.ini следующие строки:

[fail2ban]
enabled = false

В результате пункт Блокировка IP-адресов (Fail2Ban) будет скрыт из группы Безопасность в разделе Инструменты и настройки, и вы больше не сможете управлять этой настройкой через команды CLI.

Каждая настройка, которую можно изменить посредством файла panel.ini, относится к какой-либо предопределенной секции. Чтобы изменить настройку, надо поместить ее в секцию файла panel.ini, к которой она относится. Не добавляйте одну и ту же секцию в файл более одного раза. Если вы хотите изменить несколько настроек, относящихся к одной и той же секции, добавьте эту секцию один раз и поместите в нее все настройки, которые хотите изменить.

Например, чтобы изменить URL каталога приложений и включить возможность настраивать каталог приложений, добавьте в файл panel.ini следующие строки:

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

Чтобы изменить настройки, используя расширение Panel.ini Editor, перейдите в раздел Расширения > Мои расширения > Panel.ini Editor > Открыть.

image 79685

Здесь, на вкладке «Просмотр», вы можете просмотреть полный список всех настроек, которыми можно управлять посредством файла panel.ini, с разбивкой по секциям. В колонке «Настройка» отображается машиночитаемое имя настройки, в колонке «Значение» ― ее текущее значение, а в колонке «Описание» может отображаться описание настройки.

Вы легко можете понять, какие настройки были добавлены к файлу panel.ini: их значения выделены полужирным шрифтом, а их значения по умолчанию отображаются в скобках после текущих значений.

Например, на снимке экрана ниже настройке catalogUrl было присвоено значение http://example.com вместо значения по умолчанию (http://cdn.apscatalog.plesk.com).

image example

Примечание: У некоторых настроек нет значений по умолчанию. Для них отбражается только текущее присвоенное значение, даже если эти настройки были добавлены в файл panel.ini.

Чтобы посмотреть только те настройки, которые были добавлены в файл panel.ini, нажмите Измененные. Чтобы вернуться к полному списку настроек, нажмите Все. Вы также можете найти конкретную настройку с помощью поля поиска.

Чтобы добавить настройки в файл panel.ini с помощью Panel.ini Editor:

  1. Перейдите в раздел Расширения > Мои расширения > Panel.ini Editor > Открыть.
  2. Выберите одну или более настроек, которые хотите добавить в файл panel.ini, и нажмите Копировать настройки. Вы можете выбирать настройки как из одной секции, так и из разных секций.
  3. Перейдите на вкладку «Редактирование» и нажмите Вставить настройки. Panel.ini Editor вставит скопированные настройки.
  4. Нажмите Сохранить, чтобы сохранить текущую конфигурацию panel.ini.

Описания настроек в panel.ini

Некоторые настройки в Panel.ini Editor имеют описания. Когда Panel.ini Editor устанавливается или обновляется, вы получаете описания настроек, утвержденные командной Plesk. Но вы также можете ввести недостающие описания или отредактировать существующие описания самостоятельно. Это можно сделать это разными способами в зависимости от версии Plesk.

Примечание: Когда расширение Panel.ini Editor обновляется, оно сохраняет как добавленные вами новые описания, так и ваши изменения существующих описаний.

Примечание: Если вы считаете, что ваши описания могут быть полезны другим пользователям Plesk, поделитесь ими! Утвержденные описания становятся доступны другим пользователям Panel.ini Editor. Читайте о том, как поделиться описаниями.

(Plesk 18.0) Чтобы отредактировать описания настроек в Panel.ini Editor:

  1. Перейдите в раздел Расширения > Мои расширения > Panel.ini Editor > Открыть.
  2. Нажмите значок image pencil_icon в строке настройки, описание которой вы хотите заполнить или отредактировать.
  3. Введите описание и нажмите image checkmark, чтобы сохранить изменения.

(Plesk 17.8 и ниже) Чтобы отредактировать описания настроек в Panel.ini Editor:

  1. Откройте следующий файл:

    • (Plesk для Linux) /usr/local/psa/var/modules/panel-ini-editor/default-descriptions/en-US.json
    • (Plesk для Windows) %plesk_dir% \var\modules\panel-ini-editor\default-descriptions\en-US.json
  2. Добавьте описания в формате JSON:

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

    Например, если вы хотите добавить описание для настройки file

    image setting example

    запись JSON будет выглядеть следующим образом:

    {
      "log": {
        "file": "description"
      }
    }
    
  3. Сохрание изменения в файле en-US.json.

Редактирование panel.ini через Panel.ini Editor с помощью пресетов

Вы можете легко переключаться между различными конфигурациями, используя пресеты. Пресет ― это комбинация настроек panel.ini, которая создается один раз, а затем может быть загружена, когда нужно, без необходимости добавлять или удалять настройки вручную.

Чтобы создать пресет:

  1. Перейдите в раздел Расширения > Мои расширения > Panel.ini Editor > Открыть.
  2. Перейдите на вкладку «Редактирование» и отредактируйте файл panel.ini, создав нужную конфигурацию.
  3. Нажмите Добавить, дайте название пресету, а затем нажмите Сохранить.

Пресет был создан. Теперь вы можете загрузить нужную конфигурацию в любой момент, загрузив пресет.

Чтобы загрузить пресет:

  1. Перейдите в раздел Расширения > Мои расширения > Panel.ini Editor > Открыть.
  2. Перейдите на вкладку «Редактирование».
  3. Нажмите Загрузить и выберите нужный пресет.
  4. Теперь вкладка «Редактирование» показывает ту конфигурацию, которая была сохранена в пресете. Нажмите Сохранить, чтобы применить ее к файлу panel.ini.

Теперь файл panel.ini содержит выбранную конфигурацию. Вы можете удалить ненужные пресеты, нажав Удалить и выбрав пресет, который хотите удалить.

Восстановление настроек по умолчанию

Чтобы восстановить значение по умолчанию для настройки, измененной посредством файла panel.ini, откройте файл на редактирование и либо удалите соответствующую строку, либо закомментируйте ее, добавив символ „;“ в начале строки, например:

[fail2ban]
; enabled = false

Настройка вернется к значению по умолчанию сразу же после сохранения файла.

Чтобы восстановить значения всех настроек, измененных посредством файла panel.ini, выполните одно из следующих действий:

  • Войдите на сервер по SSH или RDP и удалите или переименуйте файл panel.ini.
  • Откройте расширение Panel.ini Editor и нажмите Вернуться к значениям по умолчанию.

Справочная информация

Вот несколько сценариев пользовательской настройки, которые можно осуществить при помощи файла panel.ini. Имейте в виду, что этот список не является исчерпывающим. Поведение некоторых расширений Plesk можно настроить с помощью файла panel.ini ― подробности можно найти в документации к этим расширениям.