No description
Find a file
2026-09-22 11:44:07 -03:00
install-zabbix.sh Update install-zabbix.sh to detect and remove old agents before reinstall 2026-09-22 11:44:07 -03:00
LICENSE Add MIT license 2026-09-22 11:43:12 -03:00
README.md Update install-zabbix.sh to detect and remove old agents before reinstall 2026-09-22 11:44:07 -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
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. Detecta o sistema operacional e valida se é suportado.
  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) e desinstala os pacotes (apt-get purge).
  5. Remove configurações antigas (/etc/zabbix/zabbix_agentd.conf, /etc/zabbix/zabbix_agent2.conf e os diretórios .d correspondentes).
  6. Verifica se a porta TCP 10050 está livre antes de prosseguir; se algo ainda estiver escutando nela, o script para com erro.
  7. Adiciona o repositório oficial do Zabbix e instala o pacote zabbix-agent2.
  8. Configura /etc/zabbix/zabbix_agent2.conf do zero (remove entradas antigas/comentadas da chave e escreve o novo valor):
    • Server = IP do Zabbix Server
    • ServerActive = IP do Zabbix Server + porta 10051
    • Hostname = hostname (FQDN) da máquina, detectado automaticamente
    • ListenPort = 10050
    • ListenIP = 0.0.0.0
    • Timeout = 10
  9. Valida a configuração (zabbix_agent2 -T) antes de iniciar o serviço.
  10. Habilita e reinicia o serviço zabbix-agent2, e valida a instalação: status do serviço, porta 10050 escutando e versão instalada.

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.
  • Se o hostname da máquina não corresponder a um host já cadastrado no Zabbix Server, o agent ficará ativo mas não enviará dados até que o host seja criado no servidor com o mesmo Hostname configurado.
  • 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).