프런트엔드 유지보수 모드

Zabbix v7.4번역일: 2026-09-09원본 보기

개요

접근을 제한하기 위해 Zabbix 프런트엔드를 일시적으로 비활성화할 수 있습니다. 이는 사용자가 발생시키는 변경으로부터 Zabbix 데이터베이스를 보호하고 무결성을 유지하는 데 유용합니다.

Zabbix 프런트엔드가 유지보수 모드에 있는 동안, 데이터베이스를 안전하게 중지하고 유지보수 작업을 수행할 수 있습니다.

정의된 IP 주소의 사용자는 유지보수 모드 중에도 프런트엔드와 정상적으로 상호작용할 수 있습니다.

설정

유지보수 모드를 활성화하려면, 웹 서버의 Zabbix HTML 문서 디렉터리 /conf에 위치한 maintenance.inc.php 파일을 열고 다음 줄의 주석을 해제하세요:

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

// Array of IP addresses, which are allowed to connect to frontend (optional).
$ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1');

// Message shown on warning screen (optional).
$ZBX_GUI_ACCESS_MESSAGE = 'We are upgrading MySQL database till 15:00. Stay tuned...';

대부분의 경우, maintenance.inc.php 파일은 웹 서버의 Zabbix HTML 문서 디렉터리 /conf에 위치합니다. 다만 일부 운영체제와 웹 서버는 다른 위치를 사용할 수 있습니다.

예를 들어, 위치는 다음과 같습니다:

SUSE 및 RedHat은 /etc/zabbix/web/maintenance.inc.php입니다.
Debian 기반 시스템은 /usr/share/zabbix/conf/입니다.

참고: PHP 파일 복사.

매개변수	상세
ZBX_DENY_GUI_ACCESS	임의의 값으로 정의되면 유지보수 모드가 활성화됩니다. 유지보수 모드를 비활성화하려면 주석 처리하거나 삭제하세요.
ZBX_GUI_ACCESS_IP_RANGE	프런트엔드 연결이 허용되는 IP 주소 배열(선택 사항). 예: `array('192.168.1.1', '192.168.1.2')`
ZBX_GUI_ACCESS_MESSAGE	사용자에게 유지보수 사실을 알리는 메시지(선택 사항). 정의되지 않으면 기본 메시지 'Zabbix is under maintenance'가 사용됩니다.

표시

유지보수 모드 중 Zabbix 프런트엔드에 접근을 시도하면 사용자에게 다음 화면이 표시됩니다. 이 화면은 유지보수가 끝나면 사용자 개입 없이 정상 상태로 돌아가도록 30초마다 새로고침됩니다.

ZBX_GUI_ACCESS_IP_RANGE에 정의된 IP 주소는 평소처럼 프런트엔드에 접근할 수 있습니다.