Instalação

Antes de instalar

Em laboratório ou ambiente pequeno, Server, frontend e banco podem coexistir no mesmo host. Em ambientes maiores, o banco merece atenção especial. Defina hostname, IP estável, DNS, armazenamento, retenção, backup e regras de firewall antes de começar.

Adicionar o repositório

Prefira os pacotes oficiais do Zabbix. Pacotes fornecidos diretamente por distribuições Debian-based podem estar desatualizados.

Debian 12

apt update
apt install -y wget

wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.deb
apt update

Ubuntu 24.04

apt update
apt install -y wget

wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.deb
apt update

Instalar os pacotes

apt install -y \
  zabbix-server-mysql \
  zabbix-frontend-php \
  zabbix-apache-conf \
  zabbix-sql-scripts \
  zabbix-agent2

apt install -y mariadb-server

Criar banco e usuário

Para novas instalações MySQL/MariaDB, utilize UTF-8. O exemplo abaixo usa utf8mb4 com utf8mb4_bin.

mysql -u root -p

CREATE DATABASE zabbix
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_bin;

CREATE USER 'zabbix'@'localhost'
  IDENTIFIED BY 'SENHA_FORTE_AQUI';

GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Importar a estrutura inicial

zcat /usr/share/zabbix-sql-scripts/mysql/server.sql.gz \
  | mysql --default-character-set=utf8mb4 \
  -uzabbix -p zabbix

Se binary logging estiver ativo e a importação falhar ao criar funções/triggers, consulte a orientação oficial sobre log_bin_trust_function_creators antes de alterar o banco.

Configurar a conexão

Edite /etc/zabbix/zabbix_server.conf:

DBName=zabbix
DBUser=zabbix
DBPassword=SENHA_FORTE_AQUI

Iniciar o ambiente

systemctl restart zabbix-server zabbix-agent2 apache2
systemctl enable zabbix-server zabbix-agent2 apache2 mariadb

systemctl status zabbix-server
systemctl status zabbix-agent2
systemctl status apache2

Concluir pelo navegador

Abra o frontend e conclua o assistente com os dados do banco:

Em produção, utilize HTTPS e restrinja o acesso administrativo.

Portas mais comuns

Não exponha essas portas indiscriminadamente à Internet. Libere somente os fluxos necessários entre redes de gerenciamento e componentes.

Se não subir, comece pelos logs

systemctl status zabbix-server
systemctl status zabbix-agent2

journalctl -u zabbix-server -n 100 --no-pager
journalctl -u zabbix-server -f

Instalar é só o começo

Antes de considerar o ambiente pronto, revise HTTPS, firewall, backup, retenção, crescimento do banco, atualização, usuários administrativos e monitoramento do próprio Zabbix.

Instalado não significa pronto

A arquitetura pode começar simples e evoluir

LABORATÓRIO
1 VM:
- Zabbix Server
- Frontend
- Database
- Agent 2

PRODUÇÃO MÉDIA
- Server dedicado
- Database dedicado
- Frontend
- Proxy por site quando necessário

PRODUÇÃO CRÍTICA
- Server HA
- Database HA
- múltiplos frontends
- Proxy / Proxy groups
- backup + DR
- observabilidade do próprio Zabbix

Use o repositório oficial da versão suportada

A documentação oficial do Zabbix 7.4 mantém pacotes para Debian e Ubuntu e recomenda usar os pacotes oficiais do projeto. Distribuições Debian-based podem oferecer seus próprios pacotes, mas eles podem estar desatualizados ou sem correções e recursos recentes. Antes de copiar comandos, confirme distribuição, versão, banco e web server no seletor oficial.

Instale já pensando na próxima versão

Mantenha banco, arquivos de configuração, scripts externos e certificados em backup; documente repositório e versões; evite alterações manuais não versionadas no frontend/web server. A documentação oficial de upgrade recomenda revisar as notas da versão, fazer backup e acompanhar logs do Server/Proxy durante a atualização.

Base factual

Conteúdo revisado com base na documentação oficial Zabbix 7.4 sobre instalação e primeiros passos, instalação por pacotes e procedimentos Debian/Ubuntu. Os comandos devem sempre ser confrontados com o seletor oficial de pacotes para a distribuição usada em produção.

Agora começa o monitoramento

Linha Zabbix 7.4

Use sempre o repositório oficial correspondente ao SO e ao release alvo. Antes de atualizar, revise requisitos mínimos, banco suportado, PHP, extensões e upgrade notes da versão exata.