SubPanel

轻量订阅聚合分发面板：Cloudflare Workers + D1。多源导入 → 节点池 → 分组 → 订阅链接，适配 Mihomo / sing-box / Surge / V2rayN 等客户端。适合个人 / 家庭 / 小团队。

特性

• 手工节点、远程订阅、透传源（URI / Base64 / Mihomo / sing-box 等）

• 分组下发独立订阅；到期、订阅拉取设备数、流量额度（无法精准统计真实代理流量）

• 管理后台 + 次级用户自助；访问与审计日志

• 第三方 SMTP 到期 / 流量提醒，自动停用

• 亮暗双主题

  

一键部署

全部在 Cloudflare / 面板里完成，无需配置 Secret（生产建议补 CREDENTIALS_KEY 保护远程源 URL）：

1. 点击上方 Deploy to Cloudflare，创建应用。
2. Cloudflare 根据无账号 ID 的 DB 绑定自动创建并复用 D1。
3. 确认 Cron */5 * * * *（配置文件已声明；免费账号注意全账号 Cron 配额）。
4. 打开 Worker 域名 → 初始化数据库（按 migrations/ 创建表，已有表则跳过、不删数据）→ 初始化管理员 → 开始使用。

生产数据存储在 Cloudflare D1，不在仓库文件中。migrations/ 是唯一数据库结构来源；本地开发数据库由 Wrangler 存在 .wrangler/state/，可随时重建。

订阅地址：https://你的域名/sub/<token>（可选 ?format=mihomo|singbox|uri|uri-base64|surge）。

浏览器打开默认同页展示正文（inline）。NekoBox / v2rayN 通用链接使用 URI 列表；源数据里已有证书会尽量写入分享参数。Workers 无法在每次拉订阅时像客户端「获取证书」那样主动探测节点 TLS（需源自带 cert，或在客户端手动获取）。VLESS 多数只有 Reality/pbk/fp，不一定有 PEM 证书。v2rayN 原样包装可加 ?vendor=v2rayn。

流量说明

• none：不统计
• manual：管理员手填已用与额度
• upstream_exclusive：读取单一远程源返回的用量

无法精准统计真实代理流量。 面板只负责下发订阅，不经过用户上网链路，上述用量仅供参考，不能作为计费依据。

「设备数」= 拉取订阅时的客户端指纹，不是在线连接数。

可选 Secret

名称	作用
CREDENTIALS_KEY	≥16 字符；加密远程源 URL/Headers 与 SMTP 密码。不填则首次运行写入 D1（备份/迁移库时勿丢）

本地开发

npm install
cp .dev.vars.example .dev.vars
npm run db:migrate:local
npm run build:web
npx wrangler dev --ip 127.0.0.1 --port 8787

许可

MIT License