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

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

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

Zabbix Web前端可被临时禁用，以禁止对其的访问。
这一功能有助于保护Zabbix数据库免受用户发起的任何更改，从而维护数据库的完整性。

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

在维护模式下，来自指定IP地址的用户仍可正常使用前端功能。

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

[comment]: # ({6815ccf2-dcfd8b13})
#### 配置

要启用维护模式，必须修改位于Web服务器上Zabbix HTML文档目录中的`/conf`文件内的`maintenance.inc.php` file，取消以下行的注释：

    // Maintenance mode.
    define('ZBX_DENY_GUI_ACCESS', 1);

    // 允许连接前端的IP地址array（可选）。

    $ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1');

    // 警告屏幕上显示的消息（可选）。
    $ZBX_GUI_ACCESS_MESSAGE = '我们正在升级MySQL数据库至15:00。请保持关注...';

[comment]: # ({/6815ccf2-dcfd8b13})

[comment]: # ({32830ba0-b1c13f3a})


::: notetip
大多数情况下，`maintenance.inc.php` file位于Web服务器上Zabbix HTML文档目录的`/conf`中。然而，该目录的位置可能因操作系统和使用的Web服务器而异。

 

例如：

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

另请参阅[复制php文件](/manual/installation/install#复制php文件)

:::

| 参数 | 详情 |
|--|--------|
| **ZBX\_DENY\_GUI\_ACCESS** | 启用维护模式：<br>1 - 启用维护模式，否则禁用 |
| **ZBX\_GUI\_ACCESS\_IP\_RANGE** | 允许连接前端的IP地址array（可选）<br>例如：<br>`array('192.168.1.1', '192.168.1.2')` |
| **ZBX\_GUI\_ACCESS\_MESSAGE** | 可输入的消息，用于通知用户有关维护的信息（可选） |

[comment]: # ({/32830ba0-b1c13f3a})

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

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

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

在ZBX\_GUI\_ACCESS\_IP\_RANGE中定义的IP地址将始终能够正常访问前端。

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