Некоторыми аспектами поведения 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 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. Но вы также можете ввести недостающие описания или отредактировать существующие описания самостоятельно.

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

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

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

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

Редактирование 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 ― подробности можно найти в документации к этим расширениям.