LitePan 文档

Appearance

后台-媒体管理 ​

Media

把网盘变成媒体库：STRM 与目录整理

本页只做一件事：让你学会用“媒体管理”。不想看长文，就按下面三个「快速步骤」做即可。

快速步骤 ​

STRM

生成 STRM（新手）

  1. 后台 → 媒体管理 → 相关设置：填好 STRM播放地址基址（媒体端能访问的地址）
  2. STRM任务：新建任务 → 选择账号与目录 → 扫描方式选“更新”
  3. 填写好其他项目后点击“保存任务”，系统会立即执行一次任务，并把真实 .strm 文件写入服务器 /app/strm
分支

库很大，更新太慢（分支模式）

  1. 先完整执行一次（建议“更新/全量”跑完）：先把 .strm 基础库生成出来
  2. 在任务里打开 分支检查，点“编辑分支”
  3. 加 入口分支：只看第一层新增/删除，不递归扫历史项目
  4. 加 监控分支：对追更目录递归扫描，保证剧集持续更新
  5. 监控分支设 保留天数：追完自动移除，后续更快
整理

自动改名/搬家（目录整理）

  1. 媒体管理 → 目录整理：新建任务（原地改名 / 移动到目标根目录）
  2. 点「预览并执行」先看计划：不对就编辑/移除
  3. 确认无误再点「确认执行」

我该怎么选 ​

选项你会得到什么会清理旧的 .strm推荐
补缺只新增缺失否不常用
更新新增 + 清理缺失是推荐
全量全部重建是（先删后建）仅大改时

Emby 反代 ​

Emby

让播放器支持302重定向

  1. 背景：部分场景下，Emby 在刮削/播放 .strm 时不会按预期跟随 302 重定向，导致播放失败或无法拿到网盘直链
  2. 做法：媒体管理 → Emby反代 → 新建反代（填写 Emby 地址与 API Key），然后把“代理入口”当作你的 Emby 访问入口使用
  3. 注意：效果与网盘/驱动是否支持 302、以及你的 Emby 部署方式相关；如果使用端口型反代，Docker 非 host 网络模式下需要额外映射对应端口

相关设置 ​

代理地址（TMDB）
目录整理依赖 TMDB。若您无法直连 TMDB，需开启代理并填写代理地址。填好后先用“测试连通性/测试 TMDB”确认可用。

常见问题 ​

.strm / token / sign 是什么关系？
  • .strm 里是一行播放 URL，媒体端按 URL 去访问。
  • token 是播放入口的“钥匙”，换了 token 旧链接会失效。
  • sign 是可选的“加固”：开启后 URL 会带签名参数，适合公网暴露播放入口。
分支模式为什么能“解决增量更新”？

更新模式的本质是：新增要补上、删除/移动要清掉旧的。问题在于“为了判断新增/删除”，很多人会被迫递归扫整个大库。

分支模式把这件事拆开：

  • 入口分支只看第一层：判断“多出来了哪个目录/少了哪个目录”，就能完成“增量清理”的关键工作，而且不递归扫每个作品目录。
  • 监控分支只对少数追更目录递归：保证剧集持续更新，但不会把整个大库都拖进递归扫描。

注意：分支模式默认会尝试“自动发现”需要加入监控的子目录（用于追剧体验）。它判断依据之一是“本地该子目录下是否已经有 .strm”。所以如果你在本地还没有任何 .strm 的情况下就开启分支，可能会把大量已完结剧目录也自动加入监控分支，反而变慢。

什么时候需要调“API额外补偿间隔/执行时间段/并发数”？
  • 遇到风控、429、请求慢：优先加 “API额外补偿间隔”（例如 200-800ms）。
  • 白天影响体验：设置“执行时间段”，让它夜间跑。
  • 机器性能一般：并发数先小再大，稳定优先。
目录整理的“计划预览”怎么避免误操作？
  • 永远先点「预览并执行」看计划。
  • 不对就编辑/移除计划项。
  • 确认无误再点「确认执行」。
STRM 生成了，但媒体端播放失败？
  • 先检查「相关设置」里的 播放地址基址，是否是媒体端可访问的地址
  • 再检查 token：是否更换过令牌但媒体端仍在用旧 .strm
更换域名/内外网地址后，必须重新生成 STRM 吗？

不一定。可以在「相关设置 → STRM设置」里用“站点替换”一键批量替换已有 .strm 里的站点地址（适合域名更换、内网/外网地址切换）。

整理后的文件名里，媒体信息标签（分辨率/编码/声道）怎么控制顺序？

在「相关设置 → 整理设置」里可以调整“媒体信息标签排序”。整理时如果能从文件信息/文件名识别到这些标签，就会按你设定的顺序拼进新文件名；识别不到就会跳过。

“强迫症模式”是做什么的？

在「相关设置 → 整理设置」里开启后，同一后缀的一组文件会尽量保持媒体信息标签一致，避免同一部作品里出现“有的文件带标签、有的不带”的情况。

更新模式很慢怎么办？
  • 用分支模式：入口分支 + 监控分支，把递归扫描范围缩到“追更目录”
  • 给驱动加 API 补偿间隔，尽量夜间执行
剧集为什么不持续更新？
  • 你需要把该剧的目录加到“监控分支”（递归扫描）
  • 或者不用分支模式，改回全量递归（不推荐大库）
整理计划里有些命名不对？
  • 在预览界面直接编辑目标名，或把该项从计划里移除
  • 不要硬执行，先改计划再执行