安卓 App
安装 App 后启动服务,把 App 显示的地址填进播放器。它适合局域网临时使用,不适合长期公网服务。
适合谁
- 适合:只想装好就用、家里电视/盒子/平板和手机在同一个 Wi-Fi、没有服务器。
- 不适合:希望公网长期稳定访问、手机经常清后台、希望服务 24 小时无人值守。
- 访问范围:手机自己可以用本机地址;其它设备要用 App 显示的局域网地址。
准备
开始前准备好:
- 一台 Android 6.0 及以上手机。
- 能打开 GitHub Releases 下载页的浏览器。
- 播放器设备和手机连接同一个 Wi-Fi。
如果你的手机会严格限制后台应用,后面需要把这个 App 加入电池优化白名单。
1. 打开下载页
打开安卓 App 最新版下载页:
进入最新版本后,往下找到 Assets / 资源 区域,下载 APK 文件。
2. 选择 APK 架构
通常按这个规则选:
arm64-v8a:绝大多数新手机,优先选这个。armeabi-v7a:老一点的 32 位 ARM 设备。x86_64:少数安卓模拟器或特殊设备。
不知道自己是什么架构时,先下载 arm64-v8a。如果安装时提示不兼容,再换另一个架构。
校验文件
Release 页面通常会附带 SHA256。担心下载文件损坏或被替换时,可以对比 APK 的 SHA256 校验值。
3. 安装 APK
下载完成后,打开 APK 安装。
如果系统提示 未知来源应用:
- 按提示进入设置。
- 允许当前浏览器或文件管理器安装未知来源应用。
- 返回重新安装 APK。
安装完成后,直接打开 App。
4. 启动服务
打开 App 后,在首页按顺序操作:
- 如果首页显示 启动服务,点击它。
- 等状态变成 服务运行中。
- 如果首页本来就显示 服务运行中,说明已经启动,不要点 停止服务。
服务运行后,App 会显示本机地址和局域网地址。
5. 复制局域网访问地址
如果播放器在同一台手机上,可以用本机地址。
如果播放器在电视、盒子、平板或另一台设备上,复制 App 首页显示的 局域网地址。它一般长这样:
http://手机局域网IP:9321/你的TOKEN不要把 127.0.0.1 地址填到电视或盒子里。127.0.0.1 只代表当前这台手机,别的设备访问不到。
6. 填进播放器
打开播放器的自定义弹幕 API 设置,把刚复制的局域网地址填进去。
如果播放器需要你手动填写完整地址,格式是:
http://手机局域网IP:9321/你的TOKEN填完后播放一部有弹幕的影片,能加载弹幕就说明 App 部署成功。
后续不同播放器的具体入口看:播放器接入。
7. 打开系统配置
如果需要调整弹幕源、缓存、请求记录等配置,优先在 App 里找对应的配置入口。
也可以用浏览器打开系统配置地址,格式是:
http://手机局域网IP:9321/你的ADMIN_TOKENADMIN_TOKEN 不要发给别人。它用于进入系统配置。
8. 关闭电池优化
如果服务运行一段时间后自动停掉,通常是 Android 省电策略在清后台。
建议按手机系统设置把 App 加入后台白名单:
- 打开手机 设置。
- 找到 应用管理。
- 找到这个 App。
- 进入 电池 / 耗电管理 / 后台管理。
- 选择 不限制、允许后台运行 或类似选项。
不同品牌手机入口名字不一样,重点是不要让系统自动杀掉这个 App。
9. 以后怎么更新 API 核心
安卓 App 的日常更新重点通常不是重新安装 APK,而是在 App 里更新 API 核心。
按这个顺序做:
- 打开 App。
- 底部点 核心。
- 进入 API 核心管理 页面。
- 找到你正在使用的核心版本,例如 稳定版。
- 点对应卡片里的 检查更新。
- 按 App 提示完成更新后,回首页确认服务仍然是运行中。

图里底部已经选中 核心,稳定版、开发版、自定义版卡片里都有 检查更新。你用哪个核心,就检查哪个核心。
只有 App 外壳本身需要新版功能、修复安装问题,或者项目说明明确要求更新 APK 时,才需要重新下载 APK。
常见问题
安装时提示未知来源怎么办
这是正常现象。APK 不是从应用商店安装,系统会要求你手动允许一次。按提示允许当前浏览器或文件管理器安装未知来源应用,然后重新打开 APK 安装。
电视或平板访问不到手机地址
先确认:
- 手机和播放器设备在同一个 Wi-Fi。
- 播放器里填的是 App 显示的局域网地址,不是
127.0.0.1。 - 手机没有切到移动数据。
- App 首页仍然显示 服务运行中。
- 路由器没有开启 AP 隔离、访客网络隔离之类的功能。
服务启动一段时间后停了
给 App 关闭电池优化,允许后台运行。部分手机还需要在最近任务界面把 App 锁定,避免一键清理时被关掉。
提示需要 Root 权限,不 Root 能用吗
可以。Root 模式是可选增强功能,普通模式下也能启动服务和提供局域网访问。
核心安装或更新失败
先检查手机网络。国内网络访问 GitHub 不稳定时,可以在 App 的网络相关设置里切换 GitHub 下载节点,或稍后重试。
想让外网访问手机上的服务
不建议把安卓 App 当作长期公网服务。外网访问涉及公网 IP、端口转发、隧道、HTTPS 和后台保活,稳定性通常不如 Docker / NAS / 云平台。
如果只是家里设备用,保持局域网访问即可。
