---
title: LitePan新增STRM分支功能：生成更快、风控更少
description: LitePan 的 STRM 同步任务新增「分支检查」，用入口分支只扫一层目录、用监控分支递归跟踪连载剧集，把一次全量更新从多次 API 调用压缩到一次，生成速度更快、触发风控的概率也更低；同时补充缓存目录的正确用法与全局缓存限额。
outline: deep
category: 教程
date: 2026-11-04
tags:
  - LitePan
  - STRM
  - 分支
  - 缓存
  - 网盘
readingTime: 7 分钟
---

# LitePan新增STRM分支功能：生成更快、风控更少

> 📺 本图文教程由视频整理而成，对应的参考视频：[网盘聚合LitePan的STRM新增功能～生成速度更快，风控概率更小～](https://www.bilibili.com/video/BV1ipLg6wEzG)。如需查看更详细、更具体的操作演示，可观看原视频。

> 场景：已经用 LitePan 管理网盘、并让同步任务定时生成 STRM 流文件的用户。影视库目录一大，每次全量更新都要对每个影片文件夹逐一调用网盘 API，既慢又容易被风控。分支功能只盯住「经常变动的那一层」，用更少的请求完成同样的更新。

> 提示：本教程配套的操作文档，可在[好用斋官网](https://haoyongzhai.com) → [网盘分享](https://haoyongzhai.com/netdisk)（提取码 545）中下载。

## 第一步：缓存只加「常点的目录」

打开 LitePan 后台，左侧点击「缓存管理」。缓存的作用是记住目录列表，减少重复的网盘 API 请求，所以**加什么目录很关键**。

1. 只添加你日常频繁点开的目录，例如每天都会进去的夸克网盘分享目录。
2. 不要添加那种「平时根本不点、只是拿来一次性生成 STRM」的影视库大目录。
3. 如果你的影视库确实经常访问，可以加进来，生成 STRM 也会更快；但是建议要讲影视库分成多个，只添加经常有变化的小库，尤其是115这种风控严重的。

判断标准很简单：**这个目录你会不会经常手动点开**。会，就加；只为生成 STRM 而存在，就不要加。

## 第二步：看懂全局缓存设置

切到「全局缓存设置」。早期版本这里显示的缓存体积偏小，是统计方式有问题，现在已修正。

<picture>
  <source type="image/avif" srcset="https://image.haoyongzhai.com/tutorials/550.LitePan新增strm分支功能/02-global-cache.avif" />
  <source type="image/webp" srcset="https://image.haoyongzhai.com/tutorials/550.LitePan新增strm分支功能/02-global-cache.webp" />
  <img src="https://image.haoyongzhai.com/tutorials/550.LitePan新增strm分支功能/02-global-cache.png" alt="全局缓存设置：缓存条目、缓存大小与命中率，下方为条目上限与内存上限" width="960" height="430" loading="lazy" />
</picture>

以演示环境为例，缓存了 565 个目录，占用约 12.32 MB，命中率 55.1%，开销很小。

1. 「缓存条目最大数量」默认 **10000**，超出后会挤掉最早的条目。
2. 「缓存内存上限」默认 **512 MB**，达到上限的 70% 或 100% 时会清理一部分旧缓存。
3. 鼠标悬停在问号上可以查看具体说明。
4. 主机内存 16G 以上、对缓存要求较高时，可以把内存上限调到 **1G～2G**；一般情况下默认值已经够用。

## 第三步：重复执行会跳过已缓存内容

以前对同一个目录再次点「立即执行」，会从头重新缓存一遍；现在会先做检测，**已缓存的文件直接跳过**。

1. 在缓存任务列表点「立即执行」。
2. 观察日志，已经缓存过的文件不会重新请求。
3. 列表下方的任务同理，同样会跳过已缓存内容。

缓存目录越大，这种「只补增量」的提升越明显。

## 第四步：设置 STRM 播放地址与批量替换

进入「媒体管理」→「相关设置」，在「播放与调度」里配置：

1. 「STRM 播放地址基础」默认为局域网地址，例如 `http://192.168.31.225:5211`。
2. 需要在外面访问时，改成自己的域名，并做好 DDNS 解析。
3. 改完地址后不必重新生成 STRM：使用下方的「站点替换」，填入新域名后点「一键替换」，会**批量替换目录下所有 STRM 文件里的域名**。

::: warning 注意

站点替换是批量改写文件内容，执行前先确认目标目录和域名没有填错，已生成的 STRM 会被直接覆盖。

:::

## 第五步：新建 STRM 同步任务并调整 API 间隔

演示任务建在 123 云盘的 `/test/test` 目录上，其余选项保持默认即可，重点是「API 额外补偿间隔」。

| 网盘     | 建议间隔            | 说明                       |
| -------- | ------------------- | -------------------------- |
| 115      | 200 起，必要时 300+ | 风控较严，默认 200         |
| 123 云盘 | 100 或 50           | 风控较少，间隔越小生成越快 |
| 夸克     | 参考 123            | 风控不严时可适当调小       |

间隔越小速度越快，但请求过密会触发风控，按自己网盘的实际情况取一个平衡值。

## 第六步：给经常变动的电影目录加「入口分支」

分支功能在任务编辑页的「更多选项」→ 最下方「分支检查」。打开开关后点右侧「详细」，会弹出「分支编辑」。

<picture>
  <source type="image/avif" srcset="https://image.haoyongzhai.com/tutorials/550.LitePan新增strm分支功能/01-branch-editor.avif" />
  <source type="image/webp" srcset="https://image.haoyongzhai.com/tutorials/550.LitePan新增strm分支功能/01-branch-editor.webp" />
  <img src="https://image.haoyongzhai.com/tutorials/550.LitePan新增strm分支功能/01-branch-editor.png" alt="分支编辑：左侧为入口分支列表，右侧为监控分支列表，监控分支可选择有效天数" width="960" height="677" loading="lazy" />
</picture>

两种分支的区别可以先这样理解：**入口分支用来盯电影，监控分支用来盯电视剧**。

入口分支的用法：

1. 在「入口分支」标签页点「浏览」，选择一个经常变动的子目录，例如动画片分类。
2. 点「选择该分支」，再点「新增」，该目录就出现在入口分支列表里。
3. 关闭弹窗，点「更新任务」保存。

::: warning 注意

给主目录添加分支后，任务再次自动更新时**不再扫描整个主目录，只更新分支**。需要全量更新时，必须手动点「全部执行」。

:::

之所以值得这么做，是因为 API 调用次数差距很大：动画片目录下有 10 部影片（每部一个文件夹），全量执行要调用 10 次 API 逐个确认内容；只更新入口分支时只调用 1 次，先看这一层的文件夹有没有变化，有新增才继续处理。请求少一次，速度和风控都跟着改善。影片目录通常只有「分类 → 影片文件夹」两层，正适合入口分支。

## 第七步：给连载中的剧集加「监控分支」

入口分支只检查选中目录的**当前这一层**，不会往下递归。对电影够用，对还在更新的电视剧就不够了：后续往剧集目录里追加新文件，入口分支检测不到。

1. 同样打开「分支编辑」，切到「监控分支」。
2. 点「浏览」选择要跟踪的电视剧目录，点「选择该分支」。
3. 在后面的天数框里选择有效期，例如 30 天、90 天或一年。
4. 点「新增」。

监控分支会**递归检查该目录下所有层级的子目录**，新集数一进来就能生成 STRM。到达设定天数后，监控分支会自动移除，避免长期占用资源。

另外还有一个省事的设计：如果把「电视剧总目录」加入入口分支，之后发现有新增的剧集目录，程序会自动为它添加一个 30 天的监控分支。

## 第八步：新片入库后立即生成（可选）

同步任务默认6小时执行一次（设置中可以修改），不着急可以等。急着看时：

1. 回到首页，逐级进入新影片所在的目录。
2. 在列表上方的名称栏点右键，选择「生成当前目录的 STRM 流文件」。
3. 看不到刚上传的文件时，先点一下「刷新」再操作。

生成后即可在 LitePan 里直接点开，或到 Emby 等播放器中刷新媒体库播放。电视剧的新增集数也可以用同样方式处理。

## 总结

- 缓存只加常点的目录；只为生成 STRM 的影视库大目录不要加。
- 外网访问改 STRM 播放地址后，用「站点替换」批量改写已有文件，不必重新生成。
- 经常变动的电影分类用入口分支，只扫一层、一次 API 就能完成更新。
- 连载中的剧集用监控分支，递归检查并在到期后自动移除。
- 临时新增影片，右键「生成当前目录的 STRM 流文件」即可马上出结果。

## 参考视频

[网盘聚合LitePan的STRM新增功能～生成速度更快，风控概率更小～](https://www.bilibili.com/video/BV1ipLg6wEzG)

## 好用斋官网

[https://haoyongzhai.com](https://haoyongzhai.com)
