播放器接入
目标：把你已经部署好的 danmu_api 地址填进播放器。只做这几步：确认基础地址 → 浏览器先测通 → 打开播放器设置 → 进入自定义弹幕 API → 填地址保存 → 回播放页搜索弹幕。
第 1 步：先确认你要填的是“基础地址”
Section titled “第 1 步：先确认你要填的是“基础地址””播放器里一般填的是基础地址，不是完整测试接口地址。
| 你的情况 | 播放器里通常填什么 |
|---|---|
默认 TOKEN | https://你的域名 |
自定义了 TOKEN | https://你的域名/你的TOKEN |
| Docker / 本地 HTTP | http://你的服务器IP:9321 或 http://你的服务器IP:9321/你的TOKEN |
不要填这种地址
Section titled “不要填这种地址”https://你的域名/api/v2/search/anime?keyword=凡人修仙传第 2 步：先在浏览器里测一次接口
Section titled “第 2 步：先在浏览器里测一次接口”如果你现在还不确定服务是不是正常，先打开：
https://你的域名/api/v2/search/anime?keyword=凡人修仙传或者 Docker / 本地部署就打开：
http://你的服务器IP:9321/api/v2/search/anime?keyword=凡人修仙传能返回搜索结果，再继续往播放器里填。
第 3 步：先打开设置，进入弹幕设置
Section titled “第 3 步：先打开设置，进入弹幕设置”这一步先进入弹幕设置界面，确认你已经走到弹幕相关设置页。
进入路径：
设置→弹幕设置→自定义弹幕 API
先按上面的路径点进去，到 弹幕设置 这里先停一下。下一步再继续点进 自定义弹幕 API 输入页。
第 4 步：继续点进“自定义弹幕 API”页面
Section titled “第 4 步：继续点进“自定义弹幕 API”页面”进入弹幕设置后，继续点 自定义弹幕 API。看到名称和地址输入框，就说明你已经进对地方了。
第 5 步：把基础地址填进去，只填到域名或 TOKEN
Section titled “第 5 步：把基础地址填进去，只填到域名或 TOKEN”直接填你刚才确认好的基础地址。
例如：
https://你的域名或者：
https://你的域名/你的TOKEN再或者 Docker / 本地：
http://你的服务器IP:9321
/api/v2/search/episodes… 接口。第 6 步：回播放页，打开“搜索弹幕”
Section titled “第 6 步：回播放页，打开“搜索弹幕””进入路径：
播放页→弹幕按钮→搜索弹幕
第 7 步：选择你刚才配置的弹幕源
Section titled “第 7 步：选择你刚才配置的弹幕源”
第 8 步：选对结果并加载
Section titled “第 8 步：选对结果并加载”
如果你不是 senplayer
Section titled “如果你不是 senplayer”大多数播放器的思路都一样：
- 找到弹幕设置 / 弹幕扩展
- 找到自定义弹幕 API 或类似入口
- 填基础地址
- 回播放页搜索弹幕
如果你用的是 uz，项目 README 当前给的最短路径是：
弹幕拓展→豆儿弹幕→豆儿弹幕 API
然后把你的基础地址填进去就行。
最常见的 4 个错误
Section titled “最常见的 4 个错误”- 把 GitHub 仓库地址填进播放器。
- 把完整测试接口地址填进播放器。
- 自定义了
TOKEN，却没把/你的TOKEN带进地址。 - 把
/你的ADMIN_TOKEN管理入口当成播放器地址。
还是不行时，按这个顺序排查
Section titled “还是不行时，按这个顺序排查”- 先在浏览器里测试搜索接口是不是能返回内容
- 再确认播放器里填的是基础地址，不是完整接口
- 再确认你有没有把自定义
TOKEN带进地址 - 最后再回播放页重新搜一次弹幕
这页做完后，下一步看哪里
Section titled “这页做完后，下一步看哪里”参考来源：huangxd-/danmu_api README 中的播放器接入说明与用户实际截图；以及社区图文教程 catcat.blog/deploy-danmu_api 里的真实设置页截图。本页图片已本地化到站点资源。