Routers e switches compatíveis com o NetPulse

Compatibilidade

Como cada plataforma se liga

Estas são as famílias suportadas e o que esperar de cada fonte. A cobertura exata depende do modelo e do firmware.

Fontes de dados, cobertura e requisitos por plataforma
Plataforma	Fonte de dados	Dados disponíveis	Requisitos e limites
OpenWrt e GL.iNet	Agente nativo no router	Sistema, WiFi, clientes e portas	Instalação pelo NetPulse em versões suportadas
MikroTik RouterOS 7+	Pusher Go externo	Hosts, pontos de acesso e portas	Utilizador só de leitura e uma máquina para o supervisor
Asuswrt / Asuswrt-Merlin	Sondas e pusher no router	Sistema, WiFi, clientes e portas	Acesso SSH e espaço persistente em /jffs
Outras integrações	Poller da API local da BBox e beacon RTLPlayground	BBox: sistema, WAN, hosts e taxas das portas. RTL: estado das portas, taxas e FDB	BBox: API local e máquina para o supervisor. RTL: avançado, substituir o firmware com cópia de recuperação
UniFi	Poller externo do controlador	Gateways, switches, APs e clientes de um site	Sem cloud ui.com, CPU ou temperatura
Switches geridos	SNMP a partir do NetPulse	Portas, velocidades e vizinhos LLDP-MIB	As MIBs disponíveis dependem do equipamento

netpulse-integrations

Agentes externos

MikroTik, Asuswrt e UniFi consultam routers ou controladores e enviam dados para o NetPulse por HTTPS. O último cartão agrupa fontes adicionais com o seu próprio transporte.

MikroTik RouterOS 7+

Consulta o RouterOS e envia hosts, pontos de acesso e portas.

Utilizador só de leitura e uma máquina para o supervisor
API binária na porta 8728, com REST como alternativa
O WiFi Wave2 anuncia a interface wifi, não capsman

Asuswrt e Asuswrt-Merlin

O pusher corre no router e reutiliza as sondas portáteis do NetPulse. Pode ficar em /jffs.

Acesso SSH e espaço persistente em /jffs
Clientes, rádios, canais e portas Ethernet
A cobertura depende do firmware e das ferramentas instaladas

UniFi

Lê gateways, switches, pontos de acesso e clientes de um site no seu controlador.

Consolas UniFi OS e controladores autónomos alojados por si
Utilizador só de leitura no controlador
Sem contas cloud ui.com, CPU ou temperatura

e mais integrações

Duas fontes adicionais com requisitos diferentes.

BBox: consulta a API local e envia sistema, WAN, hosts ativos e taxas de portas.
RTLPlayground: beacon em firmware para switches RTL8372/8373, com estado de portas, taxas e FDB.

Ver agentes, requisitos e instruções

Firmware avançado

Um beacon dentro do switch

Os switches Realtek geridos pela web não conseguem executar o agente Go. O fork RTLPlayground adiciona um beacon que envia dados diretamente ao listener do NetPulse.

O que o NetPulse recebe

Estado e velocidade da ligação a cada 30 segundos
Taxas de tráfego calculadas a partir dos octetos de cada porta
Tabela FDB a cada cinco minutos para localizar clientes pelo MAC

O que é necessário

Um modelo presente na lista de dispositivos RTLPlayground
Compilar o fork para a sua máquina e definir o identificador do switch
Substituir o firmware e ter backup da flash e um método de recuperação

O beacon usa UDP com um token em texto simples dentro de uma LAN fidedigna. Não usa o transporte HTTPS assinado dos agentes externos.

Abrir o guia do NetPulse Ver o firmware do fork

Apenas agentes externos

Porque têm um repositório separado

RouterOS, Asus, BBox e UniFi partilham um repositório separado. O NetPulse mantém o contrato de ingestão e cada integração segue o ciclo do fabricante.

Ciclos de vida separados

Uma integração publica correções com a sua própria tag, sem esperar por uma release do servidor.

Credenciais isoladas

A palavra-passe do router ou controlador fica na configuração da integração. O NetPulse recebe o token do agente.

Só de leitura

Estas integrações consultam e enviam dados. Não alteram a configuração dos equipamentos a partir do NetPulse.

Só o que ativa

O núcleo não executa código de integrações que não usa. Mantém-se pequeno e estável, e adiciona apenas os agentes de que precisa.

Transporte dos agentes externos

Um contrato assinado

O agente assina cada snapshot com HMAC-SHA256 no cabeçalho X-Agent-Signature e envia-o à ingestão do NetPulse com o seu token. O equipamento aparece como externo.

Um NetPulse acessível por HTTPS a partir de onde o agente corre
Um token de router criado na aplicação
Um utilizador só de leitura no router ou controlador

Compilar o supervisor

git clone https://github.com/gnacho/netpulse-integrations
cd netpulse-integrations
go build -o netpulse-integrations ./cmd/integrations-supervisor

O repositório publica binários estáticos para amd64 e arm64 com SHA-256. Inclui um exemplo de unidade systemd.

Limites a conhecer

Os agentes externos não configuram routers nem controladores.
O agente nativo continua a ser a fonte recomendada para OpenWrt e GL.iNet.
O beacon não reporta CPU, RAM ou temperatura e não envia a tabela LLDP.
Um switch alimentado por beacon não pode adicionar SNMP como segunda fonte no NetPulse.
O beacon do fork não faz parte do RTLPlayground original.

Comece pelo seu equipamento

Instale o NetPulse e siga o guia da sua plataforma.

Instalar o NetPulse Verificar o meu hardware

Os seus equipamentos de rede numa só vista