No description
Find a file
2026-09-22 12:18:34 -03:00
install-zabbix.sh Support subnet-based passive checks, short hostname and agent.ping test 2026-09-22 12:18:34 -03:00
LICENSE Add MIT license 2026-09-22 11:43:12 -03:00
README.md Support subnet-based passive checks, short hostname and agent.ping test 2026-09-22 12:18:34 -03:00

install-zabbixagent

Script para instalação e configuração automática do Zabbix Agent 2 em servidores Ubuntu e Debian.

Compatibilidade

  • Ubuntu 20.04
  • Ubuntu 22.04
  • Ubuntu 24.04
  • Debian 12
  • Debian 13

Configuração padrão

Item Valor
Zabbix Server 10.15.0.120
Redes permitidas (passive checks) 10.15.0.0/24, 192.168.0.0/24
Versão do Zabbix 7.4
Porta do Agent (passive) 10050
Porta do Server (active checks) 10051

Uso

Execute como root na máquina que receberá o agent:

wget -O install-zabbix.sh https://git.ledcloud.com.br/LED_Cloud/install-zabbixagent/raw/branch/main/install-zabbix.sh
chmod +x install-zabbix.sh
sudo ./install-zabbix.sh

Ou, se o repositório já estiver clonado localmente:

git clone https://git.ledcloud.com.br/LED_Cloud/install-zabbixagent.git
cd install-zabbixagent
chmod +x install-zabbix.sh
sudo ./install-zabbix.sh

O que o script faz

  1. Valida sistema operacional (Ubuntu/Debian e versão suportada).
  2. Instala dependências (wget, curl, ca-certificates, gnupg, iproute2).
  3. Detecta agentes Zabbix já instalados (zabbix-agent clássico e/ou zabbix-agent2).
  4. Para e remove agentes antigos: para e desabilita os serviços, encerra processos residuais (SIGTERM e, se necessário, SIGKILL), desinstala os pacotes (apt-get purge) e remove as configurações antigas (/etc/zabbix/zabbix_agentd.conf, /etc/zabbix/zabbix_agent2.conf e os diretórios .d correspondentes).
  5. Verifica se a porta TCP 10050 está livre antes de prosseguir; se algo ainda estiver escutando nela, o script para com erro.
  6. Adiciona o repositório oficial do Zabbix e instala o pacote zabbix-agent2.
  7. Configura /etc/zabbix/zabbix_agent2.conf do zero (remove entradas antigas/duplicadas das chaves e escreve o novo bloco de configuração):
    • Server = redes/IPs autorizados para passive checks (10.15.0.0/24,192.168.0.0/24)
    • ServerActive = IP do Zabbix Server + porta 10051
    • Hostname = hostname curto da máquina, detectado automaticamente
    • ListenPort = 10050
    • ListenIP = 0.0.0.0
    • Timeout = 10
    • O script também verifica se alguma dessas chaves ficou duplicada no arquivo final e falha se encontrar.
  8. Valida a configuração (zabbix_agent2 -T) antes de iniciar o serviço.
  9. Habilita e reinicia o serviço zabbix-agent2, valida a porta 10050, executa um teste local (agent.ping) e exibe versão e status do serviço.
  10. Ao final, imprime um resumo com os dados para cadastro do host no Zabbix (nome, interface, IP, porta, template recomendado) e os comandos zabbix_get para testar agent.ping/agent.hostname a partir do Zabbix Server.

Observações

  • O script precisa ser executado como root (sudo).
  • É seguro executar o script mais de uma vez na mesma máquina: instalações/configurações anteriores (Agent clássico ou Agent 2) são detectadas e removidas antes da reinstalação.
  • O Hostname configurado é o hostname curto da máquina (ex.: dns, não dns.dominio.com) — é esse o nome que deve ser usado ao cadastrar o host no Zabbix Server.
  • O parâmetro Server aceita as redes/IPs autorizados a fazer passive checks (10.15.0.0/24,192.168.0.0/24); ajuste a variável ZABBIX_ALLOWED no script se as redes permitidas forem outras.
  • Se a porta TCP 10050 continuar ocupada por outro processo após a remoção dos agentes antigos, o script para com erro — verifique manualmente o que está usando a porta.
  • Em caso de falha ao iniciar o serviço, o script exibe automaticamente os últimos 100 logs (journalctl -u zabbix-agent2).