一个美观、现代的 React Router (Remix) 控制台,用于管理 bark-worker Cloudflare Worker 的设备和设置。
bark-worker-console 必须与 bark-worker 使用同一个 D1 数据库,以便能够无缝同步和管理 device_keys 及权限配置。
- 限制注册:通过管理员面板中的
Allow Registration开关控制,设置存储于数据库的settings表中。 - 限制数量:每个用户最多可添加 5 个设备 Key,由控制台后端在添加操作时强制校验。
- 自动清理:当开启
强制注册用户模式时,系统支持每 72 小时自动清理一次未关联用户的冗余 Key(需在系统设置中手动开启)。
-
从
bark-worker项目中复制你的 D1 数据库 ID:"d1_databases": [ { "binding": "database", "database_name": "database-bark", "database_id": "在此处替换你的-ID" } ]
-
将其粘贴到本项目
wrangler.jsonc文件的d1_databases区块中。 -
安装依赖:
npm install -
执行迁移以初始化数据库结构(添加设置和用户管理相关的表):
npm run cf-typegen npx wrangler d1 migrations apply database-bark --local
-
启动开发服务器:
npm run dev
手动部署到 Cloudflare Workers 包括将架构应用到远程数据库并部署 Worker。
1. 应用数据库迁移(远程)
首先,你需要将架构应用到生产环境的 D1 数据库(确保 wrangler.jsonc 中的 ID 已填对):
npx wrangler d1 migrations apply database-bark --remote控制台包含若干项通过环境变量配置的安全防护功能。请在 wrangler.jsonc 中进行更新,或在 Cloudflare 生产环境配置为机密数据(Secrets):
JWT_SECRET:用于对 Session Cookie 进行加密和签名的强随机密钥。你可以通过以下命令生成高熵的随机密钥:openssl rand -base64 32
HCAPTCHA_SITEKEY和HCAPTCHA_SECRET(可选):配置这两项以在注册和登录页面启用 hCaptcha 验证码防刷。如果保留为空,系统会自动禁用验证码。
在生产环境中将敏感参数配置为 Secrets:
npx wrangler secret put JWT_SECRET
npx wrangler secret put HCAPTCHA_SECRET2. 部署到 Cloudflare 构建并将 React Router 控制台部署到你的 Cloudflare 账户:
npm run deploy控制台将作为 Cloudflare Worker/Pages 函数发布,并连接到你现有的
bark-workerD1 数据库。
当你第一次启动并加载登录页面 (/login) 时,如果数据库中没有已注册的用户,系统将自动初始化默认的超级管理员账户:
- 用户名:
admin - 密码:
admin123
注意:出于安全考虑,请在首次登录后立即使用右侧的“安全 (Security)”面板修改默认密码!
- 管理你的 Bark 设备 Key(每个账号上限 5 个)
- 系统管理员可以禁用后续注册,以保持实例的限制性。
- 系统管理员可以启用
force_register_to_use。启用后,只有注册用户才允许通过bark-worker接收 APNs 推送。未注册的设备 Key 将被拦截并返回 HTTP 403 错误。