部署方式选择
先选部署路线,再跟着对应页面做。第一次部署只要跑通服务和播放器地址,域名、缓存、更多配置可以后面再处理。
部署后会用到的地址
每种部署方式都会先得到一个服务根地址,例如:
text
https://你的域名/播放器里填写的是普通访问地址:
text
https://你的域名/你的TOKEN需要修改系统配置时,使用管理员地址:
text
https://你的域名/你的ADMIN_TOKENTOKEN 是给播放器和日常使用的访问令牌,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。
Cloudflare Workers
适合:测试、折腾、已有 Cloudflare 经验的用户。
优点:
- 全球边缘节点,部署后可直接拿到 Workers 地址。
- 适合验证项目功能或作为备用方案。
注意:
- 不建议作为主力长期使用。
- 免费版单次请求外部子请求数量有限;腾讯视频这类分片多的弹幕,可能出现弹幕获取不全。
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 经验:可以作为测试路线,不建议一开始就当主力。
