Ao escolher um sistema operacional para hospedar um ambiente de monitoramento, estabilidade e confiabilidade são fatores fundamentais.
Nesse contexto, vale mencionar que o Zabbix pode rodar em quaisquer distribuições Linux, tendo pacotes oficiais para Red Hat, Rocky, Alma, CentOS, Debian, Ubuntu e SUSE.
O Debian, ao longo de décadas, consolidou-se como uma distribuição extremamente estável, madura e amplamente confiável, características que o tornam uma base sólida para aplicações críticas.
Por isso, por aqui, vamos explicar como realizar a instalação do Zabbix neste sistema operacional, com melhores práticas e recomendações técnicas.
O que é o Debian?
O Debian é um sistema livre e de código aberto, mantido por uma grande comunidade global que garante atualizações contínuas, cuidadosamente testadas e distribuídas de maneira suave, evitando rupturas no ambiente de produção.
Esse sistema operacional conta com elevada compatibilidade com diversos hardwares, desde servidores mais antigos até infraestruturas modernas, o que facilita a adoção em ambientes heterogêneos.
Não por acaso, o Debian é utilizado como base para inúmeras outras distribuições Linux, graças à sua robustez e confiabilidade.
Esse perfil se conecta diretamente com a filosofia do próprio Zabbix, que também é um software livre, altamente confiável, escalável e amplamente adotado em ambientes corporativos.
Assim, ao combinar Zabbix + Debian, você obtém um ecossistema inteiramente construído sobre pilares de estabilidade, segurança e liberdade tecnológica. Uma escolha alinhada às melhores práticas e recomendada por profissionais e comunidades de monitoramento ao redor do mundo.
Cenários comuns de instalação Zabbix e Debian: POC, Desenvolvimento e Produção
Quando falamos sobre implantação do Zabbix, normalmente lidamos com três cenários distintos: POC, Desenvolvimento e Produção. Cada um tem seu propósito e seu nível de criticidade.
POC (Prova de Conceito)
O ambiente de POC é aquele espaço criado para experimentar. Aqui avaliamos se a ferramenta atende ao que precisamos, testamos funcionalidades, verificamos se algo novo realmente funciona e validamos ideias antes de seguir para algo mais estrutural. É um ambiente temporário, leve e focado em aprendizado e validação.
Ambiente de Produção
Este é o ambiente principal, onde a monitoração é “pra valer”. É nele que qualquer falha, deslize ou configuração errada pode impactar diretamente o negócio. Por isso, mudanças em Produção precisam ser tratadas com muito cuidado.
O ideal — e o recomendado — é que nenhum ajuste seja feito diretamente nesse ambiente sem ter sido validado antes em POC, testes ou desenvolvimento. É aqui que a estabilidade importa mais do que tudo.
Ambiente de Desenvolvimento
O ambiente de Desenvolvimento costuma ser um espelho (ou o mais próximo possível) de Produção. É nele que criamos e refinamos tudo que será aplicado depois: templates, integrações, ajustes, novos módulos, otimizações e qualquer outro tipo de experimento. É o laboratório onde as ideias amadurecem antes de ganharem vida no ambiente real.
Principais formas de instalação do Zabbix
Existem diferentes maneiras de instalar o Zabbix, cada uma voltada para cenários específicos e níveis distintos de complexidade e personalização. Abaixo, um resumo das principais abordagens:
Instalação via repositório oficial
Essa é a forma mais simples e direta. O servidor precisa ter acesso à internet para baixar todos os pacotes e dependências diretamente dos repositórios oficiais do Zabbix.
É o método mais utilizado quando buscamos rapidez, praticidade e conformidade com o padrão recomendado pela própria comunidade Zabbix. Tudo é resolvido automaticamente via download, sem necessidade de ajustes manuais.
Instalação via sources
Aqui o processo é mais manual. É preciso baixar o código‑fonte (por exemplo: Zabbix source package), configurar, compilar e instalar tudo na mão.
Esse método é recomendado quando há necessidade de customizações específicas ou para habilitar apenas determinados módulos de monitoramento.
É também a opção escolhida por quem deseja um nível maior de controle ou está lidando com arquiteturas mais personalizadas.
Instalação com banco de dados local
Nesse modelo, todos os componentes ficam no mesmo servidor/VM:
- Zabbix Server
- Frontend
- Banco de dados
É uma solução prática para ambientes menores, com poucos hosts e baixo volume de métricas. Oferece simplicidade de operação, menor consumo de recursos e menos pontos de falha, mas não escala bem para infraestruturas maiores.
Instalação com banco de dados externo (PostgreSQL ou MySQL)
Nesse caso, a arquitetura é distribuída em pelo menos dois servidores:
- VM APP: Zabbix Server + Frontend
- VM BD: Banco de dados (PostgreSQL ou MySQL)
Como o banco de dados é externo, é necessário configurá-lo para aceitar conexões remotas e ajustar os parâmetros de segurança.
É altamente recomendado restringir ao máximo o acesso remoto ao banco e utilizar credenciais fortes, já que o BD concentra toda a inteligência histórica do ambiente.
Esse modelo é indicado para ambientes de médio a grande porte, garantindo melhor performance, escalabilidade e isolamento entre camadas. Ainda é possível separar o Zabbix Server do servidor que compartilha com o Frontend, assim teremos:
- VM APP: Zabbix Server
- VM FRONT: Frontend
- VM BD: Banco de dados (PostgreSQL ou MySQL)
Pré-requisitos para instalação do Zabbix no Debian
A documentação do Zabbix é muito completa e detalhada, quanto aos requisitos mínimos de hardware, pacotes e versão de sistemas operacionais.
Todos os detalhes podem ser verificados na página Requisitos, disponível na documentação do software de monitoramento.
Importante ressaltar que cada ambiente é único. Por isso, a quantidade de métricas (que são compostas por: 1 item + 1 trigger + 1 gráfico), deve ser diferente de outros ambientes e assim por diante.
Então, é normal e esperado que ajustes de configuração e redimensionamento das máquinas virtuais ou servidores sejam necessários ao longo do tempo.
Antes de realizar qualquer instalação dos pacotes, verifique e ajuste o timezone em timedatectl:
Caso seja necessário algum ajuste, utilize o comando:
timedatectl list-timezones:
Utilize o comando:
sudo timedatectl set-timezone America/Sao_Paulo
E faça a alteração para o seu timezone.
Passo a passo: Instalação do Zabbix no Debian
1 – Adição do repositório Zabbix e instalação
Faça a adição a partir do link de repositório.
# wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian12_all.deb
# dpkg -i zabbix-release_latest_7.0+debian12_all.deb
# apt update
Após os passos terem sido executados com sucesso, estamos prontos para realizar de fato a instalação do Zabbix Server, Frontend e Agent.
Para seguirmos, execute o comando:
# apt install zabbix-server-mysql zabbix-frontend-php zabbix-nginx-conf zabbix-sql-scripts zabbix-agent
Confirme com Y para prosseguir com a instalação dos pacotes e dependências.
Após a instalação de todos os pacotes, a saída no terminal deve ser semelhante a esta:
Isso indica que todos os pacotes obtiveram sucesso durante a instalação.
A partir daqui, podemos seguir para o banco de dados.
2 – Instalação do MySQL e configuração da base de dados
Faça download do pacote do MySQL na última versão:
# wget https://dev.mysql.com/get/mysql-apt-config_0.8.36-1_all.deb
Prossiga com o seguinte comando:
# dpkg -i mysql-apt-config_0.8.36-1_all.deb
Ao executar o comando acima, deve ser exibida uma tela semelhante a esta:
É importante que mantenha a linha MySQL Server & Cluster selecionada e confirme clicando com a tecla ENTER.
Depois, selecione a versão (por exemplo: mysql-8.0) e pressione ENTER novamente.
Após, pressione a tecla Down do teclado e selecione OK.
Pronto, o repositório está instalado e configurado para ser utilizado.
Com o comando abaixo, se inicia a instalação do MySQL:
# apt install mysql-server -y
Caso o sistema apresente o seguinte erro:
É provável que esteja relacionado ao conflito entre os pacotes do MySQL e MariaDB (Fork do MySQL).
Para solucionar, utilize o comando abaixo para realizar a remoção do pacote conflituoso:
# apt remove --purge mariadb-* -y
E seguimos com o comando para realizarmos a instalação do MySQL:
# apt install mysql-server -y
Durante a instalação, deve ser solicitada a senha do usuário root. Recomendamos que seja utilizada uma senha forte.
Nesta etapa também deve surgir a necessidade de selecionar o tipo de autenticação, como no exemplo abaixo:
Pressione ENTER na opção “RECOMMENDED”.
Após isso, a instalação deve ser finalizada:
Podemos verificar a versão instalada com o seguinte comando:
# mysql –version
Com o gerenciador de bancos de dados (SGBD) instalado, podemos seguir para a criação da base de dados do Zabbix, com a importação da carga inicial e a criação de um usuário.
Entre no MySQL utilizando o seguinte comando:
# mysql -uroot -p
Deve ser solicitada a senha configurada durante a instalação. Tendo sucesso na autenticação, a tela seguinte será como no exemplo abaixo:
Utilize o comando abaixo para criar a base de dados do Zabbix:
mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin;
A seguir, utilize o comando abaixo para criar o usuário que acessará e utilizará a base do Zabbix:
create user zabbix@localhost identified by 'password';
Em “password“, utilize uma senha forte, pois este usuário terá total privilégios a base de dados Zabbix.
Após a execução do comando, o retorno deve ser semelhante a este:
Com o comando abaixo, será atribuído todos os privilégios ao usuário Zabbix a base de dados Zabbix:
mysql> grant all privileges on zabbix.* to zabbix@localhost;
Agora, habilite o log bin durante importação da base do dados Zabbix:
mysql> set global log_bin_trust_function_creators = 1;
É possível utilizar quit para sair do modo console do MySQL e seguir com a importação.
Para isso, insira o comando abaixo:
zcat /usr/share/zabbix-sql-scripts/mysql/server.sql.gz | mysql --default-character-set=utf8mb4 -uzabbix -p zabbix
Será solicitado a senha do usuário Zabbix. Digite e pressione ENTER, e aguarde o processo de importação:
Após finalizar a importação, acesse novamente a console do MySQL:
# mysql -uroot -p
Insira a senha e parta para a checagem da importação das tabelas do Zabbix.
Para isso, insira o comando:
mysql> use zabbix;
Isso significa que agora os comandos executados serão dentro da base do Zabbix, pois um servidor de banco de dados podem ter inúmeras bases de dados.
Para verificar se todas as tabelas estão presentes, insira o comando:
mysql> show tables;
É esperado que tenha um valor de, aproximadamente, 203 tabelas.
Agora vamos desabilitar o log_bin_trust_function_creators e sair da console do MySQL:
mysql> set global log_bin_trust_function_creators = 0; mysql> quit;
Finalizado a instalação do MySQL e importação da base de dados do Zabbix, podemos editar o arquivo do Zabbix Server. Por padrão o arquivo fica em: /etc/zabbix/ .
Caso o arquivo não esteja disponível neste caminho, verifique se o comando de instalação do Zabbix Server foi executado corretamente e reinstale com o seguinte comando:
# apt install zabbix-server-mysql
É possível utilizar qualquer editor em que o usuário se sinta confortável. Neste exemplo, utilizaremos o comando vi:
# vi /etc/zabbix/zabbix_server.conf
Pesquise pelo parâmetro DBPassword=, “descommente” a linha, removendo o # e insira a senha escolhida para o usuário Zabbix no momento da criação da base de dados.
Configure o Nginx para permitir o acesso Web ao Zabbix Frontend:
# vim /etc/zabbix/nginx.conf
“Descommente” as linhas listen e server_name:
Finalmente inicie os serviços necessários para o funcionamento do Zabbix Server:
# systemctl restart zabbix-server zabbix-agent nginx php8.2-fpm
Com o comando abaixo, é possível visualizar todo output do log do Zabbix Server:
# cat -f /var/log/zabbix/zabbix_server.log
Também é possível utilizar a seguinte combinação:
# systemctl restart zabbix-server zabbix-agent nginx php8.2-fpm | tail -f /var/log/zabbix/zabbix_server.log
Com o comando abaixo, garantimos que caso o servidor seja reiniciado ou desligado e que, ao religá-lo, o zabbix-server, zabbix-agent, nginx e o php sejam iniciados automaticamente:
# systemctl enable zabbix-server zabbix-agent nginx php8.2-fpm
Como validação, é possível verificar o status dos serviços utilizando o comando:
# systemctl status zabbix-server zabbix-agent nginx php8.2-fpm
Com isso, está finalizada toda instalação e configurações iniciais do Zabbix Server.
Agora, podemos acessar o Zabbix Frontend para finalizar os últimos ajustes.
Abra o navegador e digite:
http://{IP DO SERVIDOR}:8080/setup.php
O resultado deve ser uma tela semelhante a essa:
Faça a checagem dos pré-requisitos para o Zabbix Frontend:
Configure a conexão entre o Zabbix Frontend e a base de dados:
Defina um nome para o Zabbix Server, timezone e escolha um tema padrão:
Verifque o resumo e finalize:
Todas essas configurações estão contidas no arquivo: /etc/zabbix/web/zabbix.conf.php
Acesse o Zabbix utilizando as credenciais:
- Username: Admin
- Password: zabbix
Essa é a tela esperada, após o login ter sido realizado com sucesso:
Após as validações iniciais, navegue por todos os menus e verifique a monitoração do próprio Zabbix Server:
E altere a senha padrão do usuário Admin:
Conclusão
Ao final desta instalação, podemos afirmar que o Debian é um sistema operacional robusto, estável e plenamente adequado para a implantação do Zabbix como plataforma de monitoramento.
Foram apresentadas diferentes possibilidades de instalação e arquiteturas de implementação, considerando os componentes Zabbix Server, Frontend e Banco de Dados, permitindo flexibilidade conforme a necessidade do ambiente.
Também detalhamos os principais comandos utilizados para a instalação bem-sucedida da solução, além da verificação e análise de logs dos serviços essenciais para garantir seu pleno funcionamento.
Com isso, demonstramos que, seguindo as boas práticas e os procedimentos corretos, é possível realizar uma implantação segura, estável e eficiente do Zabbix em ambiente Debian.
Prev Post 
