Skip to content

系统任务

定时任务

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

  • 到期扫描
  • 到期删除

默认逻辑如下。

到期扫描

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

到期删除

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

状态同步

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

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

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

其他自动运行任务

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

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

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

用户同步的使用建议

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

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

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

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