Rebranding Zabbixu

Jak si změnit v Zabbixu logo na své vlastní a přizpůsobit si tak celý systém?

Přesně tím se bude zabývat tento článek. Zabbix umožňuje nativně změnit logo pro přihlašovací obrazovku a obě loga v menu. Tento rebranding lze jednoduše provést pomocí skrytého nastavení v souboru brand.conf.php.

Pokud chcete v Zabbixu provést rebranding, postupujte podle následujících kroků:

Vytvoření adresářové struktury a souborů

Nejprve zajistěte, že máte požadovanou strukturu adresářů. Vytvořte adresáře conf a rebranding:

sudo mkdir -p /usr/share/zabbix/local/conf
sudo mkdir -p /usr/share/zabbix/rebranding

Nahrání vlastních log

Připravte si loga s následujícími rozměry:

• Hlavní logo: 114×30 px
• Logo pro postranní panel: 91×24 px
• Kompaktní logo pro postranní panel: 24×24 px

Doporučené formáty souborů jsou SVG nebo PNG s transparentním pozadím. Ostatní formáty budou fungovat také, ale mohou mít okraje.

Případně můžete pro testování využít naše testovací data (obrázky a konfiguraci).

Nahrajte své obrázky do adresáře /usr/share/zabbix/rebranding. Můžete použít příkaz scp nebo rsync, pokud nahráváte z jiného serveru, nebo jednoduše zkopírujte soubory přímo:

sudo cp /cesta/k/vašim/obrázkům/*.svg /usr/share/zabbix/rebranding/

Oprávnění k souborům vyřešíme později.

Nastavení brand.conf.php

Vytvořte nebo upravte soubor brand.conf.php:

sudo nano /usr/share/zabbix/local/conf/brand.conf.php

Příklad obsahu souboru:

<?php
return [
    'BRAND_LOGO' => './rebranding/initMAX_Zabbix_Logo_Colors_114x30.svg',
    'BRAND_LOGO_SIDEBAR' => './rebranding/initMAX_Zabbix_Logo_White_91x24.svg',
    'BRAND_LOGO_SIDEBAR_COMPACT' => './rebranding/initMAX_Zabbix_Symbol_White_24x24.svg',
    'BRAND_FOOTER' => 'initMAX s.r.o.',
    'BRAND_HELP_URL' => 'https://www.initmax.com/'
];

Ujistěte se, že názvy souborů odpovídají nastavení v brand.conf.php.

V případě potřeby můžete jednotlivé části zakomentovat pomocí dvou obrácených lomítek //.

Co znamenají jednotlivé části v PHP kódu?

• BRAND_LOGO – Hlavní logo, které se zobrazí na přihlašovací obrazovce.
• BRAND_LOGO_SIDEBAR – Logo, které se objeví v levém menu.
• BRAND_LOGO_SIDEBAR_COMPACT – Logo pro levé menu v kompaktním režimu (symbol).
• BRAND_FOOTER – Možnost přidat vlastní text do patičky.
• BRAND_HELP_URL – URL, která se otevře po kliknutí na tlačítko „Help“.

Nastavení oprávnění

Ujistěte se, že soubory a složky mají správná oprávnění a vlastníka (obvykle www-data nebo apache, v závislosti na konfiguraci webového serveru):

sudo chown -R www-data:www-data /usr/share/zabbix/local/conf
sudo chmod 755 /usr/share/zabbix/local/conf
sudo chmod 644 /usr/share/zabbix/local/conf/brand.conf.php
sudo chown -R www-data:www-data /usr/share/zabbix/rebranding
sudo chmod 755 /usr/share/zabbix/rebranding
sudo chmod 644 /usr/share/zabbix/rebranding/*

Kontrola rebrandingu

Otevřete Zabbix webové rozhraní a zkontrolujte, zda se nové logo a další prvky rebrandingu zobrazují správně. Pravděpodobně bude potřeba vymazat cache prohlížeče, aby se změny plně projevily.

Dodatečný tip: Pokud se v kompaktním režimu ikona zobrazuje dvakrát, jedná se o známý bug (viz ZBX-23676), který je vyřešen ve verzích od:

pre-7.2.0alpha2 (master) – commit 6f04c309093

pre-7.0.6rc1 – commit 0026d10fee4

Další nápady na vylepšení rebrandingu

Pro lepší přizpůsobení Zabbixu můžete přidat vlastní ikony a favicon, což zajistí konzistentní vzhled v záložkách prohlížeče i na mobilních zařízeních. Ikony stačí nahrát do adresáře, kde jsou umístěny webové soubory Zabbixu.

Pokud potřebujete ikony rychle vygenerovat, můžete použít RealFaviconGenerator – stačí nahrát vaše logo a stáhnout si balíček hotových ikon.

Tip: Doporučujeme nahrát ikony do adresáře s rebrandingem. Pokud je ale chcete přidat trvale, bude nutné upravit konfiguraci Apache nebo Nginx, aby se např. favicon.ico nepřepsalo po aktualizaci. V případě potřeby nás neváhejte kontaktovat o radu.