Neko Master Logo
Neko Master

Visualizza chiaramente il tuo traffico di rete.
Monitoraggio in tempo reale · Analisi del traffico · Supporto multi-gateway

English | 中文

[!IMPORTANT] Dichiarazione di non responsabilità

Questo progetto è uno strumento di analisi e visualizzazione del traffico per ambienti gateway locali.

Non fornisce alcun servizio di accesso alla rete, abbonamento proxy o connettività cross-network. Tutti i dati vengono raccolti dall'ambiente di rete dell'utente stesso.

Questo progetto è open source con licenza MIT. Non ci assumiamo alcuna responsabilità per eventuali conseguenze derivanti dall'uso di questo software. Si prega di utilizzarlo in conformità con le leggi e i regolamenti applicabili.

Informazioni sul nome

Neko (ねこ) significa gatto in giapponese. Pronunciato /ˈneɪkoʊ/ (NEH-ko).

Come un gatto, Neko Master osserva il traffico di rete in modo silenzioso e preciso. È una dashboard di analisi leggera progettata per ambienti gateway moderni.

✨ Funzionalità

Funzionalità	Descrizione
📊 Monitoraggio in tempo reale	Raccolta in tempo reale via WebSocket con latenza in millisecondi
📈 Analisi delle tendenze	Tendenze del traffico multidimensionali: 30min / 1h / 24h
🌐 Analisi dei domini	Visualizza traffico, IP associati e numero di connessioni per dominio
🗺️ Analisi degli IP	Visualizzazione ASN, geolocalizzazione e domini associati
🚀 Statistiche proxy	Distribuzione del traffico e numero di connessioni per nodo proxy
📱 Supporto PWA	Installabile come app desktop per un'esperienza nativa
🌙 Modalità scura	Supporto tema Chiaro / Scuro / Sistema
🌍 Supporto i18n	Passaggio fluido tra inglese e cinese
🔄 Multi-Backend	Monitora più istanze backend OpenClash contemporaneamente

🚀 Avvio rapido

Opzione 1: Docker Compose (consigliata)

Il file docker-compose.yml incluso nel repository mappa 3000/3001/3002 per impostazione predefinita. Gli scenari A/B riportati di seguito sono template minimi per distribuzioni comuni.

Scenario A: distribuzione minima (esporre solo la 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}

> Consigliato in `.env` (stessa directory di `docker-compose.yml`):
> `COOKIE_SECRET=<stringa casuale di almeno 32 byte>` (generare con `openssl rand -hex 32`)

> Questa modalità è completamente compatibile con gli aggiornamenti e funziona immediatamente.
> Se WS non è instradato, l'app passa automaticamente al polling HTTP.

#### Scenario B: WebSocket in tempo reale (consigliato con reverse proxy)```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}

Poi esegui:```bash docker compose up -d

Apri <http://localhost:3000> per iniziare.

Se utilizzi il file Compose integrato nel repository (predefinito `3000/3001/3002`), esegui lo stesso comando.

neko-master