系统任务
定时任务
系统启动后会自动运行几类后台任务。后台首页 定时任务 卡片当前主要显示两项:
到期扫描到期删除
默认逻辑如下。
到期扫描
- 默认每
300秒运行一次 - 用于检查已到期账号
- 命中后会创建系统任务,将账号同步为禁用状态
到期删除
- 默认每
3600秒运行一次 - 仅对已经满足删除条件的账号生效
- 是否真的删除,取决于
系统配置中的到期账号删除策略
状态同步
账号状态变化不会直接停留在本地数据库,系统还会通过后台同步任务把结果写回 Emby。
- 默认每
60秒处理一次待同步状态 - 包括禁用、启用等账号状态变更
- 同步失败后会自动重试
- 同步成功后,本地会更新最近同步时间
这部分逻辑直接影响 用户管理 列表中的状态和 最后同步时间。
其他自动运行任务
除首页可见的定时任务外,系统还会自动运行以下后台逻辑:
Emby 探测:默认每60秒采样一次,用于后台首页的 Emby 可用性和延迟统计求片自动关单:默认每10分钟检查一次,已入库内容会自动完成求片工单通知分发:通知服务启动后持续运行,负责投递 Telegram 通知
这些逻辑通常不需要手动干预,但出现异常时可结合运行日志和通知记录排查。
用户同步的使用建议
用户管理 页面中的 同步用户 适合以下场景:
- 首次接入本系统,Emby 中已经存在历史用户
- 需要把 Emby 当前用户重新写回本地
同步用户的作用是把 Emby 当前仍存在的用户补齐到本系统。本地不会因为 Emby 少了某个用户就自动删除对应记录。
因此,完成首次同步后,建议优先通过本系统执行创建、禁用、续费和删除。直接在 Emby 删除用户,无法自动同步回本系统。