---

MiaoMiaoWu（v0.4.3）

项目地址：
https://github.com/Jimleerx/miaomiaowu/releases/tag/v0.4.3

定位：轻量级、易部署的 Clash 订阅管理系统
能力：支持 Nezha / DStatus / Komari 探针获取流量信息，支持导入外部机场节点等。

---

功能特性

核心功能

• 📊 流量监控：支持探针服务器与外部订阅流量聚合统计

• 📈 历史流量：30 天流量使用趋势图表

• 🔗 订阅链接展示：展示通过订阅管理上传 / 导入 / 生成的订阅

• 🔗 订阅管理：上传猫咪配置文件或从其他订阅 URL 导入生成订阅

• 🎯 生成订阅：从导入的节点生成订阅，提供可视化代理组规则编辑器

• 📦 节点管理：导入个人节点或机场节点；支持添加、编辑、删除代理节点

• 🔧 规则生成：自定义规则或使用模板快速生成订阅

• 🎨 代理分组：拖拽式代理节点分组配置，支持链式代理

• 👥 用户管理：管理员 / 普通用户角色区分；订阅权限管理

• 🌓 主题切换：亮色 / 暗色模式

• 📱 响应式设计：不完全适配移动端与桌面端

---

探针支持

• Nezha 面板

• DStatus 监控

• Komari 面板

---

体验 Demo

• 账号/密码：test / test123

---

使用帮助

安装部署

---

方式 1：Docker 部署（推荐）

1）基础部署（docker run）

docker run -d \
  --user root \
  --name miaomiaowu \
  -p 8080:8080 \
  -v $(pwd)/mmw-data:/app/data \
  -v $(pwd)/subscribes:/app/subscribes \
  -v $(pwd)/rule_templates:/app/rule_templates \
  ghcr.io/jimleerx/miaomiaowu:latest

参数说明

• -p 8080:8080：将容器端口映射到宿主机（按需调整）

• -v ./mmw-data:/app/data：持久化数据库文件（防止容器重建数据丢失）

• -v ./subscribes:/app/subscribes：订阅文件存放目录

• -v ./rule_templates:/app/rule_templates：规则模板存放目录

• -e JWT_SECRET=your-secret（可选）：配置 token 密钥，建议改为随机字符串

• 其他环境变量（如 LOG_LEVEL）同“环境变量”章节，可继续通过 -e 添加

更新镜像与重启

docker pull ghcr.io/jimleerx/miaomiaowu:latest
docker stop miaomiaowu && docker rm miaomiaowu

然后按照上方 docker run 命令重新启动服务。

---

2）Docker Compose 部署

创建 docker-compose.yml

version: '3.8'

services:
  miaomiaowu:
    image: ghcr.io/jimleerx/miaomiaowu:latest
    container_name: miaomiaowu
    restart: unless-stopped
    user: root

    environment:
      - PORT=8080
      - DATABASE_PATH=/app/data/traffic.db
      - LOG_LEVEL=info
      # - JWT_SECRET=your-secret  # 可选：建议改为随机字符串

    ports:
      - "8080:8080"

    volumes:
      - ./data:/app/data
      - ./subscribes:/app/subscribes
      - ./rule_templates:/app/rule_templates

    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/"]
      interval: 30s
      timeout: 3s
      start_period: 5s
      retries: 3

启动 / 查看日志 / 停止

docker-compose up -d

docker-compose logs -f

docker-compose down

---

数据持久化说明（Docker）

容器通过以下目录进行持久化：

• /app/data：SQLite 数据库文件

• /app/subscribes：订阅配置文件

• /app/rule_templates：规则文件模板

重要提示：请定期备份上述目录对应的宿主机挂载目录。

---

方式 2：一键安装（Linux）

⚠ 注意：0.1.1 版本修改了服务名称，无法通过脚本更新，只能重新安装。

旧服务卸载及备份转移（如从旧版本升级）

sudo systemctl stop traffic-info
sudo systemctl disable traffic-info
sudo rm -rf /etc/systemd/system/traffic-info.service
sudo rm -f /usr/local/bin/traffic-info
sudo cp -rf /var/lib/traffic-info/* /etc/mmw/

---

1）自动安装为 systemd 服务（Debian/Ubuntu）

安装

curl -sL https://raw.githubusercontent.com/Jimleerx/miaomiaowu/main/install.sh | bash

安装完成后访问：

• http://服务器IP:8080

更新到最新版本（systemd 服务更新）

curl -sL https://raw.githubusercontent.com/Jimleerx/miaomiaowu/main/install.sh | sudo bash -s update

卸载（保留数据）

curl -sL https://raw.githubusercontent.com/Jimleerx/miaomiaowu/main/install.sh | sudo bash -s uninstall

完全清除数据（手动）

sudo rm -rf /etc/mmw

---

2）简易安装（手动运行）

一键下载安装 + 运行

curl -sL https://raw.githubusercontent.com/Jimleerx/miaomiaowu/main/quick-install.sh | bash

./mmw

卸载（保留数据）

curl -sL https://raw.githubusercontent.com/Jimleerx/miaomiaowu/main/quick-install.sh | sudo bash -s uninstall

完全删除本地数据（手动）

sudo rm -rf ./data ./subscribes ./rule_templates

更新简易安装版本

curl -sL https://raw.githubusercontent.com/Jimleerx/miaomiaowu/main/quick-install.sh | bash -s update

---

Windows

从 Releases 下载 mmw-windows-amd64.exe：
https://github.com/Jimleerx/miaomiaowu/releases

运行方式：

.\mmw-windows-amd64.exe

---

技术特点

• 🚀 单二进制文件部署，无需外部依赖

• 💾 SQLite 数据库，免维护

• 🔒 JWT 认证，安全可靠

• 📱 响应式设计，支持移动端

---

免责声明

• 本程序仅供学习交流使用，请勿用于非法用途

• 使用本程序需遵守当地法律法规

• 作者不对使用者的任何行为承担责任

---