install-zabbixagent/README.md
Leonardo Biasoli a5e46cfe24 feat: script de instalação apontando para o IP público do Zabbix
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-03 14:57:28 -03:00

85 lines
4.5 KiB
Markdown

# 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:
```bash
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:
```bash
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`).
## 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:
- `ServerActive` aponta 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`.
```bash
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.