STRM 任务
Tasks · STRM
把网盘变成可刮削的本地媒体库
后台 → 任务管理 → STRM 任务。核心是：选对扫描方式、大库再开分支模式，并先把 STRM 设置里的对外基址填对。
快速步骤
新手
先生成第一批 STRM
- 点右上角设置齿轮打开 STRM 设置，填好 对外基址（媒体端能访问的地址）
- 点「新增任务」→ 选账号与目录 → 扫描方式选「更新」
- 保存后会立即执行一次；真实
.strm写到容器内/app/strm（或你映射的输出目录）
大库
库很大、更新太慢：开分支模式
- 先完整跑通一次（建议「更新」或「全量」），把本地
.strm基础库建出来 - 编辑任务 → 更多选项 → 打开 分支检查 → 点「编辑分支」
- 加 入口分支：只扫当前层，适合大库根目录看新增/删除
- 加 监控分支：递归扫追更目录；可设保留天数，追完自动移除
执行
立即执行：全部执行 vs 分支执行
- 未开分支：操作里只有「立即执行」，按任务配置整库扫描
- 已开分支：「全部执行」= 忽略分支、整库扫一遍；「分支执行」= 只按入口/监控分支扫
- 定时调度默认走分支逻辑（开了分支时）；大改结构后再用「全部执行」对齐一次
我该怎么选
| 扫描方式 | 会做什么 | 清理多余 .strm | 推荐 |
|---|---|---|---|
| 补缺 | 只补本地还没有的 .strm；已有文件不改写 | 否 | 少用；怕误删时临时用 |
| 更新 | 新增缺失；已有则按需改写 URL；并清理网盘已删/挪走的对应文件 | 是 | 日常推荐 |
| 全量 | 按当前网盘结果重建写入，并清理多余项 | 是 | 大改结构、令牌/基址大变更后用一次 |
任务里还有哪些常用项
API 额外补偿间隔两次网盘 API 之间多等几毫秒。遇 429 / 风控时优先加大（例如 200–800ms）。
排除关键词可排除目录名 / 文件名含 sample、预告、花絮 等字样，避免脏文件进库。
同步元数据开启后按 STRM 设置里的元数据扩展名，把字幕/海报/nfo 等小文件同步到本地。能访问 TMDB 时，海报/nfo 更建议用刮削生成，少从网盘拉。
扫描间隔任务自己的定时周期；新建任务默认值来自 STRM 设置里的「默认扫描间隔」。不建议设过短。
元数据同步策略
任务中的「同步元数据」仍然只是开关；具体采用哪种同步方式，在右上角的 STRM 设置 → 元数据同步策略 中统一选择，对所有已开启元数据同步的 STRM 任务生效。
| 策略 | 网盘有、本地没有 | 本地有、网盘没有 | 适合场景 |
|---|---|---|---|
| 网盘元数据为主 | 下载到本地 | 删除本地多余文件 | 网盘中的字幕、海报和 NFO 是完整主库，希望本地与网盘保持一致 |
| 本地元数据补缺 | 下载到本地 | 保留在本地，不上传 | 默认推荐；既同步网盘已有元数据，又保留 STRM 刮削生成的本地文件 |
| 本地与云端互补 | 下载到本地 | 上传到网盘 | 希望网盘元数据与本地刮削结果相互补齐 |
使用「网盘元数据为主」前请确认
此策略会删除本地存在、但网盘中没有的元数据。系统只处理「元数据扩展名」中配置的文件，并且只在对应目录完整扫描成功后执行清理。
三种策略都不会用同名文件直接覆盖另一端已有文件。同步过程中，任务状态会分别显示正在下载、上传或清理元数据。
STRM 设置
右上角设置齿轮打开抽屉。点左侧设置项，右侧看说明。Token 不在这里，而在 系统设置 → API 秘钥。
对外基址
生成
必须是媒体端能访问到的地址（局域网 IP / 域名 / 反代入口）。留空则使用当前服务地址。
填错时常见现象：能扫到库，但点播放失败。
.strm 内完整 URL 时使用，例如 https://pan.example.com。必须是媒体端能访问到的地址（局域网 IP / 域名 / 反代入口）。留空则使用当前服务地址。
填错时常见现象：能扫到库，但点播放失败。
常见问题
.strm / Token / 签名是什么关系？
.strm里是一行播放 URL，媒体端按这个 URL 去请求 LitePan。- Token（STRM 媒体访问 Key）是播放入口的钥匙，在「API 秘钥」里管理；换 Key 后旧链接会失效，可勾选应用到已有
.strm。 - URL 签名是可选加固：开启后链接带签名段，更适合公网暴露播放入口。
分支模式为什么能加快大库更新？
「更新」要判断新增和删除。若每次都递归扫整个大库，会又慢又容易撞风控。
分支把它拆开：
- 入口分支只看第一层：判断多了/少了哪个目录，不必递归进每个历史作品。
- 监控分支只对少数追更目录递归：剧集持续更新，又不拖累整库。
注意：开启分支后，系统可能按规则自动把部分子目录加入监控（体验向追剧）。判断依据之一是「本地该子目录下是否已有 .strm」。若本地还几乎没有 .strm 就开分支，可能把大量目录自动加进监控，反而变慢——所以先完整生成一版基础库，再开分支更稳。
剧集为什么不持续更新？
- 开了分支时：把该剧目录加到监控分支（递归）。
- 或暂时关掉分支，用「全部执行 / 立即执行」整库扫（大库不推荐长期这么做）。
更新模式很慢怎么办？
- 用分支：入口 + 监控，把递归缩到追更目录。
- 加大 API 额外补偿间隔，执行计划改到夜间。
- 确认没有在「本地尚无 STRM」时过早开分支导致监控爆炸。
STRM 生成了，媒体端却播不了？
- 先查 STRM 设置里的对外基址是否是媒体端可访问的地址。
- 再查 Token：是否换过 Key 但
.strm仍是旧 Key。 - Docker 非 host 网络时，确认端口映射与反代入口正确。
换域名 / 内外网地址，必须重建 STRM 吗？
不一定。在 STRM 设置里改「对外基址」，再用「一键替换」批量改已有 .strm 第一行 URL 的站点部分即可。
任务被自动联动接管后，执行计划改不了？
若显示「不再执行（仅手动 / 联动）」且被联动锁定，需先从相关自动联动里移除该任务，才能改回全天或时间段。