Powrót do strony głównej

Zabbix Agent 2 na Linux

Instrukcja instalacji agenta monitorującego na serwerach Linux - Ubuntu, Debian, RHEL, Rocky Linux, CentOS Stream, AlmaLinux. Konfiguracja trybu aktywnego z szyfrowaniem TLS PSK.

1

Załóż konto i wygeneruj PSK

Przed instalacją agenta zaloguj się do panelu klienta i wygeneruj klucz TLS PSK dla monitorowanego hosta. Każdy host powinien mieć własny, unikalny klucz.

Panel klienta

Co otrzymasz w panelu:
  • PSK Identity - publiczny identyfikator klucza (np. PSK-hostname-2026)
  • PSK - 64-znakowy klucz w formacie hex (256-bit)
2

Dodaj repozytorium Zabbix i zainstaluj agenta

Wybierz swoją dystrybucję:

Ubuntu 24.04 LTS (noble):

# Pobierz i zainstaluj pakiet repo wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.0+ubuntu24.04_all.deb sudo dpkg -i zabbix-release_latest_7.0+ubuntu24.04_all.deb sudo apt update # Zainstaluj agenta 2 sudo apt install -y zabbix-agent2 zabbix-agent2-plugin-*

Dla Ubuntu 22.04 zamień ubuntu24.04 na ubuntu22.04 w URL-u pakietu.

Debian 12 (bookworm):

wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian12_all.deb sudo dpkg -i zabbix-release_latest_7.0+debian12_all.deb sudo apt update sudo apt install -y zabbix-agent2 zabbix-agent2-plugin-*

Dla Debian 11 użyj debian11.

RHEL / Rocky / Alma / CentOS Stream 9:

sudo rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rocky/9/x86_64/zabbix-release-latest.el9.noarch.rpm sudo dnf clean all sudo dnf install -y zabbix-agent2 zabbix-agent2-plugin-*

Dla EL8 zamień /rocky/9/ na /rocky/8/ oraz .el9. na .el8..

3

Skonfiguruj klucz PSK

Zapisz wygenerowany w panelu klucz PSK do pliku /etc/zabbix/zabbix_agent2.psk i ustaw uprawnienia.

# Wklej klucz z panelu klienta (sam hex, bez nagłówków) sudo tee /etc/zabbix/zabbix_agent2.psk > /dev/null << 'EOF' 1a2b3c4d5e6f...TUTAJ_WKLEJ_64_ZNAKI_HEX...f9e8d7c6b5a4 EOF sudo chown zabbix:zabbix /etc/zabbix/zabbix_agent2.psk sudo chmod 640 /etc/zabbix/zabbix_agent2.psk
Bezpieczeństwo: Plik PSK zawiera sekret - nie commituj go do repozytoriów, nie udostępniaj przez email. Używaj scp/ansible-vault lub wklej ręcznie przez SSH.
4

Skonfiguruj zabbix_agent2.conf

Edytuj plik /etc/zabbix/zabbix_agent2.conf i ustaw poniższe wartości (reszta domyślnie).

Server=zabbix.inpi.pl ServerActive=zabbix.inpi.pl Hostname=nazwa-twojego-serwera # TLS PSK - szyfrowanie ruchu z serwerem TLSConnect=psk TLSAccept=psk TLSPSKIdentity=PSK-nazwa-twojego-serwera-2026 TLSPSKFile=/etc/zabbix/zabbix_agent2.psk
Hostname musi być identyczny z nazwą hosta podaną w panelu klienta podczas generowania PSK. Najłatwiej użyć wyniku komendy hostname -f.
5

Otwórz firewall (tryb aktywny)

W trybie aktywnym to agent inicjuje połączenie do zabbix.inpi.pl:10051, więc nie trzeba otwierać portu przychodzącego. Upewnij się tylko, że ruch wychodzący na port 10051/TCP jest dozwolony.

# UFW (Ubuntu/Debian) - zwykle ruch wychodzący jest domyślnie dozwolony, ale dla porządku: sudo ufw allow out 10051/tcp # firewalld (RHEL/Rocky) - analogicznie, outbound zazwyczaj otwarty # Brak akcji wymaganej, chyba że masz własne reguły OUTPUT
6

Uruchom i zweryfikuj agenta

sudo systemctl enable --now zabbix-agent2 sudo systemctl status zabbix-agent2 # Sprawdź logi sudo tail -f /var/log/zabbix/zabbix_agent2.log
Oczekiwany wynik: W logu znajdziesz wpisy active check configuration update from [zabbix.inpi.pl:10051] started oraz Zabbix Agent 2 started. Jeśli widzisz TLS handshake bez błędów - PSK działa poprawnie.
Najczęstsze błędy:
  • host [...] not found - Hostname w konfigu ≠ nazwa w Zabbix. Zgłoś hostname do maciej.pienczyn@inpi.pl.
  • TLS handshake failed - zła wartość PSK Identity lub plik .psk zawiera nadmiarowe znaki (spacje/EOL).
  • connection refused - firewall lub NAT blokuje ruch wychodzący na 10051/TCP.
7

Zgłoś host do rejestracji

Gdy agent startuje i łączy się z serwerem, wyślij krótki mail do maciej.pienczyn@inpi.pl z informacją o nowym hoście: nazwa (Hostname), typ systemu (np. Ubuntu 24.04 / Web Server), oczekiwane szablony monitoringu. Po aktywacji host pojawi się w Zabbix w ciągu kilku minut.

Potrzebujesz pomocy?

Zespół techniczny INPI pomaga z instalacją i konfiguracją agenta w godzinach 8:00-16:00.

maciej.pienczyn@inpi.pl