MiSub

一个功能强大、界面精美的订阅管理与转换工具

功能特性 • 快速开始 • 部署指南 • 使用说明 • 更新日志

---

📸 应用截图

登录界面	管理界面

---

✨ 功能特性

🎯 核心功能

• 🗂️ 订阅分组 (Profiles)

  • 自由组合机场订阅和手动节点
  • 为不同场景生成专属订阅链接
  • 支持全选/全不选,操作便捷
  • 自定义分组名称和订阅链接

• 📦 订阅与节点分离管理

  • 机场订阅和手动节点独立管理
  • 批量导入自动分类
  • 支持拖拽排序
  • 一键按地区自动排序

• 🎨 精致的 UI/UX

  • 明亮/暗黑模式自动切换
  • 磨砂玻璃质感现代化设计
  • 完善的交互提示和加载状态
  • 完善的交互提示和加载状态
  • 响应式布局,支持移动端

• 🌍 公开主页 (Explore)

  • 访客模式：无需登录即可预览公开分享的订阅
  • 管理员分享：精选中转/直连机场订阅
  • 一键复制：访客可直接复制订阅链接
  • 客户端推荐：主流全平台客户端下载指引

🆕 最新功能

• 📝 订阅备注

  • 为每个订阅添加备注信息
  • 记录官网、价格、到期时间等
  • 在订阅卡片上清晰显示

• 🌐 自定义 User-Agent

  • 为每个订阅设置独立的 UA
  • 10+ 常用客户端 UA 预设
  • 解决机场 UA 限制问题

• 🔧 Snell 协议完整支持

  • 支持 Snell v1-v5
  • 完整的参数支持 (reuse/tfo)
  • Surge 配置导入支持

• 📊 流量与到期时间显示

  • 订阅卡片显示已用/总流量
  • 到期时间提醒,颜色高亮
  • 自动更新节点数和流量信息

💾 双重存储支持

• Cloudflare KV 存储

  • 极快的查询速度
  • 适合轻度使用
  • 简单易配置

• Cloudflare D1 数据库

  • 无写入频率限制
  • 适合频繁更新
  • 一键数据迁移

🔐 安全与定制

• 密码保护: 管理界面由自定义密码保护
• 高度可定制: 自定义输出文件名、Subconverter 地址等
• 数据备份: 支持导出/导入备份
• TG 推送: 支持 Telegram 通知

🌍 多格式支持

支持主流代理客户端和格式:

客户端	格式支持	自动识别
Clash / Clash Meta	✅	✅
Sing-Box	✅	✅
Surge	✅	✅
Shadowrocket	✅	✅
V2rayN / V2rayNG	✅	✅
Quantumult X	✅	✅
Loon	✅	✅

📡 支持的协议

• Shadowsocks (SS/SS2022) - 包含自动修复功能
• ShadowsocksR (SSR)
• VMess
• VLESS
• Trojan
• Hysteria / Hysteria2
• TUIC
• Snell - 完整支持 v1-v5
• NaiveProxy
• SOCKS5 / HTTP

---

🚀 快速开始

前置要求

• Cloudflare 账号
• GitHub 账号

一键部署

1. Fork 本仓库到你的 GitHub 账号
2. 登录 Cloudflare Dashboard
3. 进入 Workers & Pages → 创建应用程序 → Pages → 连接到 Git
4. 选择你 Fork 的仓库
5. 配置构建设置:
   • 框架预设: Vue
   • 构建命令: npm run build
   • 构建输出目录: dist
6. 点击 保存并部署

---

📚 部署指南

1. 绑定 KV 命名空间 (必需)

部署完成后,进入项目设置:

1. 设置 → 函数 → KV 命名空间绑定
2. 点击 添加绑定
3. 变量名称: MISUB_KV
4. KV 命名空间: 选择或创建一个 KV 命名空间

2. 绑定 D1 数据库 (可选,推荐)

创建 D1 数据库:

wrangler d1 create misub

绑定数据库:

1. 设置 → 函数 → D1 数据库绑定
2. 点击 添加绑定
3. 变量名称: MISUB_DB
4. D1 数据库: 选择刚创建的数据库

初始化表结构:

wrangler d1 execute misub --file=schema.sql --remote

💡 若无法初始化,可在 Cloudflare 控制台手动执行 schema.sql

3. 设置环境变量

在 设置 → 环境变量 中添加 生产环境 变量：

必填：

变量名	说明	示例
ADMIN_PASSWORD	管理员登录密码	your_secure_password
COOKIE_SECRET	Cookie 加密密钥	64位随机字符串

可选（按需设置）：

变量名	说明	示例
CORS_ORIGINS	允许跨域访问的来源(逗号分隔)，同域可不填	https://example.com,http://localhost:5173

前端构建变量（可选）：

变量名	说明	示例
VITE_ERROR_REPORT_URL	前端错误上报地址，不需要上报可不填	/api/system/error_report

4. 重新部署

完成配置后,在 部署 选项卡重新部署项目。

---

💡 使用说明

登录管理界面

登录管理界面

1. 访问您的 Cloudflare Pages 域名（进入公开主页）。
2. 点击右上角的 "登录" 按钮。
3. 输入设置的 ADMIN_PASSWORD 即可进入管理后台。

添加订阅

1. 点击 新增订阅
2. 填写订阅名称和链接
3. (可选) 设置自定义 UA
4. (可选) 添加备注信息
5. (可选) 设置过滤规则
6. 保存订阅

创建订阅组

1. 在右侧面板点击 新增订阅组
2. 选择要包含的订阅和节点
3. 设置分组名称
4. 保存并获取订阅链接

数据迁移 (KV → D1)

如果已在使用 KV 存储,想迁移到 D1:

1. 配置 D1 数据库 (参考部署指南)
2. 登录管理界面,进入 设置
3. 点击 迁移数据到 D1 数据库
4. 确认迁移,等待完成

---

📊 存储类型对比

特性	KV 存储	D1 数据库
写入限制	1000次/天	无限制
查询速度	极快	快
适用场景	读多写少	频繁更新
配置复杂度	简单	中等
推荐使用	轻度使用	重度使用

选择建议:

• 🔰 新用户: 建议直接配置 D1,避免写入限制
• 📈 现有用户: 遇到限制可使用迁移工具
• ⚡ 轻度使用: KV 完全够用,速度更快
• 🚀 重度使用: D1 是最佳选择

---

🛠️ 技术栈

• 前端: Vue 3 + Vite + Tailwind CSS
• 后端: Cloudflare Pages Functions
• 存储: Cloudflare KV + D1 数据库
• 部署: Cloudflare Pages

---

📝 更新日志

v2.3.0 (2026-01-03)

✨ 重要更新:

• 订阅与节点管理重构 - 订阅编辑、配置文件、节点管理与设置模块全面重构，新增节点筛选、规则编辑与统计卡片
• 订阅管理能力增强 - 新增订阅管理模块，支持多协议转换，强化手动节点管理
• 统一 ID 与数据流 - 引入统一 ID 生成工具，订阅/配置/节点数据整合到 useDataStore，移除旧备份与过时认证模块

🛠️ 接口与安全:

• 统一 API 响应 - 统一错误处理与响应格式，新增订阅解析模块
• 安全与请求 - 引入 DOMPurify 清理 SVG，API 调用迁移到 lib/http.js，优化 CORS 并新增错误上报

🔧 工具与开发体验:

• 日志与工具函数 - 优化日志级别与调试输出，统一 timing 常量，formatBytes 迁移到共享工具，更新地理工具函数
• 路由与构建 - 新增 Vite 代理规则，移除 PublicProfilesView 路由，首页增加 /explore 别名
• 测试覆盖 - 新增节点缓存服务单元测试

v2.2.0 (2026-01-02)

✨ 核心功能更新:

• 可视化节点筛选 - 全新的节点规则编辑器，支持标签化管理包含/排除关键词，内置常用地区与协议标签，配置更轻松
• 自定义公开页 Hero - 支持在后台自定义公共主页的标题与标语，打造个性化门户
• 留言板增强 - 新增数学验证码 (Captcha) 防护机制，优化提交成功反馈体验
• 交互体验优化 - 留言板禁用时提供友好的 Toast 提示，优化移动端入口逻辑

🎨 界面重构:

• 设置页全新设计 - 基础设置与服务集成页面采用现代化卡片式布局，功能分区更清晰
• 视觉优化 - 统一了图标风格与色彩系统，优化深色模式体验
• 二维码组件 - 修复二维码遮罩层级与交互问题

⚡️ 其他改进:

• 客户端识别升级 - 增强对 Surge、Stash 等客户端的 User-Agent 识别准确度
• API 修正 - 修复公开配置接口字段缺失问题，增强后端数据安全性

v2.1.0 (2025-12-30)

新增功能:

• ✨ 公开主页 (Explore) - 访客可无需登录浏览精选订阅
• ✨ 访客模式 - 支持公共资源分享与客户端下载指引
• ✨ 新版登录流程 - 统一入口，更加安全便捷
• 🎨 布局优化 - 适配公开页与仪表盘的无缝切换

改进优化:

• 🎨 优化订阅卡片显示
• 🐛 修复 SS2022 节点错误
• 📚 完善文档和使用说明

v2.0.0 (2025-12-22)

新增功能:

• ✨ 订阅备注功能 - 记录官网、价格等信息
• ✨ 自定义 User-Agent - 解决机场 UA 限制
• ✨ Snell 协议完整支持 - 包含 reuse/tfo 参数
• ✨ Snell 协议完整支持 - 包含 reuse/tfo 参数
• ✨ Surge 配置解析增强 - 支持更多参数

v1.5.0

新增功能:

• ✨ D1 数据库支持 - 解决 KV 写入限制
• ✨ 一键数据迁移工具
• ✨ 存储类型选择

v1.0.0

核心功能:

• 🎯 订阅分组 (Profiles)
• 📦 订阅与节点分离管理
• 🎨 全新 UI 设计
• 🔐 密码保护

---

🙏 致谢

本项目基于 CF-Workers-SUB 项目发展而来,感谢 CM 大佬的开源贡献。

---

📄 License

MIT

---

🤝 贡献

欢迎提交 Issue 和 Pull Request!

---

如果这个项目对你有帮助,请给个 ⭐ Star 支持一下!

Made with ❤️ by AI