| 登录界面 | 管理界面 |
|---|---|
 |
 |
-
🗂️ 订阅分组 (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 账号
- Fork 本仓库到你的 GitHub 账号
- 登录 Cloudflare Dashboard
- 进入
Workers & Pages→创建应用程序→Pages→连接到 Git - 选择你 Fork 的仓库
- 配置构建设置:
- 框架预设:
Vue - 构建命令:
npm run build - 构建输出目录:
dist
- 框架预设:
- 点击
保存并部署
部署完成后,进入项目设置:
设置→函数→KV 命名空间绑定- 点击
添加绑定 - 变量名称:
MISUB_KV - KV 命名空间: 选择或创建一个 KV 命名空间
创建 D1 数据库:
wrangler d1 create misub绑定数据库:
设置→函数→D1 数据库绑定- 点击
添加绑定 - 变量名称:
MISUB_DB - D1 数据库: 选择刚创建的数据库
初始化表结构:
wrangler d1 execute misub --file=schema.sql --remote💡 若无法初始化,可在 Cloudflare 控制台手动执行
schema.sql
在 设置 → 环境变量 中添加 生产环境 变量：
必填：
| 变量名 | 说明 | 示例 |
|---|---|---|
ADMIN_PASSWORD |
管理员登录密码 | your_secure_password (未设置则默认为 admin) |
COOKIE_SECRET |
Cookie 加密密钥 | 64位随机字符串 (推荐留空，系统自动生成) |
可选（按需设置）：
| 变量名 | 说明 | 示例 |
|---|---|---|
CORS_ORIGINS |
允许跨域访问的来源(逗号分隔)，同域可不填 | https://example.com,http://localhost:5173 |
MISUB_PUBLIC_URL |
对外访问的公开域名，用于订阅转换回调（Docker/反代必填） | https://your-domain.com |
MISUB_CALLBACK_URL |
订阅转换回调基础地址（优先级高于 MISUB_PUBLIC_URL） | http://misub:8080 |
前端构建变量（可选）：
| 变量名 | 说明 | 示例 |
|---|---|---|
VITE_ERROR_REPORT_URL |
前端错误上报地址，不需要上报可不填 | /api/system/error_report |
提示：启用错误上报后会发送页面地址与浏览器信息等运行数据，请根据隐私与合规要求进行评估与披露。
完成配置后,在 部署 选项卡重新部署项目。
适用于自建服务器部署（与 Cloudflare Pages 保持功能兼容）。
docker compose up -d --build默认端口为 8080，访问 http://<vps-ip>:8080。
⚠️ 注意：仓库根目录的docker-compose.yml为 镜像部署 配置（默认ghcr.io/imzyb/misub:latest）。如需源码构建，请自行新建包含build: .的 compose 文件。
在 docker-compose.yml 中配置：
ADMIN_PASSWORD管理员密码（可选，默认admin）COOKIE_SECRETCookie 加密密钥（可选，推荐留空自动生成）CORS_ORIGINS允许跨域访问的来源（可选）PORT服务端口（默认 8080）MISUB_DB_PATHSQLite 数据库路径（默认/app/data/misub.db）MISUB_PUBLIC_URL对外访问的公开域名，用于订阅转换回调（反代/公网环境建议配置）MISUB_CALLBACK_URL订阅转换回调基础地址（优先级高于 MISUB_PUBLIC_URL）
默认通过 ./data 目录持久化数据库文件。
最小化 VPS 部署步骤：
- 新建目录并进入：
mkdir -p /opt/misub && cd /opt/misub- 创建
docker-compose.yml（使用 GHCR 镜像）：
services:
misub:
image: ghcr.io/imzyb/misub:latest
ports:
- "8080:8080"
environment:
PORT: 8080
MISUB_DB_PATH: /app/data/misub.db
ADMIN_PASSWORD: "change_me"
COOKIE_SECRET: "change_me_too"
# CORS_ORIGINS: "https://example.com,http://localhost:5173"
# MISUB_PUBLIC_URL: "https://your-domain.com"
# MISUB_CALLBACK_URL: "https://your-domain.com"
volumes:
- ./data:/app/data
restart: unless-stopped- 启动并拉取镜像：
docker compose pull
docker compose up -d- 访问：
http://<vps-ip>:8080
支持通过 Zeabur 平台一键部署：
- 在 Zeabur 创建新项目，选择 从 Git 部署
- 连接 GitHub 并选择你 Fork 的 MiSub 仓库
- 等待构建完成（使用 Docker 方式构建）
- 在服务设置中添加环境变量：
| 变量名 | 说明 | 必填 |
|---|---|---|
ADMIN_PASSWORD |
管理员密码 | ❌ (默认 admin) |
COOKIE_SECRET |
Cookie 加密密钥 | ❌ (自动生成) |
MISUB_DB_PATH |
数据库路径（建议 /app/data/misub.db） |
✅ |
- 绑定域名或使用 Zeabur 提供的
.zeabur.app域名
⚠️ 注意: Zeabur 部署默认使用端口 8080，已在zeabur.json中配置。⚠️ 注意: 请在 Zeabur 中启用持久化存储并挂载到/app/data，否则数据库会在重建后丢失。
- 部署完成后，公开页面默认 不开启（访问域名会显示伪装页）。
- 请直接访问
您的域名/login进入登录页面。 - 输入设置的
ADMIN_PASSWORD即可进入管理后台。- 注意：如果未设置
ADMIN_PASSWORD，默认密码为admin。 - 首次登录：使用默认密码登录后，系统会提示您立即在「设置」->「基础设置」中修改密码。
- 注意：如果未设置
- 点击
新增订阅 - 填写订阅名称和链接
- (可选) 设置自定义 UA
- (可选) 添加备注信息
- (可选) 设置过滤规则
- 保存订阅
- 在右侧面板点击
新增订阅组 - 选择要包含的订阅和节点
- 设置分组名称
- 保存并获取订阅链接
如果已在使用 KV 存储,想迁移到 D1:
- 配置 D1 数据库 (参考部署指南)
- 登录管理界面,进入
设置 - 点击
迁移数据到 D1 数据库 - 确认迁移,等待完成
| 特性 | KV 存储 | D1 数据库 |
|---|---|---|
| 写入限制 | 1000次/天 | 无限制 |
| 查询速度 | 极快 | 快 |
| 适用场景 | 读多写少 | 频繁更新 |
| 配置复杂度 | 简单 | 中等 |
| 推荐使用 | 轻度使用 | 重度使用 |
选择建议:
- 🔰 新用户: 建议直接配置 D1,避免写入限制
- 📈 现有用户: 遇到限制可使用迁移工具
- ⚡ 轻度使用: KV 完全够用,速度更快
- 🚀 重度使用: D1 是最佳选择
- 前端: Vue 3 + Vite + Tailwind CSS
- 后端: Cloudflare Pages Functions
- 存储: Cloudflare KV + D1 数据库
- 部署: Cloudflare Pages
✨ 更新内容:
- 版本更新 - 项目版本升级至 v2.4.0，为了方便拉取与版本管理
- Docker 优化 - Docker 镜像标签默认使用具体版本号
✨ 重要更新:
- 订阅与节点管理重构 - 订阅编辑、配置文件、节点管理与设置模块全面重构，新增节点筛选、规则编辑与统计卡片
- 订阅管理能力增强 - 新增订阅管理模块，支持多协议转换，强化手动节点管理
- 统一 ID 与数据流 - 引入统一 ID 生成工具，订阅/配置/节点数据整合到
useDataStore，移除旧备份与过时认证模块
🛠️ 接口与安全:
- 统一 API 响应 - 统一错误处理与响应格式，新增订阅解析模块
- 安全与请求 - 引入 DOMPurify 清理 SVG，API 调用迁移到
lib/http.js，优化 CORS 并新增错误上报
🔧 工具与开发体验:
- 日志与工具函数 - 优化日志级别与调试输出，统一 timing 常量，
formatBytes迁移到共享工具，更新地理工具函数 - 路由与构建 - 新增 Vite 代理规则，移除
PublicProfilesView路由，首页增加/explore别名 - 测试覆盖 - 新增节点缓存服务单元测试
✨ 核心功能更新:
- 可视化节点筛选 - 全新的节点规则编辑器，支持标签化管理包含/排除关键词，内置常用地区与协议标签，配置更轻松
- 自定义公开页 Hero - 支持在后台自定义公共主页的标题与标语，打造个性化门户
- 留言板增强 - 新增数学验证码 (Captcha) 防护机制，优化提交成功反馈体验
- 交互体验优化 - 留言板禁用时提供友好的 Toast 提示，优化移动端入口逻辑
🎨 界面重构:
- 设置页全新设计 - 基础设置与服务集成页面采用现代化卡片式布局，功能分区更清晰
- 视觉优化 - 统一了图标风格与色彩系统，优化深色模式体验
- 二维码组件 - 修复二维码遮罩层级与交互问题
⚡️ 其他改进:
- 客户端识别升级 - 增强对 Surge、Stash 等客户端的 User-Agent 识别准确度
- API 修正 - 修复公开配置接口字段缺失问题，增强后端数据安全性
新增功能:
- ✨ 公开主页 (Explore) - 访客可无需登录浏览精选订阅
- ✨ 访客模式 - 支持公共资源分享与客户端下载指引
- ✨ 新版登录流程 - 统一入口，更加安全便捷
- 🎨 布局优化 - 适配公开页与仪表盘的无缝切换
改进优化:
- 🎨 优化订阅卡片显示
- 🐛 修复 SS2022 节点错误
- 📚 完善文档和使用说明
新增功能:
- ✨ 订阅备注功能 - 记录官网、价格等信息
- ✨ 自定义 User-Agent - 解决机场 UA 限制
- ✨ Snell 协议完整支持 - 包含 reuse/tfo 参数
- ✨ Snell 协议完整支持 - 包含 reuse/tfo 参数
- ✨ Surge 配置解析增强 - 支持更多参数
新增功能:
- ✨ D1 数据库支持 - 解决 KV 写入限制
- ✨ 一键数据迁移工具
- ✨ 存储类型选择
核心功能:
- 🎯 订阅分组 (Profiles)
- 📦 订阅与节点分离管理
- 🎨 全新 UI 设计
- 🔐 密码保护
本项目基于 CF-Workers-SUB 项目发展而来,感谢 CM 大佬的开源贡献。
欢迎提交 Issue 和 Pull Request!
如果这个项目对你有帮助,请给个 ⭐ Star 支持一下!
Made with ❤️ by AI