No description
|
|
||
|---|---|---|
| install-zabbix-publico.sh | ||
| install-zabbix.sh | ||
| LICENSE | ||
| README.md | ||
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
- Valida sistema operacional (Ubuntu/Debian e versão suportada).
- Instala dependências (
wget,curl,ca-certificates,gnupg,iproute2). - Detecta agentes Zabbix já instalados (
zabbix-agentclássico e/ouzabbix-agent2). - Para e remove agentes antigos: para e desabilita os serviços, encerra processos residuais (
SIGTERMe, 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.confe os diretórios.dcorrespondentes). - Verifica se a porta TCP 10050 está livre antes de prosseguir; se algo ainda estiver escutando nela, o script para com erro.
- Adiciona o repositório oficial do Zabbix e instala o pacote
zabbix-agent2. - Configura
/etc/zabbix/zabbix_agent2.confdo 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 10051Hostname= hostname curto da máquina, detectado automaticamenteListenPort= 10050ListenIP= 0.0.0.0Timeout= 10- O script também verifica se alguma dessas chaves ficou duplicada no arquivo final e falha se encontrar.
- Valida a configuração (
zabbix_agent2 -T) antes de iniciar o serviço. - 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. - Ao final, imprime um resumo com os dados para cadastro do host no Zabbix (nome, interface, IP, porta, template recomendado) e os comandos
zabbix_getpara testaragent.ping/agent.hostnamea 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
Hostnameconfigurado é o hostname curto da máquina (ex.:dns, nãodns.dominio.com) — é esse o nome que deve ser usado ao cadastrar o host no Zabbix Server. - O parâmetro
Serveraceita as redes/IPs autorizados a fazer passive checks (10.15.0.0/24,192.168.0.0/24); ajuste a variávelZABBIX_ALLOWEDno 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).
Variante: Zabbix Server pelo IP público
Para servidores fora da rede privada (que precisam falar com o Zabbix pelo IP público), use install-zabbix-publico.sh. Ele faz o mesmo que install-zabbix.sh, mas:
ServerActiveaponta para o IP público do Zabbix (porta 10051);Server(passive checks) é restrito a<IP_PUBLICO>/32, sem as redes privadas;- o IP público é obrigatório, via argumento ou variável
ZABBIX_SERVER_PUBLIC.
wget -O install-zabbix-publico.sh https://git.ledcloud.com.br/LED_Cloud/install-zabbixagent/raw/branch/main/install-zabbix-publico.sh
chmod +x install-zabbix-publico.sh
sudo ./install-zabbix-publico.sh <IP_PUBLICO_DO_ZABBIX>
Lembre-se de liberar no firewall do Zabbix as portas 10051 (active) e, se usar passive checks, 10050 no servidor monitorado a partir do IP público do Zabbix.