Skip to content

Cloudflare Workers 部署

适合临时测试或备用入口,不建议长期主力使用。免费版外部子请求有限,弹幕分片多时可能缺失或失败。

适合谁

  • 适合:已有 Cloudflare 账号,想快速测试 Workers 路线,或者需要一个备用访问入口。
  • 不适合:大量拉取分片弹幕、希望长期稳定主力使用、希望维护成本最低。
  • 注意:这里是 Cloudflare Workers,不是 Cloudflare Pages。默认地址一般是 https://xxx.yyy.workers.dev/

准备

开始前准备好:

  1. GitHub 账号。
  2. Cloudflare 账号。
  3. 一份你自己的 danmu_api fork。
  4. 一个管理员令牌,后面填到 ADMIN_TOKEN

1. Fork 项目仓库

打开项目仓库:

按顺序操作:

  1. 点击右上角 Fork
  2. 确认 Fork 到你自己的 GitHub 账号。
  3. 页面变成 你的用户名/danmu_api 后再继续。

GitHub 仓库页面右上角 Fork 按钮

GitHub 创建 Fork 确认页面

注意

后面 Cloudflare 要部署你自己账号下的 danmu_api,不要选 huangxd- 的上游仓库。

2. 打开 Workers 部署入口

把下面地址里的 你的GitHub用户名 换成你自己的 GitHub 用户名:

text
https://deploy.workers.cloudflare.com/?url=https://github.com/你的GitHub用户名/danmu_api

如果你的 fork 仓库名不是 danmu_api,最后一段也要一起改。

确认不是 Pages

如果页面里出现 Pagespages.devImport an existing repository 这类字样,说明走错了。本页路线用的是 deploy.workers.cloudflare.com

3. 授权并确认 Worker 名称

Cloudflare 可能会要求你:

  1. 登录 Cloudflare。
  2. 授权 GitHub。
  3. 选择刚才 fork 的 danmu_api 仓库。
  4. 确认 Worker 名称。

Worker 名称建议填:

text
danmu-api

Cloudflare Workers 部署页面确认 Worker 名称

这个名称会影响默认 workers.dev 地址,也会影响后面 DEPLOY_PLATFROM_PROJECT 的填写。如果这里改成别的名字,后面也保持一致。

4. 等待部署成功并复制地址

点击部署后,等待 Cloudflare 构建完成。成功后一般会得到一个默认地址,格式类似:

text
https://你的Worker名.你的账号.workers.dev/

Cloudflare Workers 部署成功后的编辑页面

先把这个地址复制下来,后面自检要用。

国内访问提示

workers.dev 在部分网络环境下可能访问不稳定。如果默认地址打不开,后续可以绑定自定义域名,或者换 Docker / NAS 路线。

5. 配置环境变量

部署完成后,在 Cloudflare 后台进入:

text
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。

路径:

text
Workers & Pages → 你的 Worker → Settings → Builds

检查两点:

  1. Git Repository你的GitHub用户名/danmu_api
  2. 分支是 main

如果这里连成了上游仓库,或者连成了别的仓库,你自己的 Fork Sync 不会触发 Cloudflare 更新。

8. 验证服务

把下面地址里的 你的Worker地址 换成你复制到的 Workers 地址。

打开首页

text
https://你的Worker地址/

能看到 LogVar 弹幕 API 页面,说明服务已经跑起来。

打开播放器地址

TOKEN 换成你设置的值;如果没改过,就是默认的 87654321

text
https://你的Worker地址/你的TOKEN

能看到页面里的配置预览、接口调试等内容,说明播放器地址可用。

打开系统配置

text
https://你的Worker地址/你的ADMIN_TOKEN

能进入系统配置,说明管理员令牌可用。

常见问题

看到的是 Pages 项目,不是 Workers

说明部署入口走错了。Cloudflare Pages 通常会出现 pages.devImport an existing repository 等字样。本页路线应该使用:

text
https://deploy.workers.cloudflare.com/?url=https://github.com/你的GitHub用户名/danmu_api

搜索能返回,但弹幕数量明显偏少

优先怀疑 Workers 子请求限制。分片多的作品会触发多次外部请求,免费版限制可能导致弹幕不完整。长期使用建议改成 Docker 部署NAS / 家用网络

改了 TOKEN,但访问还是 Unauthorized

检查三件事:

  1. 地址里是否用了新的 TOKEN
  2. 变量保存后是否重新部署。
  3. TOKENADMIN_TOKEN 是否填反了。

普通访问用 TOKEN,系统配置用 ADMIN_TOKEN

系统配置更新失败

如果只是能进入系统配置,但修改配置时报错,通常是 Cloudflare 管理变量没有配全。需要时按 UI 与环境变量 补齐。

下一步

本项目仅供个人学习与交流,请勿在国内媒体平台宣传。