[comment]: # ({8fc97588-8fc97588})
# 5 前端维护模式

[comment]: # ({/8fc97588-8fc97588})

[comment]: # ({46514efb-fca7c17f})
#### 概述

可以临时禁用 Zabbix 前端以限制访问。这对于保护 Zabbix 数据库免受用户发起的更改、保持其完整性非常有用。

当 Zabbix 前端处于维护模式时，您可以安全地停止数据库并执行维护任务。

来自已定义 IP 地址的用户在维护模式期间仍可正常与前端交互。

[comment]: # ({/46514efb-fca7c17f})

[comment]: # ({6a118718-dcfd8b13})
#### 配置

要启用维护模式，请打开 `maintenance.inc.php` 文件（位于 Web 服务器上 Zabbix HTML 文档目录的 `/conf` 中），并取消注释以下几行：

    // 维护模式。
    define('ZBX_DENY_GUI_ACCESS', 1);

    // 允许连接到前端的 IP 地址数组（可选）。
    $ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1');

    // 警告页面上显示的消息（可选）。
    $ZBX_GUI_ACCESS_MESSAGE = '我们将升级 MySQL 数据库至 15:00。敬请关注...';

[comment]: # ({/6a118718-dcfd8b13})

[comment]: # ({728cf2a7-ae331777})
::: notetip
在大多数情况下，`maintenance.inc.php` 文件位于 Web 服务器上 Zabbix HTML 文档目录的 `/conf` 中。  
不过，某些操作系统和 Web 服务器可能使用不同的位置。

例如，以下位置：

-  SUSE 和 RedHat 为 `/etc/zabbix/web/maintenance.inc.php`。
-  基于 Debian 的系统为 `/usr/share/zabbix/conf/`。

另请参见 [Copying PHP files](/manual/installation/install#copying-php-files)。 
:::

| Parameter | Details |
|--|--------|
| **ZBX\_DENY\_GUI\_ACCESS** | 如果定义了任何值，将启用维护模式。 <br>要禁用维护模式，请注释掉或删除。 |
| **ZBX\_GUI\_ACCESS\_IP\_RANGE** | 允许连接到前端的 IP 地址数组（可选）。<br>例如：<br>`array('192.168.1.1', '192.168.1.2')` |
| **ZBX\_GUI\_ACCESS\_MESSAGE** | 用于通知用户维护状态的消息（可选）。 <br>如果未定义，将使用默认消息 *'Zabbix is under maintenance'*。 |

[comment]: # ({/728cf2a7-ae331777})

[comment]: # ({ca8463c2-987fdc44})
#### 显示

当处于维护模式时，用户尝试访问 Zabbix 前端将看到以下界面。该界面每 30 秒刷新一次，以便在维护结束后无需用户干预即可恢复到正常状态。

![](../../../assets/en/manual/web_interface/frontend_maintenance.png)

在 *ZBX\_GUI\_ACCESS\_IP\_RANGE* 中定义的 IP 地址将能够像往常一样访问前端。

[comment]: # ({/ca8463c2-987fdc44})