STRM 使用说明

STRM 页面负责管理“如何从目录或订阅资源生成 STRM 文件”。当前版本支持两种配置类型:

  1. 普通配置
  2. 订阅配置

一、开始前先做两件事

1. 开启全局 STRM 开关

进入:

媒体 -> STRM

至少确认:

  1. 启用生成 已打开
  2. 如有需要,可决定是否开启 自动删除

2. 准备好路径基础

建议先确认:

  1. 账号已经添加完成
  2. 任务或订阅资源已经具备稳定目录结构
  3. 如果你要使用订阅型 STRM,订阅用户已经先在 订阅中心 中添加好

二、STRM 页面可以做什么

进入左侧菜单 STRM 后,你可以:

  1. 新建配置
  2. 编辑已有配置
  3. 立即生成
  4. 启用 / 关闭定时任务
  5. 对订阅型配置重置增量时间

三、普通配置的创建方法

普通配置适合处理:

  1. 你已经转存到自己网盘的目录
  2. 你希望指定一批固定目录生成 STRM
  3. 你不依赖订阅中心的用户资源

操作步骤

  1. 打开 STRM
  2. 点击 新建配置
  3. 填写 配置名称
  4. 配置类型 中选择 普通
  5. 可选填写 本地路径前缀
  6. 点击 选择目录
  7. 在目录树中勾选要参与生成的目录
  8. 按需填写 排除规则
  9. 决定是否 覆盖已存在文件
  10. 如有需要,开启 定时任务 并填写 Cron
  11. 点击 创建

字段说明

字段说明
配置名称用于区分不同的 STRM 任务
配置类型普通 / 订阅
本地路径前缀生成目录前再额外拼接一层前缀
目录路径真正参与生成的目录集合
排除规则用正则排除短剧、音乐、非目标文件等
覆盖已存在文件重新生成时是否覆盖旧 STRM
定时任务是否按固定周期自动执行

排除规则示例

短剧|花絮|预告|\\.(mp3|flac)$

表示排除:

  1. 名称中包含“短剧”
  2. 名称中包含“花絮”
  3. 名称中包含“预告”
  4. 后缀为 mp3 / flac 的文件

四、订阅配置的创建方法

订阅配置适合处理:

  1. 订阅中心中某个用户的资源
  2. 你希望直接从“订阅用户 -> 资源 -> STRM”这条链路工作
  3. 想让系统按时间做增量更新

操作步骤

  1. 打开 STRM
  2. 点击 新建配置
  3. 填写 配置名称
  4. 配置类型 中选择 订阅
  5. 点击 选择订阅
  6. 在弹窗中选择已经添加好的订阅用户
  7. 如有需要,点击 选择资源
  8. 从该订阅用户的资源中勾选你想处理的资源
  9. 按需填写 本地路径前缀
  10. 按需填写 排除规则
  11. 决定是否开启 定时任务
  12. 点击 创建

“选择资源”是可选的

这一步非常关键:

不选择具体资源

系统默认会处理该订阅用户下的全部根目录资源。

选择了具体资源

系统只会处理你选中的那些资源路径。

五、立即生成与定时生成

配置创建完成后,在列表里可以继续做这些操作:

1. 立即生成

点击 立即生成 后,系统会立刻执行一次当前配置。

适合:

  1. 新建配置后先手动验证
  2. 修改排除规则后想立即重跑
  3. 临时补生成一次

2. 启用定时

如果配置中已经填写了 Cron 表达式,列表里会出现 启用定时 / 禁用定时 开关。

常见做法:

  1. 先新建配置并手动跑通一次
  2. 确认目录结构正确后
  3. 再打开定时执行

六、订阅型 STRM 的增量机制

订阅型 STRM 与普通配置最大的区别之一,是它会记录 上次检查时间

系统会怎么做

  1. 第一次执行时,按当前配置完整处理一遍
  2. 后续再执行时,只优先处理上次检查时间之后有变化的资源

这样可以减少重复扫描和无效写入。

什么时候需要点“重置时间”

如果你遇到下面这些情况,可以点击列表中的 重置时间

  1. 怀疑系统漏掉了旧资源
  2. 你刚改过路径或规则,想重新全量扫描
  3. 订阅源结构变化很大,想重新起算增量

七、输出目录大致怎么理解

STRM 文件最终会生成在你挂载的 STRM 目录下。

普通配置

会按你选择的目录和本地路径前缀组合输出。

订阅配置

系统会在 STRM 目录下再按如下结构组织:

订阅strm / 订阅用户名 / 本地路径前缀

这样做的好处是:

  1. 不同订阅用户互不干扰
  2. 更容易排查来源
  3. 适合多订阅用户并行使用

八、推荐配置方法

对新手最稳的方式

  1. 先开全局 STRM
  2. 先做一条普通配置
  3. 手动生成一次确认结果
  4. 再考虑加订阅配置和定时任务

对订阅源最稳的方式

  1. 先在订阅中心添加用户
  2. 先打开资源列表确认能正常读取
  3. 再建立订阅型 STRM
  4. 先手动生成
  5. 最后再启用 Cron

九、常见问题

1. 订阅配置为什么必须先选订阅用户?

因为订阅型 STRM 的资源来源不是目录树,而是订阅中心里的用户资源。

2. 为什么目录路径在订阅配置里不是必填?

因为订阅配置允许“默认处理该订阅用户的全部资源”,所以目录路径是可选的。

3. 为什么建议先手动生成一次再开定时?

因为手动跑通一次后,你更容易确认:

  1. 路径是否正确
  2. 排除规则是否合理
  3. 订阅资源是否能正常访问
  4. 生成目录是否符合你的播放器预期