SubBoost 是一个 Clash/Mihomo 订阅转换、增强和管理 工具。本分支专为零成本部署优化，可运行在 Cloudflare Workers 免费套餐 上，使用 D1（SQLite 边缘数据库） 作为存储。Worker bundle gzip 体积约 1.66 MiB，远低于免费版 3 MiB 上限。

本分支为 Workers 专用，移除了原 Docker/PostgreSQL 部署路径。需要 Docker 版本请前往上游 SubBoost/subboost。

部署到 Cloudflare Workers（免费版）

准备工作

1. 注册 Cloudflare 账号（免费即可）。

2. 安装 Node.js ≥ 22.13.0（建议 24.x LTS）。

3. 克隆仓库并安装依赖：

   git clone https://github.com/Amamiya23/subboost.git
   cd subboost
   npm ci

步骤 1：配置 Wrangler 登录

cd local
npx wrangler login

浏览器会弹出 Cloudflare 授权页，点击 Allow 完成登录。

步骤 2：创建 D1 数据库

# 创建数据库（只需执行一次）
npx wrangler d1 create subboost-db

命令会输出类似：

✅ Successfully created DB 'subboost-db'
[[d1_databases]]
database_id = "45cb5ac4-5e0f-4656-ac08-b18a8801cf89"

把 database_id 填入 local/wrangler.jsonc 的 d1_databases[0].database_id 字段。已存在的占位 ID 需要替换为你自己的。

步骤 3：应用数据库 Migration（建表）

# 应用到生产 D1
npm run db:migrate:d1:remote

或先在本地 D1 测试：

npm run db:migrate:d1:local

步骤 4：设置 Secrets

本服务需要 4 个环境变量：

Secret	用途
ENCRYPTION_KEY	加密订阅 URL、节点、配置等敏感字段
JWT_SECRET	签名管理员会话 token
CRON_SECRET	保护定时刷新 API
APP_URL	应用外部访问 URL（用于生成订阅链接，例如 https://subboost-local.<your-subdomain>.workers.dev）

全新部署（一键生成）

仓库提供了一个辅助脚本，自动生成 3 个强随机密钥并上传到 Cloudflare：

cd local
./scripts/setup-secrets.sh

脚本会提示你输入 Workers URL（其余密钥自动生成），最后打印所有值——请保存到密码管理器，未来重新部署或迁移数据时需要复用。

从 Docker 版本迁移（复用原有密钥）

如果你已有 Docker 部署，ENCRYPTION_KEY 和 JWT_SECRET 必须与原部署完全一致，否则已加密的订阅数据无法解密、已登录用户需重新登录：

cd local
MIGRATE=1 ./scripts/setup-secrets.sh
# 按提示输入原有的 ENCRYPTION_KEY 和 JWT_SECRET

原值可以从 Docker 容器环境变量读取：

docker exec $(docker ps -qf "name=subboost") env | grep -E "ENCRYPTION_KEY|JWT_SECRET"

手动设置（可选）

如不使用脚本，可逐个交互式设置：

npx wrangler secret put ENCRYPTION_KEY
npx wrangler secret put JWT_SECRET
npx wrangler secret put CRON_SECRET
npx wrangler secret put APP_URL

生成强随机密钥：openssl rand -base64 32

步骤 5：构建并部署

npm run deploy:worker

部署成功后，输出类似：

Deployed subboost-local triggers
  https://subboost-local.<your-subdomain>.workers.dev
  schedule: */5 * * * *
  schedule: 0 3 * * * *

步骤 6：设置管理员账号

1. 浏览器访问你的 Workers URL。
2. 首次访问会跳转到设置页面，输入管理员用户名和密码。
3. 设置完成后用该账号登录即可使用。

从 Docker 版本迁移数据

如果你之前在 Docker/PostgreSQL 上运行过 SubBoost，可以把数据迁移到 D1。

导出原数据库

从原 Docker 容器的 PostgreSQL 导出数据为 SQL 文件。例如用 pg_dump 或 DBX 等工具导出为 subboost.sql。

转换并导入

PostgreSQL 的 SQL 与 D1（SQLite）格式有差异，需要转换：

• 去掉 public. schema 前缀
• TRUE/FALSE → 1/0
• 跳过 _prisma_migrations 表
• 跳过 CREATE TABLE（D1 已通过 migration 建表）

转换后只保留 INSERT INTO 语句，然后导入到 D1：

npx wrangler d1 execute subboost-db --remote --file=path/to/converted.sql

关键提醒：

• ENCRYPTION_KEY 和 JWT_SECRET 必须与原 Docker 部署完全一致，否则加密的订阅字段无法解密。
• 时间戳格式 '2026-07-25 16:41:52.945' 对 SQLite 原生兼容，无需转换。

Cron 定时任务

部署后，以下两个定时任务会自动运行（定义在 local/wrangler.jsonc）：

表达式	功能
*/5 * * * *	每 5 分钟检查并刷新到期的订阅
0 3 * * *	每天 03:00 UTC 更新远程规则索引

Cloudflare Workers 免费套餐每月提供 100,000 次请求和 1,000 次 Cron 触发，完全够个人使用。

常用命令速查

cd local

# 一键生成并设置所有 secrets（全新部署）
./scripts/setup-secrets.sh

# 本地开发预览（需先 build:worker）
npm run preview:worker

# 重新构建并部署
npm run deploy:worker

# 仅构建 Worker bundle（不部署）
npm run build:worker

# 查看 D1 数据
npx wrangler d1 execute subboost-db --remote --command='SELECT * FROM LocalAdmin;'

# 应用新的 migration 到远程 D1
npm run db:migrate:d1:remote

# 查看 Worker 实时日志
npx wrangler tail

# 更新某个 secret
npx wrangler secret put ENCRYPTION_KEY

本地开发

# 从仓库根目录
npm ci
npm run dev     # Next.js 开发模式（http://127.0.0.1:3001）

常用检查：

npm run lint
npm run test:unit
npm run local:typecheck

体积优化说明

本分支针对 Workers 免费版做了以下优化：

优化项	gzip 节省	说明
移除 Prisma ORM	~2 MiB	替换为原生 D1 SQL 查询层（local/src/lib/db.ts）
icon.png 移到 public/	~1.5 MiB	避免 Next.js metadata 把图片 base64 内联到 Worker bundle
optimizePackageImports	~50 KiB	按需导入 lucide-react 图标
移除 pg 依赖链	~200 KiB	不再需要 PostgreSQL 适配器

结果：Worker bundle gzip 从 5.75 MiB 降到 1.66 MiB，约为免费版上限（3 MiB）的 55%。

技术架构

浏览器 → Cloudflare Workers (OpenNext) → D1 数据库 (SQLite 边缘存储)
                 ↓
        Cloudflare Cron 触发器
                 ↓
        定时订阅刷新 / 规则索引更新

相关链接

• 上游项目：SubBoost/subboost（Docker/PostgreSQL 版本）