Neko Master Logo
Neko Master

Veja seu tráfego de rede com clareza.
Monitoramento em tempo real · Auditoria de tráfego · Suporte a múltiplos gateways

English | 中文

[!IMPORTANT] Aviso Legal

Este projeto é uma ferramenta de análise e visualização de tráfego para ambientes de gateway local.

Ele não fornece nenhum serviço de acesso à rede, assinatura de proxy ou conectividade entre redes. Todos os dados são coletados do próprio ambiente de rede do usuário.

Este projeto é open-source sob a Licença MIT. Não assumimos qualquer responsabilidade por consequências decorrentes do uso deste software. Por favor, use-o em conformidade com as leis e regulamentos aplicáveis.

Sobre o Nome

Neko (ねこ) significa gato em japonês. Pronunciado /ˈneɪkoʊ/ (NEH-ko).

Como um gato, o Neko Master observa o tráfego de rede de forma silenciosa e precisa. É um painel de análise leve projetado para ambientes de gateway modernos.

✨ Recursos

Recurso	Descrição
📊 Monitoramento em Tempo Real	Coleta em tempo real via WebSocket com latência em milissegundos
📈 Análise de Tendências	Tendências de tráfego multidimensionais: 30min / 1h / 24h
🌐 Análise de Domínios	Visualize tráfego, IPs associados e contagem de conexões por domínio
🗺️ Análise de IP	Exibição de ASN, geolocalização e domínios associados
🚀 Estatísticas de Proxy	Distribuição de tráfego e contagem de conexões por nó de proxy
📱 Suporte a PWA	Instale como aplicativo de desktop para uma experiência nativa
🌙 Modo Escuro	Suporte a tema Claro / Escuro / Sistema
🌍 Suporte a i18n	Alternância perfeita entre Inglês / Chinês
🔄 Multi-Backend	Monitore múltiplas instâncias de backend OpenClash simultaneamente

🚀 Início Rápido

Opção 1: Docker Compose (Recomendado)

O docker-compose.yml integrado ao repositório mapeia 3000/3001/3002 por padrão. Os cenários A/B abaixo são templates mínimos para implantações comuns.

Cenário A: Implantação mínima (expor apenas a porta 3000)```yaml

services: neko-master: image: foru17/neko-master:latest container_name: neko-master restart: unless-stopped ports: - "3000:3000" # Web UI volumes: - ./data:/app/data # Local MMDB (optional, files should be downloaded into ./geoip) - ./geoip:/app/data/geoip:ro environment: - NODE_ENV=production - DB_PATH=/app/data/stats.db - COOKIE_SECRET=${COOKIE_SECRET}

> Recomendado em `.env` (mesmo diretório que `docker-compose.yml`):
> `COOKIE_SECRET=<string aleatória de pelo menos 32 bytes>` (gerar com `openssl rand -hex 32`)

> Este modo é totalmente compatível com atualizações e funciona imediatamente.
> Se o WS não estiver roteado, a aplicação recorre automaticamente ao polling HTTP.

#### Cenário B: WebSocket em tempo real (recomendado com proxy reverso)```yaml
services:
  neko-master:
    image: foru17/neko-master:latest
    container_name: neko-master
    restart: unless-stopped
    ports:
      - "3000:3000" # Web UI
      - "3002:3002" # WebSocket (for Nginx / Tunnel forwarding)
    volumes:
      - ./data:/app/data
      # Local MMDB (optional, files should be downloaded into ./geoip)
      - ./geoip:/app/data/geoip:ro
    environment:
      - NODE_ENV=production
      - DB_PATH=/app/data/stats.db
      - COOKIE_SECRET=${COOKIE_SECRET}

Em seguida, execute:```bash docker compose up -d

Abra <http://localhost:3000> para começar.

Se você usar o arquivo Compose integrado do repositório (padrão `3000/3001/3002`), execute o mesmo comando.

neko-master