Repolode
投稿する
foru17

foru17/neko-master

Clash/Mihomo（OpenClash）やSurgeのゲートウェイを通過するネットワークトラフィックを可視化・監査するセルフホスト型ダッシュボード。

GitHub で見る
スター
4,215
フォーク
270
未解決の Issue
14
最終コミット
12 日前

これは何？

Neko Masterは、Clash/Mihomo（OpenClashを含む）またはSurgeを稼働させているゲートウェイを通過するトラフィックを監視するWebダッシュボードです。リアルタイムのトラフィック、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ファイルから取得できます。

主な機能

  • 01WebSocketによるリアルタイムのトラフィック監視と、接続できない場合のHTTPポーリングへの切り替え
  • 0230分・1時間・24時間単位のトラフィック推移
  • 03ASNと位置情報を含むドメイン・IPごとの分析
  • 04プロキシノードごとのトラフィックと接続数の統計
  • 05複数のClash/MihomoおよびSurgeゲートウェイバックエンドに対応
  • 06デフォルトのSQLiteに加えてClickHouseも任意で利用可能

ユースケース

  • 自宅のOpenClashまたはMihomoゲートウェイから通信しているドメインやIPを確認する
  • 複数のデバイスでSurgeを通過するトラフィックを監査する
  • エージェントを介してリモートのOpenWrtまたはLinuxゲートウェイからデータを収集する
  • SQLiteが遅くなった場合にClickHouseで数か月分のトラフィック履歴を確認する

クイックスタート

  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 に到達できる必要があります。そうでない場合はポーリングにフォールバックします。
  • Surge のデータは HTTP ポーリングで更新され、約 2 秒の遅延が発生します。
  • これは自分の gateway 用の監視ダッシュボードです。利用するには Clash/Mihomo または Surge gateway が稼働している必要があります。

収録されている特集

図表・ダイアグラム・アニメーション可視化ツールダッシュボードとビジネスインテリジェンスツールデータサイエンスの教材とツール

トピック

#traffic-monitor#network-monitoring#dashboard#clash#mihomo#surge#openclash#data-visualization#visualization

よくある質問

neko-master とは？
Clash/Mihomo（OpenClash）やSurgeのゲートウェイを通過するネットワークトラフィックを可視化・監査するセルフホスト型ダッシュボード。 Neko Masterは、Clash/Mihomo（OpenClashを含む）またはSurgeを稼働させているゲートウェイを通過するトラフィックを監視するWebダッシュボードです。リアルタイムのトラフィック、30分・1時間・24時間ごとの推移を表示できます。また、ドメインやIPごとに、関連するIP、接続数、ASN、位置情報を確認できます。プロキシノードやルールチェーンごとのトラフィックと接続数も集計します。
neko-master は無料で使えますか？ライセンスは？
neko-master は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
neko-master は今もメンテナンスされていますか？
活発にメンテナンス中。neko-master の最終コミットは 2026年10月10日 です。
neko-master は何に使えますか？
自宅のOpenClashまたはMihomoゲートウェイから通信しているドメインやIPを確認する 複数のデバイスでSurgeを通過するトラフィックを監査する エージェントを介してリモートのOpenWrtまたはLinuxゲートウェイからデータを収集する SQLiteが遅くなった場合にClickHouseで数か月分のトラフィック履歴を確認する
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 をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト