foru17/neko-master

O que é?

Recursos principais

• 01Monitoramento de tráfego em tempo real via WebSocket, com fallback para polling HTTP
• 02Tendências de tráfego em períodos de 30 minutos, 1 hora e 24 horas
• 03Análise por domínio e por IP, com ASN e geolocalização
• 04Estatísticas de tráfego e conexões por nó de proxy
• 05Suporte a vários backends de gateway Clash/Mihomo e Surge
• 06Armazenamento opcional no ClickHouse, além do SQLite padrão

Casos de uso

• Verificar para quais domínios e IPs um gateway doméstico OpenClash ou Mihomo está enviando tráfego
• Auditar o tráfego do Surge em vários dispositivos
• Coletar dados de gateways OpenWrt ou Linux remotos usando o agente
• Consultar meses de histórico de tráfego no ClickHouse quando o SQLite ficar lento

Início rápido

1. 1

   Gere um cookie secret para manter a sessão

   export COOKIE_SECRET="$(openssl rand -hex 32)"
2. 2

   Inicie o contêiner com Docker (configuração mínima, apenas a porta 3000)

   docker run -d --name neko-master -p 3000:3000 -v $(pwd)/data:/app/data -e COOKIE_SECRET="$COOKIE_SECRET" --restart unless-stopped foru17/neko-master:latest
3. 3

   Abra http://localhost:3000 no navegador para configurar seu gateway

Antes de usar

• !As atualizações em tempo real via WebSocket exigem que a porta 3002 esteja acessível pelo proxy reverso; caso contrário, o sistema recorrerá à sondagem.
• !Os dados do Surge são atualizados por sondagem HTTP, com um atraso de aproximadamente 2 segundos.
• !Este é um painel de monitoramento do seu próprio gateway e precisa de um gateway Clash/Mihomo ou Surge em execução para ser útil.

Em coleções

Tópicos

Perguntas frequentes

O que é neko-master?

Dashboard auto-hospedado que visualiza e audita o tráfego de rede de gateways Clash/Mihomo (OpenClash) e Surge. Neko Master é um dashboard web para acompanhar o tráfego que passa por um gateway com Clash/Mihomo (incluindo OpenClash) ou Surge. Ele mostra o tráfego em tempo real, tendências dos últimos 30 minutos, 1 hora e 24 horas, além de visualizações por domínio e por IP, com os IPs associados, contagem de conexões, ASN e geolocalização. Também detalha o tráfego e as conexões por nó de proxy e cadeia de regras.

neko-master é gratuito? Qual é a licença?

neko-master é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

neko-master ainda é mantido?

Manutenção ativa. O último commit de neko-master foi em 10 de out. de 2026.

Para que posso usar neko-master?

Verificar para quais domínios e IPs um gateway doméstico OpenClash ou Mihomo está enviando tráfego Auditar o tráfego do Surge em vários dispositivos Coletar dados de gateways OpenWrt ou Linux remotos usando o agente Consultar meses de histórico de tráfego no ClickHouse quando o SQLite ficar lento

Como instalar neko-master?

Gere um cookie secret para manter a sessão: export COOKIE_SECRET="$(openssl rand -hex 32)" Inicie o contêiner com Docker (configuração mínima, apenas a porta 3000): docker run -d --name neko-master -p 3000:3000 -v $(pwd)/data:/app/data -e COOKIE_SECRET="$COOKIE_SECRET" --restart unless-stopped foru17/neko-master:latest Abra http://localhost:3000 no navegador para configurar seu gateway

Onde consigo neko-master?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/foru17/neko-master