Plesk 和Plesk 扩展的某些方面可能无法通过 GUI、XML API或命令进行管理。但是却受 panel.ini 配置文件的控制。例如,编辑该文件,您可以:

  • 禁止使用 ‘root’ 或 ‘Administrator’ 验证凭据登录Plesk。
  • 隐藏在Plesk中注册的 IP 地址,以令该地址不在界面中显示,而无法将其分配给订阅或代理商。
  • 为扩展目录指定一个自定义的 URL 地址,等等。

可在此处找到 panel.ini 文件:

  • (Plesk for 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 扩展 并在 Plesk GUI 中编辑 panel.ini 文件。

不管您选择哪个选项,要通过 panel.ini 文件配置一个或多个设置,都需要根据以下模式添加项到该文件:

[Section name]
Setting name = Value

注解: 如果某个设置接受布尔 (‘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.png

在 “Viewer” 标签,您可以看到可通过 panel.ini 文件进行管理的所有设置,这些设置按所属部分分类。”设置” 栏会列出机器可读的参数名称,而 “值” 一栏则显示其当前分配的值。“描述”一栏可以显示设置的说明。

您可以很容易地判断哪些设置被添加到“Panel.ini”文件中:它们的值以粗体显示,默认值在当前分配的设置之后的括号中显示。

例如,在下面的截屏上,设置 catalogUrl 被分配了 http://example.com 值而不是默认的值 (http://cdn.apscatalog.plesk.com)。

image-example

注解: 某些设置没有默认值。对于这些设置,即使已被添加到 panel.ini 文件中,也只显示当前的赋值。

要仅查看添加到 “panel.ini” 文件中的那些设置,请单击**修改**。要返回完整的设置列表,请单击**所有**。也可以使用搜索框搜索某个设置。

若要通过 Panel.ini Editor 将设置添加到 panel.ini 文件,请如下操作:

  1. 进入 扩展 > 我的扩展 > Panel.ini Editor > 打开
  2. 选择一个或多个要添加到 panel.ini 中的设置,然后单击 复制设置。可以选择属于同一部分或不同部分的设置。
  3. 转到 “Editor” 标签点击 粘贴设置。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 Editor 编辑 panel.ini

您可以使用预设使不同配置之间的切换更容易。预设是 “‘panel.ini’ 设置的配置,它只创建一次,然后就可以按需加载,而无需手动添加或移除设置。

若要创建预设,请如下操作:

  1. 进入 扩展 > 我的扩展 > Panel.ini Editor > 打开
  2. 转到 “Editor” 标签点击 panel.ini 文件以创建所需的配置。
  3. 点击 添加,给预设一个名称,然后点击 保存

预设已创建。现在您则可以在任何时候通过加载预设加载设置的所需配置。

若要加载预设,请如下操作:

  1. 进入 扩展 > 我的扩展 > Panel.ini Editor > 打开
  2. 进入 Editor 标签。
  3. 点击 加载 选择所需的预设。
  4. “Editor” 标签现在则显示在预设中保存的设置配置。点击 保存 以将其应用到 panel.ini 文件。

现在 panel.ini 文件包含选定的设置配置。您可以通过点击 删除 删除不必要的预设并选择您想要删除的预设。

恢复默认的设置

若要将通过 panel.ini 文件自定义的设置恢复为默认值,请打开要编辑的文件移除相应行,或在该行的开头添加 ‘;’ 字符将其注释掉,如下:

[fail2ban]
; enabled = false

该设置会在保存文件后立即恢复为默认值。

若要将通过 panel.ini 文件自定义的所有设置恢复为其默认值,请进行以下操作:

  • 通过SSH 或 RDP登录服务器移除或重命名 panel.ini 文件。
  • 打开 Panel.ini Editor 扩展点击 重设为默认值

参考

下面是可通过 panel.ini 文件实现的用户自定义方案的示例。注意这个列表并不详尽。某些 Plesk 扩展的操作可通过 panel.ini 文件进行自定义 - 请参考扩展的文档了解详情。