Repolode
foru17

foru17/neko-master

Самостоятельно размещаемая панель для визуализации и аудита сетевого трафика через шлюзы Clash/Mihomo (OpenClash) и Surge.

Звёзды
4,215
Форки
270
Открытые issues
14
Последний коммит
12 дней назад

Что это?

Neko Master — веб-панель для мониторинга трафика, проходящего через шлюз под управлением Clash/Mihomo (включая OpenClash) или Surge. Она показывает трафик в реальном времени, динамику за 30 минут, 1 час и 24 часа, а также данные по доменам и IP-адресам: связанные IP, число соединений, ASN и геолокацию. Кроме того, приложение разбивает трафик и соединения по прокси-узлам и цепочкам правил.

Приложение работает как сборщик на Node.js с фронтендом на Next.js. По умолчанию статистика хранится в SQLite; для больших объёмов данных и запросов за длительный период можно дополнительно записывать её в ClickHouse. Обновления в реальном времени передаются по WebSocket, а если порт WebSocket недоступен — через HTTP-опрос. Можно одновременно отслеживать несколько шлюзов. Если шлюзы находятся на удалённых машинах, рядом с ними запускается Go-агент, который отправляет данные на центральную панель: сама панель не подключается к шлюзам напрямую.

Развернуть приложение можно с помощью Docker Compose, команды Docker run, скрипта установки или из исходников через pnpm. Доступ контролируется с помощью токенов. Для определения геолокации IP можно использовать онлайн API или локальные файлы GeoLite2 MMDB.

Ключевые возможности

  • 01Мониторинг трафика в реальном времени через WebSocket с переходом на HTTP-опрос, если WebSocket недоступен
  • 02Динамика трафика за периоды в 30 минут, 1 час и 24 часа
  • 03Анализ по доменам и IP-адресам с данными ASN и геолокацией
  • 04Статистика трафика и соединений по прокси-узлам
  • 05Поддержка нескольких шлюзов Clash/Mihomo и Surge
  • 06Дополнительное хранилище ClickHouse наряду с SQLite, используемой по умолчанию

Сценарии использования

  • Проверять, к каким доменам и IP-адресам обращается домашний шлюз OpenClash или Mihomo
  • Аудировать трафик через Surge на нескольких устройствах
  • Собирать данные с удалённых шлюзов OpenWrt или Linux с помощью агента
  • Просматривать историю трафика за несколько месяцев в ClickHouse, если SQLite начинает работать медленно

Быстрый старт

  1. 1

    Создайте cookie secret для сохранения сессии

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

    Запустите контейнер с помощью Docker (минимальная конфигурация, только порт 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

    Откройте http://localhost:3000 в браузере, чтобы настроить gateway

Что важно знать

  • Для обновлений WebSocket в реальном времени порт 3002 должен быть доступен через reverse proxy; в противном случае будет использоваться опрос.
  • Данные Surge обновляются посредством HTTP-опроса с задержкой около 2 секунд.
  • Это панель мониторинга для вашего собственного gateway. Для её полезного использования должен быть запущен gateway Clash/Mihomo или Surge.

В подборках

Темы

Частые вопросы

Что такое neko-master?
Самостоятельно размещаемая панель для визуализации и аудита сетевого трафика через шлюзы Clash/Mihomo (OpenClash) и Surge. Neko Master — веб-панель для мониторинга трафика, проходящего через шлюз под управлением Clash/Mihomo (включая OpenClash) или Surge. Она показывает трафик в реальном времени, динамику за 30 минут, 1 час и 24 часа, а также данные по доменам и IP-адресам: связанные IP, число соединений, ASN и геолокацию. Кроме того, приложение разбивает трафик и соединения по прокси-узлам и цепочкам правил.
neko-master можно использовать бесплатно? Какая у него лицензия?
neko-master распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
neko-master всё ещё поддерживается?
Активно поддерживается. Последний коммит в neko-master — 10 окт. 2026 г..
Для чего можно использовать neko-master?
Проверять, к каким доменам и IP-адресам обращается домашний шлюз OpenClash или Mihomo Аудировать трафик через Surge на нескольких устройствах Собирать данные с удалённых шлюзов OpenWrt или Linux с помощью агента Просматривать историю трафика за несколько месяцев в ClickHouse, если SQLite начинает работать медленно
Как установить neko-master?
Создайте cookie secret для сохранения сессии: export COOKIE_SECRET="$(openssl rand -hex 32)" Запустите контейнер с помощью Docker (минимальная конфигурация, только порт 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 Откройте http://localhost:3000 в браузере, чтобы настроить gateway
Где скачать neko-master?
Исходный код и инструкции по установке — на GitHub: https://github.com/foru17/neko-master

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты