妙妙屋（miaomiaowu）— 流量監視とClash購読管理

Web
妙妙屋（miaomiaowu）— 流量監視とClash購読管理

妙妙屋（miaomiaowu）— 流量監視とClash購読管理

妙妙屋（miaomiaowu）は、Nezha、DStatus、Komari といった探针（プローブ）からサーバーのトラフィック情報を収集・集計し、Clash 用の購読（サブスクリプション）リンクに流量情報を付加して生成する軽量な流量監視＆購読管理システムです。リアルタイム監視、30日分の履歴表示、購読リンク管理、可視化されたルール編集、ユーザー権限などを備え、デプロイしやすいビルドスクリプトも提供します。

https://github.com/Jimleerx/miaomiaowu

概要

妙妙屋（miaomiaowu）は、サーバーの帯域・トラフィック利用を監視し、Clash（プロキシクライアント向け）用の購読リンクを管理・生成するための軽量システムです。Nezha、DStatus、Komari といった既存の監視パネル／探针から流量データを取得して集計し、リアルタイムの流量表示や過去30日のトレンド可視化、購読リンクへの流量情報付加、可視的なルール編集やユーザー権限管理をサポートします。導入は容易でデモも公開されており、小規模～中規模の環境での流量監視とClash購読の運用に向いています。

GitHub

リポジトリの統計情報

  • スター数: 17
  • フォーク数: 2
  • ウォッチャー数: 17
  • コミット数: 14
  • ファイル数: 16
  • メインの言語: TypeScript

主な特徴

  • 多探针統合：Nezha、DStatus、Komari のデータを取り込み、複数サーバーのトラフィックを集約。
  • Clash購読管理：流量情報を付与したClashサブスクリプションを生成・管理可能。
  • 可視化ダッシュボード：リアルタイムの流量表示と30日分の履歴グラフで使用状況を把握。
  • 権限とUI：管理者／一般ユーザーのロール分離、ルールを視覚的に編集できるインターフェースとテーマ切替（明暗）。

技術的なポイント

miaomiaowu は TypeScript をコアに据えた設計になっており、フロントエンドとバックエンドの組み合わせで動作することが想定されます。リポジトリにある build.sh / build.bat からは、クロスプラットフォームでのビルド・デプロイを意識した構成であることがうかがえます。探针統合部分はアダプタ設計が鍵で、Nezha／DStatus／Komari といった各プローブの API 仕様を抽象化して定期的にポーリングまたは Webhook でデータを取得、サーバーごとのトラフィックを時間単位で集計します。集計データはキャッシュまたはストレージ（データベース）に保持し、ダッシュボードはこれを参照してリアルタイム表示と30日間のトレンドグラフを描画します。Clash 購読生成は、取得した通信量情報を購読レスポンスに注釈／ヘッダ／メタ情報として埋め込む処理が含まれ、購読リンクを通じてクライアント側で使用量の把握や制御がしやすくなります。さらに、可視的なルールエディタは JSON/YAML 形式のルールを編集・保存し、購読生成ロジックと連動して動的に反映されることが期待されます。セキュリティ面では、ユーザーロール管理や認証周りの仕組み（トークンやセッション管理）を設け、管理者と一般ユーザーで操作範囲を分離します。軽量かつ容易にデプロイできる設計なので、小規模サーバ群の運用・監視を手早く導入したいケースに適しています。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .github: dir — CI/ワークフローやIssueテンプレートが入る可能性のあるディレクトリ（GitHub関連設定）。
  • .gitignore: file — ビルド成果物や環境依存ファイルを除外する設定。
  • README.md: file — プロジェクトの概要、機能、導入方法やデモ情報を記載（抜粋は下段参照）。
  • build.bat: file — Windows 環境向けのビルド／起動スクリプト。手動または自動化されたデプロイに利用。
  • build.sh: file — Unix 系（Linux/macOS）向けのビルド／起動スクリプト。

…他 11 ファイル（リポジトリ全体で16ファイル）。TypeScript プロジェクトであるため、実装は src ディレクトリや package.json、tsconfig.json、フロントエンド資産（静的ファイルやテンプレート）といった典型的なファイル群が含まれていることが推察されます。README に記載された「Demo（https://demo.miaomiaowu.com）」へのリンクやアカウント情報から、Web UI が用意されていることが確認でき、ビルドスクリプト経由でフロントエンド＋バックエンドを立ち上げられる構成が想定されます。

まとめ

Clash購読とサーバートラフィック監視を統合した、軽量で導入しやすい管理ツールです。

リポジトリ情報：

READMEの抜粋：

妙妙屋 - 流量监控管理系统

一个轻量级、易部署的服务器流量监控与订阅管理系统，支持 Nezha、DStatus 和 Komari 探针。

功能特性

核心功能

  • 📊 实时流量监控 - 支持多服务器流量聚合统计
  • 📈 历史数据展示 - 30 天流量使用趋势图表
  • 🔗 订阅链接管理 - 一键生成 Clash 订阅链接
  • 🎯 智能规则配置 - 可视化订阅规则编辑器
  • 👥 用户权限管理 - 管理员/普通用户角色区分
  • 🌓 主题切换 - 支持亮色/暗色模式

探针支持

  • Nezha 面板
  • DStatus 监控
  • Komari 面板

体验demo

Demo: https://demo.miaomiaowu.com（アカウント例：test / tes…）