StrmGuide

STRM 配置指南

STRM 文件是一种仅包含播放地址的文本文件，媒体服务器读取 .strm 后即可播放云端资源。Cloud189 Auto Save 支持普通 STRM 配置、订阅 STRM 配置和懒转存 STRM。

---

1. STRM 基础

什么是 STRM

.strm 文件内容通常是一行播放地址：

http://192.168.1.100:8097/stream/xxxx

媒体服务器会像打开本地媒体文件一样打开这个地址。本项目可以在播放时动态换取天翼云盘直链，降低直链过期带来的播放失败概率。

常见用途

• Emby/Jellyfin/Plex 播放云盘资源。
• 已转存资源批量生成 STRM。
• 订阅资源按增量生成 STRM。
• 懒转存：先生成 STRM，播放时再触发转存。

---

2. 全局 STRM 设置

进入 媒体 页，在 STRM 设置 中配置：

配置项	说明
启用 STRM 生成	控制普通任务是否生成 STRM
普通任务使用系统中转	普通任务生成的 STRM 是否使用本项目代理地址

如果要使用独立流代理，还需要在 媒体 页的 Emby 设置 中检查代理端口配置，并确保 Docker 映射了对应端口。

---

3. STRM 页功能

进入 STRM 页，可以管理 STRM 配置。

页面主要按钮：

按钮	说明
新建配置	创建普通或订阅 STRM 生成配置
懒转存STRM生成	根据分享链接直接生成懒转存 STRM

配置列表字段：

字段	说明
名称	STRM 配置名称
类型	普通或订阅
目标	账号目录或订阅资源
定时	是否启用 Cron 定时
状态	启用或停用
最后运行	最近执行时间

---

4. 新建普通 STRM 配置

点击 新建配置，生成类型选择 普通 (账号/目录)。

常用字段：

字段	说明
配置名称	便于识别的名称
选择账号	要扫描的天翼云盘账号
指定目录 (可选)	只扫描账号下的指定目录
本地路径前缀 (可选)	STRM 输出路径前缀
排除模式 (正则, 可选)	排除不需要生成 STRM 的文件
覆盖已存在的 .strm 文件	是否重写已有 STRM
启用配置	是否启用该配置
定时任务	是否按 Cron 自动执行
Cron 表达式	定时执行周期

普通配置适合为某个账号或目录下已有文件批量生成 STRM。

---

5. 新建订阅 STRM 配置

点击 新建配置，生成类型选择 订阅 (按资源)。

常用字段：

字段	说明
选择订阅	从订阅列表选择资源来源
选择资源 (可选)	只为订阅内部分资源生成
本地路径前缀 (可选)	STRM 输出路径前缀
排除模式 (正则, 可选)	排除不需要生成的文件
覆盖已存在的 .strm 文件	是否重写已有 STRM
定时任务	是否按 Cron 增量执行

订阅类型配置支持 重置时间，用于重新计算订阅增量生成范围。

---

6. 懒转存 STRM 生成

点击 懒转存STRM生成，填写：

字段	说明
选择账号	播放触发转存时使用的账号
分享链接	天翼云盘分享链接
访问码	分享访问码，没有可留空
保存目录	播放触发转存后的目标目录
本地路径前缀 (可选)	STRM 输出路径前缀
覆盖已存在的 .strm 文件	是否覆盖同名 STRM

点击 立即生成 后，系统会根据分享链接生成懒转存 STRM。播放该 STRM 时，系统再执行转存并返回可播放地址。

---

7. 流代理与端口

默认代理端口为 8097。Docker 部署时建议映射：

docker run -d \
  -p 3000:3000 \
  -p 8097:8097 \
  ghcr.io/wobuhui666/cloud189-auto-save:latest

反向代理示例：

location /emby-proxy/ {
    proxy_pass http://127.0.0.1:8097/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

使用反向代理时，请确保 STRM 中生成的地址能被媒体服务器访问。

---

8. API 接口

所有接口都需要带上系统 API Key：

x-api-key: YOUR_API_KEY

根据任务生成 STRM

POST /api/tasks/strm

请求体示例：

{
  "taskIds": [1, 2],
  "overwrite": false
}

懒转存 STRM

POST /api/strm/lazy-share/generate

STRM 配置管理

方法	路径	说明
GET	/api/strm/configs	获取配置列表
POST	/api/strm/configs	创建配置
PUT	/api/strm/configs/:id	更新配置
DELETE	/api/strm/configs/:id	删除配置
POST	/api/strm/configs/:id/run	立即执行配置
POST	/api/strm/configs/:id/reset	重置订阅配置增量时间
GET	/api/strm/list	查看已生成 STRM 文件

---

最佳实践

• 媒体服务器无法播放时，先检查 STRM 文件里的地址是否能从媒体服务器访问。
• 使用懒转存前，确认账号本地 STRM 目录和保存目录都已配置。
• 为大目录创建配置时建议先不开启覆盖，确认生成路径正确后再调整。