Cloudflare Workers 部署
适合临时测试或备用入口,不建议长期主力使用。免费版外部子请求有限,弹幕分片多时可能缺失或失败。
适合谁
- 适合:已有 Cloudflare 账号,想快速测试 Workers 路线,或者需要一个备用访问入口。
- 不适合:大量拉取分片弹幕、希望长期稳定主力使用、希望维护成本最低。
- 注意:这里是 Cloudflare Workers,不是 Cloudflare Pages。默认地址一般是
https://xxx.yyy.workers.dev/。
准备
开始前准备好:
- GitHub 账号。
- Cloudflare 账号。
- 一份你自己的
danmu_apifork。 - 一个管理员令牌,后面填到
ADMIN_TOKEN。
1. Fork 项目仓库
打开项目仓库:
按顺序操作:
- 点击右上角 Fork。
- 确认 Fork 到你自己的 GitHub 账号。
- 页面变成
你的用户名/danmu_api后再继续。


注意
后面 Cloudflare 要部署你自己账号下的 danmu_api,不要选 huangxd- 的上游仓库。
2. 打开 Workers 部署入口
把下面地址里的 你的GitHub用户名 换成你自己的 GitHub 用户名:
https://deploy.workers.cloudflare.com/?url=https://github.com/你的GitHub用户名/danmu_api如果你的 fork 仓库名不是 danmu_api,最后一段也要一起改。
确认不是 Pages
如果页面里出现 Pages、pages.dev、Import an existing repository 这类字样,说明走错了。本页路线用的是 deploy.workers.cloudflare.com。
3. 授权并确认 Worker 名称
Cloudflare 可能会要求你:
- 登录 Cloudflare。
- 授权 GitHub。
- 选择刚才 fork 的
danmu_api仓库。 - 确认 Worker 名称。
Worker 名称建议填:
danmu-api
这个名称会影响默认 workers.dev 地址,也会影响后面 DEPLOY_PLATFROM_PROJECT 的填写。如果这里改成别的名字,后面也保持一致。
4. 等待部署成功并复制地址
点击部署后,等待 Cloudflare 构建完成。成功后一般会得到一个默认地址,格式类似:
https://你的Worker名.你的账号.workers.dev/
先把这个地址复制下来,后面自检要用。
国内访问提示
workers.dev 在部分网络环境下可能访问不稳定。如果默认地址打不开,后续可以绑定自定义域名,或者换 Docker / NAS 路线。
5. 配置环境变量
部署完成后,在 Cloudflare 后台进入:
Workers & Pages → 你的 Worker → Settings → Variables and Secrets至少添加这些变量:
ADMIN_TOKEN:管理员令牌,用来进入系统配置。TOKEN:普通访问令牌;不改也可以继续用默认87654321。
如果你想在网页里修改系统配置,还需要继续配置:
DEPLOY_PLATFROM_ACCOUNT:Cloudflare Account ID。DEPLOY_PLATFROM_PROJECT:Worker 脚本名,例如danmu-api。DEPLOY_PLATFROM_TOKEN:Cloudflare API Token。
变量怎么找、怎么填,可以看:UI 与环境变量。
6. 重新部署
变量保存后,按页面提示重新部署一次。你可能会看到这些按钮或操作:
- Deploy
- Save and Deploy
- Create deployment
- Retry deployment
如果页面没有提示,可以先直接测试;如果发现令牌不生效,再回 Worker 里手动重新部署。
7. 确认 Cloudflare 监听的是你的 fork
后续更新要靠 GitHub 仓库同步,所以需要确认 Cloudflare 连的是你自己的 fork。
路径:
Workers & Pages → 你的 Worker → Settings → Builds检查两点:
Git Repository是你的GitHub用户名/danmu_api。- 分支是
main。
如果这里连成了上游仓库,或者连成了别的仓库,你自己的 Fork Sync 不会触发 Cloudflare 更新。
8. 验证服务
把下面地址里的 你的Worker地址 换成你复制到的 Workers 地址。
打开首页
https://你的Worker地址/能看到 LogVar 弹幕 API 页面,说明服务已经跑起来。
打开播放器地址
把 TOKEN 换成你设置的值;如果没改过,就是默认的 87654321。
https://你的Worker地址/你的TOKEN能看到页面里的配置预览、接口调试等内容,说明播放器地址可用。
打开系统配置
https://你的Worker地址/你的ADMIN_TOKEN能进入系统配置,说明管理员令牌可用。
常见问题
看到的是 Pages 项目,不是 Workers
说明部署入口走错了。Cloudflare Pages 通常会出现 pages.dev、Import an existing repository 等字样。本页路线应该使用:
https://deploy.workers.cloudflare.com/?url=https://github.com/你的GitHub用户名/danmu_api搜索能返回,但弹幕数量明显偏少
优先怀疑 Workers 子请求限制。分片多的作品会触发多次外部请求,免费版限制可能导致弹幕不完整。长期使用建议改成 Docker 部署 或 NAS / 家用网络。
改了 TOKEN,但访问还是 Unauthorized
检查三件事:
- 地址里是否用了新的
TOKEN。 - 变量保存后是否重新部署。
TOKEN和ADMIN_TOKEN是否填反了。
普通访问用 TOKEN,系统配置用 ADMIN_TOKEN。
系统配置更新失败
如果只是能进入系统配置,但修改配置时报错,通常是 Cloudflare 管理变量没有配全。需要时按 UI 与环境变量 补齐。
