Конфигурационный файл panel.ini

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

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

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

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

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

Далее в этом разделе:

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

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

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

 

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

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

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

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

[Имя секции]
Имя настройки = Значение

Примечание. Если настройка принимает значения типа 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://catalog.pp.plesk.ru"
catalogsCustomization = on

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

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

Настройки, добавленные в файл panel.ini, помечены жирным. Для настроек, значения которых были изменены, в скобках рядом с текущим значением отображается значение по умолчанию. Например, выше на снимке экрана показано, что настройке "catalogUrl" было присвоено значение "http://apps.example.com" вместо значения по умолчанию ("http://apps.plesk.com").

Чтобы найти определенную настройку, нажмите кнопку , которая открывает меню поиска.

Чтобы изменить файл panel.ini, перейдите на вкладку "Редактирование" и добавьте новые записи, как описано выше.

 

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

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

[fail2ban]
; enabled = false

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

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

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

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

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