Thanks to visit codestin.com
Credit goes to github.com

Skip to content

imzyb/MiSub

Repository files navigation

MiSub

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

License Cloudflare Pages Vue 3

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


📸 应用截图

登录界面 管理界面
登录界面 管理界面

✨ 功能特性

🎯 核心功能

  • 🗂️ 订阅分组 (Profiles)

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

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

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

🆕 最新功能

  • 📝 订阅备注

    • 为每个订阅添加备注信息
    • 记录官网、价格、到期时间等
    • 在订阅卡片上清晰显示
  • 🌐 自定义 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位随机字符串

4. 重新部署

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


💡 使用说明

登录管理界面

访问你的 Cloudflare Pages 域名,使用设置的 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.0.0 (2024-12-22)

新增功能:

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

改进优化:

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

v1.5.0

新增功能:

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

v1.0.0

核心功能:

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

🙏 致谢

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


📄 License

MIT


🤝 贡献

欢迎提交 Issue 和 Pull Request!


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

Made with ❤️ by AI

About

测试站,密码admin

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published