Skip to content

部署方式选择

先选部署路线,再跟着对应页面做。第一次部署只要跑通服务和播放器地址,域名、缓存、更多配置可以后面再处理。

部署后会用到的地址

每种部署方式都会先得到一个服务根地址,例如:

text
https://你的域名/

播放器里填写的是普通访问地址:

text
https://你的域名/你的TOKEN

需要修改系统配置时,使用管理员地址:

text
https://你的域名/你的ADMIN_TOKEN

TOKEN 是给播放器和日常使用的访问令牌,ADMIN_TOKEN 是管理配置用的令牌。建议提前想好,后面部署时会填到环境变量里。

推荐路线

Docker / NAS:长期使用优先

适合:VPS、NAS、小主机、软路由、长期在线电脑。

优点:

  • 稳定,限制少,适合长期主力使用。
  • 本地缓存、Redis、配置文件、备份迁移都更可控。
  • 放在 NAS 或小主机上,局域网使用很方便。

注意:

  • 需要一台能长期运行 Docker 的设备。
  • 外网访问要另外处理域名、端口转发、IPv6 或隧道。

入口:

安卓 App:最省事

适合:只想先体验,或者临时给自己设备用。

优点:

  • 安装后手机就能作为弹幕 API 服务。
  • 不需要服务器、GitHub、云平台账号。

注意:

  • 手机需要保持服务运行。
  • 更适合个人临时使用,不适合作为长期公网服务。

入口:安卓 App

云平台路线

云平台适合快速上线,不用自己维护服务器。每个平台限制不同,建议按下面单独选择,不要只看“免费”。

Vercel

适合:第一次快速体验、已经有 GitHub 账号的用户。

优点:

  • 部署流程简单,Fork 后导入项目即可上线。
  • 免费额度够日常测试和轻量使用。
  • 后续更新可以通过同步 GitHub Fork 触发重新部署。

注意:

  • 默认 *.vercel.app 域名在国内部分网络不稳定。
  • 想稳定使用,通常需要绑定自定义域名或配合可访问的网络环境。

入口:Vercel 部署

Netlify

适合:想快速体验,但 Vercel 默认域名访问不稳定的用户。

优点:

  • 部署流程也比较简单。
  • 国内部分网络访问体验通常比 Vercel 默认域名更友好。

注意:

  • 免费账户有构建积分限制。
  • 旧文档里提到免费账户约 300 积分,重部署会消耗积分;频繁改配置时要留意额度。

入口:Netlify 部署

EdgeOne Pages

适合:已有腾讯云账号,想走腾讯云 Pages 路线的用户。

优点:

  • 国内访问体验通常更接近国内用户环境。
  • 适合后续绑定自己的域名。

注意:

  • 需要腾讯云账号和 EdgeOne Pages 项目。
  • 云平台无状态,缓存建议配合 Upstash Redis 这类外部 Redis。

入口:EdgeOne Pages 部署

Cloudflare Workers

适合:测试、折腾、已有 Cloudflare 经验的用户。

优点:

  • 全球边缘节点,部署后可直接拿到 Workers 地址。
  • 适合验证项目功能或作为备用方案。

注意:

  • 不建议作为主力长期使用。
  • 免费版单次请求外部子请求数量有限;腾讯视频这类分片多的弹幕,可能出现弹幕获取不全。

入口:Cloudflare Workers 部署

Hugging Face Space

适合:演示、试用、临时跑一个公开服务。

优点:

  • 不需要自己准备服务器。
  • 适合做项目演示或快速验证。

注意:

  • 免费实例可能冷启动。
  • 性能和稳定性不适合主力长期使用。

入口:Hugging Face Space 部署

本地和手机命令行路线

Node.js 本地

适合:电脑本地测试、局域网使用。

优点:

  • 直接在电脑上运行,方便调试。
  • 适合先确认播放器接入是否正常。

注意:

  • 电脑关机后服务就停止。
  • 给其他设备使用时,需要同一局域网能访问这台电脑。

入口:Node.js 本地部署

Termux 手机

适合:想在 Android 手机上用命令行运行服务的用户。

优点:

  • 不需要服务器。
  • 比安卓 App 更适合想自己控制源码和配置的人。

注意:

  • 需要安装 Git、Node.js,步骤比 App 更折腾。
  • 手机后台限制可能影响长期运行。

入口:Termux 手机部署

怎么选

  • 长期主力使用:优先 Docker;家里有 NAS / 小主机就看 NAS 路线。
  • 第一次快速体验:先用 Vercel;如果访问不稳定,再试 Netlify 或 EdgeOne。
  • 只想手机临时用:选安卓 App。
  • 已有 Cloudflare / Hugging Face 经验:可以作为测试路线,不建议一开始就当主力。

下一步

选好路线后进入对应教程。部署完成后,再看 部署后自检播放器接入

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