企业官网建设流程全解析

LitePan 是一款多网盘聚合管理工具，内置 STRM 生成功能，可自动扫描夸克、115 等网盘中的影视文件并生成 .strm 文件，让 Emby / Jellyfin 媒体服务器直连播放网盘视频，无需先下载到本地。本指南将带你从零完成 STRM 任务配置，实现"网盘视频秒进媒体库"。

为什么需要 STRM？

传统方案是"先下载、再刮削、最后入库"，流程长、占磁盘。而 STRM 的思路是：

• .strm 文件只是一个文本指针，里面写着一个播放地址
• Emby / Jellyfin 把 .strm 当作视频源，点击播放时才通过该地址取流
• 网盘文件无需落地到服务器硬盘，省空间、免搬运

LitePan 的 STRM 模块自动完成了最繁琐的部分：扫描目录 → 生成/更新/清理 .strm 文件 → 生成带鉴权的直连播放链接。相关逻辑在 internal/strm/ 目录中实现，播放路由见 internal/api/strm_play.go。

部署 LitePan 并映射 STRM 目录

使用 Docker Compose 部署时，注意把宿主机目录挂载为/app/strm，LitePan 生成的 .strm 文件都会写入这个目录：

services: litepan: image: ponphil/litepan:beta container_name: litepan restart: unless-stopped ports: - "5211:5211" volumes: - ./data:/app/data - ./strm:/app/strm

启动后访问http://你的IP:5211，默认管理员密码为 admin。完整的部署说明见 README.md。

第一步：创建 STRM 任务

进入后台任务管理 → STRM 任务，点击"添加任务"，填写：

任务保存后，LitePan 会按配置的媒体扩展名扫描目录，把视频文件逐个生成为 .strm 文件，并按目录结构映射到输出目录。后续网盘里新增、删除的文件也会在下一次扫描时自动同步到 STRM 库。

第二步：配置对外基址（关键！）

.strm 文件里的播放地址指向 LitePan 自身，因此必须保证Emby / Jellyfin 所在的网络能访问到 LitePan 的 HTTP 地址。在 STRM 设置中填写"对外基址"（如http://192.168.1.10:5211），LitePan 会把所有生成的 .strm 文件里的站点部分统一替换为该基址，还支持对已有 .strm 文件一键批量替换。

💡 常见坑：基址填了内网地址，但 Emby 部署在异地/外网，就会出现"刮削成功、播放 404"。跨网使用时请填公网可达的地址（域名 + 反代更稳妥）。

LitePan 的播放入口（internal/api/strm_play.go）带有 token 鉴权，链接由系统自动生成，无需手动处理。

第三步：把 STRM 目录加入 Emby / Jellyfin

1. 打开 Emby 或 Jellyfin 后台，进入库 / 媒体库
2. 新建影视库，内容位置选择挂载的./strm目录（或其子目录）
3. 让媒体服务器执行一次媒体信息抓取/刷新，海报墙即可显示

LitePan 还内置了 Emby 代理/刷库能力（internal/api/emby.go），可对接 Emby 实例自动触发库刷新，新片入库后无需手动点"刷新媒体库"。

进阶：STRM 刮削，海报墙更好看

STRM 文件本身不带元数据，想在海报墙上看到正确的片名、海报，可以使用 LitePan 的STRM 刮削功能：

• 自动对 STRM 输出目录进行本地刮削，生成 nfo 与海报文件
• 支持按"已刮削 / 匹配存疑 / 缺失 / 追更"状态筛选
• 剧集支持追更提醒（如 1170/1181 集）

刮削面板源码位于 internal/strmscrape/，界面入口在任务管理 → STRM 刮削。

常见问题（FAQ）

Q1：生成的 .strm 文件在哪个目录？在部署时映射到/app/strm的宿主机目录（即./strm），目录结构与网盘目录一一对应。

Q2：播放失败 / 403 / 超时怎么办？依次检查：① 对外基址是否可被 Emby 访问；② 网盘 Cookie 是否过期（LitePan 会自动刷新，可看账号状态）；③ 网盘是否对当前 IP 限流。

Q3：网盘文件被移动或重命名后，.strm 会失效吗？扫描会做路径漂移纠正与失效清理，更新模式运行后会自动移除已不存在的 .strm 文件（清理逻辑见 internal/strm/ 中的 runner 与 dir cache 模块）。

Q4：一个账号能建多个 STRM 任务吗？可以，不同目录建不同任务即可；全局并发任务数可在 STRM 设置中调整，默认 3 个。

延伸阅读

• 自动化串联（整理 → STRM → 刮削 → 刷库一条龙）：internal/automation/
• 本地 FUSE 挂载（把网盘当本地盘）：internal/fusemount/
• 目录整理与 TMDB 识别：internal/mediaorganize/
• STRM 任务数据结构：internal/domain/strm.go

按以上步骤配置完成后，你的 Emby / Jellyfin 就可以像播放本地视频一样播放网盘里的影视资源了——LitePan 负责扫描、生成、鉴权与刷新，你只管在沙发上点开播放。