Bangumi-syncer

Appearance

⚙️ 配置说明 ​

在 Web 界面左侧打开 「配置管理」，即可在浏览器里完成本页列出的全部设置。修改后请点击页面下方的 「保存配置」 才会生效（个别项保存后需要重启程序，页面上会有说明）。

同步配置 ​

  • 同步模式：只有一个人用选「单用户」；多人且每人要同步到自己的 Bangumi 账号时选「多用户」。
  • 启用 Webhook 认证：打开后，媒体服务器通知本程序的地址里需要带上密钥，更安全，适合能从外网访问到本程序的情况；关闭则不要求密钥，仅适合完全内网、你信任当前网络环境时使用。
  • Webhook 认证密钥：开启认证后用来拼在通知地址里的一串字符；可复制，也可刷新为新密钥（刷新后记得在 Plex / Emby / Jellyfin 里把 Webhook 地址改成新的）。页面下方会给出各媒体软件地址的填写示例。
  • 屏蔽关键词：若番剧标题里出现这里写的词（多个用逗号隔开），就不同步这一条，用来跳过不想同步的番剧。
  • 剧场版播放开始时将条目标为在看：仅当同步内容为剧场版动画，开启后开始播放剧场版会自动将 Bangumi 条目收藏标为在看。关闭则不会标记在看。
  • 剧场版同步后自动将条目也标为看过：仅当同步内容为剧场版动画，且本篇单集格子已成功打上时，是否再把该条目的收藏状态同时也设为「看过」。关闭则只更新单集观看进度、不把整条条目标为看过。（PS.如果你想自己写影评，建议关闭此项）

Bangumi 账号配置（单用户模式） ​

与上面的「单用户模式」一起使用：只对应一个 Bangumi 账号。

  • 用户名(必输)：你在 Bangumi 网站上的用户名，填个人主页里 @ 后面的数字或用户链接里的那串数字。
  • 访问令牌(必输)：在 Bangumi 网站按提示生成。打开令牌生成页
  • 观看记录仅自己可见：打开后，同步到 Bangumi 的观看记录仅自己可见，关闭则按 Bangumi 上公开的观看记录处理。
  • 媒体服务器用户名(必输)：你在 Plex、Emby 或 Jellyfin 等媒体服务器中的用户名。单用户模式下只同步这些用户产生的观看记录，避免他人进度误记到你的 Bangumi。多台服务器或不同登录名对应同一 Bangumi 时，可用英文逗号分隔多个用户名。

多用户配置（多用户模式） ​

切换到「多用户」后出现本区。点击 「添加 Bangumi 账号」 可为每个用户各配一行：

  • 账号备注：给自己看的名字，方便区分谁是谁。
  • Bangumi 用户名(必输)：该成员在 Bangumi 上的用户名，填个人主页里 @ 后面的数字或用户链接里的那串数字。
  • 媒体服务器用户名(必输)：该成员在 Plex / Emby / Jellyfin 等媒体服务器上的用户名，必须与媒体服务器里显示的一致，这样「谁看的」才能对上「记到谁的 Bangumi」。若同一 Bangumi 账号可以对应多个媒体库用户名，可用英文逗号分隔。
  • 访问令牌(必输)：该成员各自在 Bangumi 生成的令牌。打开令牌生成页
  • 观看记录仅自己可见：是否只让该成员自己在 Bangumi 上看到这条观看记录。

高级配置 ​

  • Web 对外路径前缀（子路径反代）：只有当你把本程序挂在网址的子路径下（而不是网站根目录）时才需要填写，且要与你在网关或反向代理里设置的路径一致。默认留空即可。修改此项后需要重启程序才会完全生效，以页面提示为准。
  • HTTP 代理：本程序访问外网（例如 Bangumi）时走你本地的代理，网络受限或需要翻墙时填写。可使用 「智能配置」 按环境生成推荐地址，并用其中的连通性测试检查是否填对。
  • SSL 证书验证：一般保持开启。仅当使用代理后出现证书报错、且你确认环境可信时，再考虑关闭（会降低连接校验强度）。
  • 调试模式：打开后会打出更多运行细节，方便排查问题；日常使用建议关闭。

Web 认证配置 ​

  • 启用 Web 认证：建议能从外网打开管理页时务必开启；关闭后任何人知道地址都能进管理页，仅适合纯内网且你完全信任当前环境。
  • 管理员用户名 / 管理员密码：登录管理页用的账号密码。密码框留空再保存表示不修改当前密码，要改密码时输入新密码并保存即可。
  • 会话超时时间：登录后多久无操作会自动退出，单位是秒。
  • 启用 HTTPS 安全 Cookie：只有当你用 https:// 访问管理页时才建议打开，避免登录状态被不当传输。
  • 最大登录尝试次数 / 锁定时间（秒）：同一网络下连续输错密码达到次数后，暂时禁止该来源继续尝试登录，减轻被试密码的风险。

Bangumi-data 配置 ​

  • 使用 Bangumi-data 匹配：是否启用公共番剧数据帮助把媒体库里的片名对上 Bangumi 条目，对上之后记格更稳，也能减轻反复查询的负担。
  • 使用本地缓存：是否把下载的数据存到本机，下次启动优先读本地，加快启动、少占带宽。
  • 缓存有效期（天）：本地缓存用多久后认为需要更新；填 0 表示每次启动都尝试更新，一般配置为7天即可。
  • 数据源 URL：数据文件的下载地址，一般保持默认即可；若默认地址在你网络下打不开，可换成镜像说明里提供的地址。
  • 本地缓存路径：缓存文件保存在哪个路径，一般保持默认即可。

通知配置 ​

在同步成功、失败或其它情况发生时，通过 Webhook（例如发到钉钉、Telegram机器人） 或 邮件 提醒你，也可借助本功能扩展其他应用的状态同步能力。

  • 可添加多条 Webhook、多条邮件，分别开关、分别设置「在哪些情况下通知」。
  • 添加或编辑时：地址、请求方式（Webhook）、发信服务器与账号（邮件）等按各服务商的说明填写即可。
  • 通知类型：勾选后表示只在选中的这些情况下发送；全部不勾选则按页面说明，表示所有类型都会通知。
  • 消息模板 / 邮件标题：可按弹窗里的说明，用占位符组合成你想要的正文或标题。
  • 配置好后也可到 「调试工具」 里试发；同类通知在短时间内会限制连续发送次数，避免刷屏。

飞牛影视 ​

从飞牛的播放记录同步到 Bangumi（仅在使用飞牛并需要此功能时关注）。

  • 启用飞牛同步：关闭时完全不读飞牛数据。首次打开并保存后，只会处理保存之后在飞牛里有更新的观看记录，不会把很久以前的老记录一次性全部推到 Bangumi，关闭并保存会清除这一起点设置。
  • 数据库路径：飞牛库里的 trimmedia.db 在本程序能读到的位置（按你安装方式可能是本机路径或容器里的路径），按安装说明挂载或填写即可。
  • 视为看完的最低进度 (%)：播到百分之多少就算「看完了」可以记格，飞牛里已标记看完的会当作 100%。
  • 飞牛用户：通常填 all 表示不区分飞牛账号；若只想同步某一个飞牛用户，需要其专用标识，可在 「调试工具」 中按页面说明查看后再填。
  • 时间范围：在启用同步的前提下，可再限制「只关心最近多久内有更新的记录」，减少无关条目。
  • 定时扫描间隔：隔多久自动检查一次飞牛上的观看进度，界面里有默认间隔，不熟悉可保持不动。
  • 单次扫描最大条数：每次最多处理多少条候选记录，数字越大单次负担越重，一般保持默认即可。