Zabbix Web UI 로고·타이틀 커스터마이징 가이드

환경: Zabbix 7.4.3 / Ubuntu 22.04 / Apache2

Zabbix Web UI를 회사 내부 모니터링 포털처럼 보이게 하고 싶을 때 필요한 작업이 바로 Branding(브랜딩) 설정이다.
문제는 공식 문서도 너무 간단하고, 버전마다 UI 루트 구조가 달라서 그대로 따라 하면 잘 안 되는 경우가 아주 많다.

이 글은 다음 환경을 기준으로 완전히 검증된 방법을 정리한다.

• Zabbix 7.4.3
• Ubuntu 22.04
• Apache2
• Alias /zabbix /usr/share/zabbix/ui 인 환경 기준
  
  즉, 웹에서 쓰는 프런트엔드 루트는 /usr/share/zabbix/ui 다.
  

1. 왜 기존 레퍼런스대로 하면 안 되는 경우가 많나

Zabbix 7.x 계열은 설치하면 보통 디렉터리가 이렇게 생긴다.

/usr/share/zabbix
/usr/share/zabbix/ui

그래서 find / -type f -name "index.php" | grep zabbix 하면:

둘 다 뜨는 게 정상이다.

문제는 Apache가 실제로 어떤 경로를 /zabbix 로 쓰는지인데, 이건 설정을 봐야 한다.

# grep -R “Alias /zabbix” /etc/apache2 2>/dev/null

→ 이 환경에서 Web UI 루트는 /usr/share/zabbix/ui 가 맞다.
그래서 branding 파일이랑 로고 경로도 전부 이 기준으로 잡아야 한다.

2. Zabbix Branding 개념 간단 정리

Zabbix 6.x 이후에는 brand.conf.php 하나로 Web UI를 리브랜딩할 수 있다. 여기서 바꿀 수 있는 건:

• BRAND_LOGO
  로그인 화면 상단 로고
• BRAND_LOGO_SIDEBAR
  왼쪽 사이드바 상단 로고
• BRAND_LOGO_SIDEBAR_COMPACT
  사이드바 최소화(컴팩트) 모드에서 쓰는 작은 아이콘
• BRAND_FOOTER
  화면 맨 아래 푸터 텍스트
• BRAND_HELP_URL
  로그인 화면/좌측 메뉴의 “Help” 링크로 열리는 URL

이건 “코어 파일을 뜯어 고치는 해킹”이 아니라, Zabbix가 공식으로 제공하는 브랜드 설정 포인트다.
회사 이름, 서비스 이름, 포털 느낌 내고 싶을 때 여기만 손대면 된다.

3. 로고파일 준비

프런트엔드 루트가 /usr/share/zabbix/ui 이므로,
로고는 /usr/share/zabbix/ui/local/logo 아래에 두어야 한다.

# mkdir -p /usr/share/zabbix/ui/local/logo

=> 해당 경로에 이미지 업로드

포맷은 PNG 권장.

4. brand.conf.php 작성 – 실제 예시

이제 브랜딩 설정 파일을 만든다.

# cd /usr/share/zabbix/ui/local/conf

# vi brand.conf.php

예시 :

<?php
return [
    // 로그인 화면 상단 로고
    'BRAND_LOGO' => 'local/logo/logo_main.png',

    // 왼쪽 사이드바 상단 로고
    'BRAND_LOGO_SIDEBAR' => 'local/logo/logo_main.png',

    // 사이드바 최소화(컴팩트) 모드 로고
    'BRAND_LOGO_SIDEBAR_COMPACT' => 'local/logo/logo_compact.png',

    // 화면 하단 푸터 문구
    'BRAND_FOOTER' => 'Black K Monitoring System',

    // Help 버튼 클릭 시 이동할 URL
    'BRAND_HELP_URL' => 'https://www.example.com'
];

여기서 포인트 몇 개:

1. 경로는 반드시 “프런트엔드 루트 기준 상대 경로”
   • 루트가 /usr/share/zabbix/ui 이므로
   • local/logo/logo_main.png → 실제 파일은 /usr/share/zabbix/ui/local/logo/logo_main.png
2. 사이드바 로고랑 메인 로고를 같은 이미지로 써도 되고,
   • 필요하면 logo_sidebar.png 따로 만들어서 BRAND_LOGO_SIDEBAR 에만 넣어도 된다.

5. 권한 설정 – 적용 안 될 때 제일
먼저 의심할 부분

# vi /etc/apache2/conf-available/zabbix.conf
: 아래 해당 부분 주석 처리

: 아래 해당 블록 추가

설정 완료 후 apache restart

6. Zabbix 상단 이름(Server Name) 변경

로고와 별개로, 화면 상단/브라우저 탭에 뜨는 “Zabbix server” 같은 이름은
zabbix.conf.php 에서 바꾼다.

이 파일 위치는 UI 루트와는 별개로, 보통 그대로 /usr/share/zabbix/conf 이다.

# cd /usr/share/zabbix/ui/conf
# cp zabbix.conf.php zabbix.conf.php.org   # 백업
# vi zabbix.conf.php

안에서 아래 라인을 찾아서:

원하는 이름으로 수정:

$ZBX_SERVER_NAME = 'Black K Monitoring System';

이 값은:

• 로그인 후 왼쪽 사이드바 로고 아래 문구
• 브라우저 탭 문구
  에 쓰인다.
  Zabbix 서버 프로세스나 DB 설정과는 아무 상관 없다.

7. 적용 확인 + 캐시 주의

브라우저에서 바로 새로고침(Ctrl+F5) 하거나,
시크릿 모드로 http://<서버주소>/zabbix 에 다시 접속해서 확인하도록 한다.

• 로그인 화면 로고가 교체됐는지
• 브라우저 탭 문구가 $ZBX_SERVER_NAME 값으로 보이는지
• 로그인 후 왼쪽 사이드바 로고가 교체됐는지
• 로그인 후 왼쪽 사이드바 로고 아래 문구가 교체됐는지
• 화면 맨 아래 푸터에 적용한 문구가 나오는지

이 다섯 가지를 순서대로 확인하면 된다.

로고는 브라우저 캐시를 많이 타서,
“분명 바꿨는데도 예전 로고가 보인다” 싶으면:

• 시크릿(프라이빗) 창으로 테스트하는 게 제일 빠르다.

8. 한 줄 요약

• 이 환경(Ubuntu 22.04 / Zabbix 7.4.3 / Apache2)에서는
  Alias /zabbix /usr/share/zabbix/ui 이므로,
• 브랜딩 설정은 /usr/share/zabbix/ui/local/conf/brand.conf.php 에서 한다.
• 로고 파일은 /usr/share/zabbix/ui/local/logo/ 에 두고,
  BRAND_LOGO 등에는 local/logo/파일명.png 형식으로 적는다.
• 상단 타이틀은 /usr/share/zabbix/conf/zabbix.conf.php 의 $ZBX_SERVER_NAME 으로 바꾼다.

🛠 마지막 수정일: 2025.11.26