Skip to content

系统任务

定时任务

系统启动后会自动运行几类后台任务。后台首页 定时任务 卡片当前主要显示三项:

  • 到期扫描
  • 观看保号扫描
  • 到期删除

默认逻辑如下。

到期扫描

  • 默认每 300 秒运行一次
  • 用于检查已到期账号
  • 命中后会创建系统任务,将账号同步为禁用状态

到期删除

  • 默认每 3600 秒运行一次
  • 仅对已经满足删除条件的账号生效
  • 是否真的删除,取决于 配置中心 -> 基础 -> 到期处理 中的 到期账号删除策略

观看保号扫描

  • 默认每天 08:30 运行一次
  • 仅在启用了 观看保号规则 后生效
  • 用于检查当前仍处于 active 的账号,最近是否有观看行为
  • 不达标时会把账号禁用,并写入 watch_requirement 禁用原因

如果你想了解观看保号的配置方式、状态变化和执行原理,请查看:观看保号

手动触发系统任务

除定时执行外,现在也可以在后台 异步任务 页面手动触发以下系统任务:

  • 系统到期禁用用户
  • 系统观看保号扫描
  • 系统到期删除用户

适用场景:

  • 刚修改了保号配置,想立即生效
  • 刚修复了 Webhook 或播放数据采集,想补跑一次
  • 想在不等待下一次定时任务的情况下立即检查结果

如果当前已有同类任务在排队或执行,系统不会重复创建。

状态同步

账号状态变化不会直接停留在本地数据库,系统还会通过后台同步任务把结果写回 Emby。

  • 默认每 60 秒处理一次待同步状态
  • 包括禁用、启用等账号状态变更
  • 同步失败后会自动重试
  • 同步成功后,本地会更新最近同步时间

这部分逻辑直接影响 用户管理 列表中的状态和 最后同步时间

其他自动运行任务

除首页可见的定时任务外,系统还会自动运行以下后台逻辑:

  • Emby 探测:默认每 60 秒采样一次,用于后台首页的 Emby 可用性和延迟统计
  • 求片自动关单:默认每 10 分钟检查一次,已入库内容会自动完成求片工单
  • 通知分发:通知服务启动后持续运行,负责投递 Telegram 通知

这些逻辑通常不需要手动干预,但出现异常时可结合运行日志和通知记录排查。

用户同步的使用建议

用户管理 页面中的 同步用户 适合以下场景:

  • 首次接入本系统,Emby 中已经存在历史用户
  • 需要把 Emby 当前用户重新写回本地

同步用户的作用是把 Emby 当前仍存在的用户补齐到本系统。本地不会因为 Emby 少了某个用户就自动删除对应记录。

因此,完成首次同步后,建议优先通过本系统执行创建、禁用、续费和删除。直接在 Emby 删除用户,无法自动同步回本系统。