Skip to content

🗄️ 飞牛定时同步

通过定时任务只读挂载其 SQLite 库,按配置间隔扫描「已看完」或达到进度阈值的单集,并提交到 Bangumi 同步。

1. 准备

  • 在飞牛 NAS 上定位数据库文件,常见路径为:/usr/local/apps/@appdata/trim.media/database/trimmedia.db(以实际系统为准)。
  • Docker Compose:飞牛卷挂载仅在你启用飞牛同步时才需要;不使用时不必挂载。请将目录或单个库文件只读映射进容器,并在「配置管理」里填写容器内路径(示例见 Docker 安装 中的注释)。推荐挂到 /app/data/feiniu-db:ro

2. 在 WebUI「配置管理」中设置

  • 通知配置 区块下方找到 飞牛影视
  • 勾选 启用飞牛同步 并保存后,会以保存时刻为同步起点:只处理此后在飞牛库中有更新的观看记录,不会把启用前的历史存量一次性推到 Bangumi。再次关闭飞牛并保存会清除该起点;再次启用会重新从当前时刻起算。
  • 填写 数据库路径(容器内路径,例如 /app/data/feiniu-db/trimmedia.db)。
  • 视为看完的最低进度:默认 85%,与飞牛「标记看完」类似,进度达到该百分比即参与同步。
  • 飞牛用户:填 all 或某一用户的 guid(可在已登录 Web 的情况下请求 /api/feiniu/users 查看列表)。
  • 时间范围:在起点水位之上,可再限制只处理最近一段时间内的播放更新。
  • 定时 Cron:默认每 15 分钟 */15 * * * *
  • 保存配置后,飞牛定时任务会随配置热更新。

3. 在 WebUI「调试工具」中手动同步测试(可选)

  • 调试工具 中找到 飞牛同步测试
  • 在飞牛端播放完成一集新的番剧,点击 立即触发飞牛同步