imzyb/MiSub | TR Note 个人笔记

type

Post

status

Published

date

Feb 14, 2026

slug

misub1

summary

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

category

开源分享

icon

password

网址

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

部署教程

MiSub - 部署教程 | TR Note 个人笔记

一款强大的开源订阅转换与聚合管理工具

https://nt.665669.xyz/article/misub2

📸 应用截图

登录界面

管理界面

✨ 功能特性

🎯 核心功能

🗂️ 订阅分组 (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 账号

进入 Workers & Pages → 创建应用程序 → Pages → 连接到 Git

选择你 Fork 的仓库

配置构建设置:

框架预设: Vue

构建命令: npm run build

点击 保存并部署

📚 部署指南

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

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

设置 → 函数 → KV 命名空间绑定

点击 添加绑定

变量名称: MISUB_KV

KV 命名空间: 选择或创建一个 KV 命名空间

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

创建 D1 数据库:

绑定数据库:

设置 → 函数 → D1 数据库绑定

点击 添加绑定

变量名称: MISUB_DB

D1 数据库: 选择刚创建的数据库

初始化表结构:

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

3. 设置环境变量

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

必填：

变量名	说明	示例
`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`