Clash Master：OpenClash 流量管理的现代仪表盘

OpenClash 是一款流行的代理/路由器解决方案，用于管理路由器上的 VPN 与广告拦截流量。其后端 API 提供原始数据，但缺乏直观的可视化界面。

推出 Clash Master——一款现代化、开源仪表盘，由 Next.js、React 19、TypeScript、Tailwind CSS 与 Node .js 数据收集器构建。它为你提供：

• 实时流量图（带宽、延迟、地区）
• 交互式规则统计与分页
• 设备、IP 与域名洞察
• 支持 WebSocket 的实时更新
• Docker 友好的部署
• 多架构镜像（amd64 与 arm64）
• 使用 SQLite 的轻量级数据持久化

为什么选择 Clash Master？

快速开始（推荐使用 Docker Compose）

1. 创建一个 docker-compose.yml 文件，内容如下：

   services:
     clash-master:
       image: foru17/clash-master:latest
       container_name: clash-master
       restart: unless-stopped
       ports:
         - "3000:3000"  # Web UI
         - "3001:3001"  # API（可选）
         - "3002:3002"  # WebSocket（可选）
       volumes:
         - ./data:/app/data
       environment:
         - NODE_ENV=production
   

2. 运行：

   docker compose up -d
   

3. 在浏览器中打开 http://localhost:3000。
4. 第一次访问会提示你添加 OpenClash 后端（IP、端口，可选 token）。保存后，收集器将开始采集数据。

一键脚本

若你倾向于单行命令：

curl -fsSL https://raw.githubusercontent.com/foru17/clash-master/main/setup.sh | bash

从源代码运行（开发）

git clone https://github.com/foru17/clash-master.git
cd clash-master
pnpm install
pnpm dev

端口冲突解决

若遇到 port already in use 错误： 1. 创建 .env 文件：

WEB_EXTERNAL_PORT=8080
API_EXTERNAL_PORT=8081
WS_EXTERNAL_PORT=8082

docker compose down
docker compose up -d

替代方案：编辑 docker‑compose.yml

ports:
  - "8080:3000"
  - "8081:3001"
  - "8082:3002"

数据持久化与备份

收集器将统计信息存储在 ./data/stats.db。备份方法：

cp -r ./data ./data-backup-$(date +%Y%m%d)

常见问题（FAQ）简述

• 端口冲突？ 调整 .env 或 docker‑compose.yml。
• API 访问？ 暴露 3001 端口或设置 API_URL 环境变量。
• WebSocket？ 暴露 3002 端口或设置 WS_URL 环境变量。
• 连接 OpenClash？ 确保路由器的 External Control 已开启，并且使用的 token（如有）一致。

结语

Clash Master 将原始 OpenClash 指标转化为交互式、开发者友好的仪表盘。无论你是网络管理员还是业余爱好者，现代工具链、Docker 友好部署与强大的数据收集组合，使其成为在任何平台上可视化 VPN 流量的首选方案。

小贴士： 关注 GitHub 项目——免费且有助于持续维护开发。