O Agente do NetConfig é um componente leve utilizado para facilitar a comunicação entre o sistema NetConfig e a infraestrutura interna do cliente, permitindo operações como SSH e SNMP de forma segura, mesmo atrás de NAT ou firewalls, sem necessidade de IP público.
root ou sudo.8080/tcp (HTTP do agente via Traefik)8443/tcp (HTTPS do agente via Traefik)2222/tcp (porta usada pelo túnel reverso)80/tcp (opcional, utilizada somente pelo desafio ACME ao usar Let's Encrypt)apt-get update && apt-get install curl -y
curl -fsSL https://raw.githubusercontent.com/NetConfigAutomacao/snippets/refs/heads/main/agent/install.sh | sh
API Key:
ZcT3ugl2udZpMWjBlfP9CcYehRVaNTG7WjXlW_D_8_vXX8E0_siYQkrockHruDGT
SSH Key:
-----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEAlDA1p/kZMV1HCoYfXfY7ZfhL+uD4D2VoFZ1x1PDn3JvU50TF
.
.
.
lAIw5Rk1UunEE+lrLrsYODCQWUV/gk1I5mxNr+x7oeBPQUtiV6su
-----END RSA PRIVATE KEY-----
Após salvar clique no botão "Verificar" na tabela para garantir que a comunicação foi bem sucedida
Após isso, acesse o menu Empresa -> Configurações
No campo Agente padrão, selecione o novo agente criado e clique em Salvar.
Pronto! o Agente já está pronto para ser utilizado pelos equipamentos
Acessar pasta onde ficam os arquivos:
cd /opt/netconfig-agent
Checar status dos containers (O status deve estar como healthy, isso pode levar alguns segundos):
sudo docker compose ps -a
Reiniciar containers:
sudo docker compose restart
Logs do agent:
sudo docker logs -f netconfig_agent
Forçar atualização do agent:
sudo docker compose pull
sudo docker compose up -d
⚠️ Realize a verificação após a atualização do agent, pois em alguns casos foi necessário reenviar a chave privada do túnel SSH!
API Key
sudo docker exec netconfig_agent cat /data/api_key
Chave privada do túnel SSH
sudo docker exec netconfig_agent cat /data/tunnel_ssh_key