123 网盘 STRM 生成

123 网盘 STRM 生成用于扫描 123 云盘目录，在本地输出 Emby 可扫描的 .strm 文件。它支持全量、增量、定时任务、路径 STRM、Redirect STRM 和 CloudDrive2 事件增量。

如果生成的是 http 的 strm 也就是Redirect模式，别忘记到服务设置选择 api 使用账号，此处用于 emby 扫库等 api 请求，如果生成的是路径格式的 strm 可以无视，路径格式的 strm 需要添加前缀，例如/CloudNAS/CloudDrive/123云盘 并且 emby 需要添加 cd2 或是 rclone 挂载路径，目的是确保 emby 能访问到这个路径文件用于扫库获取媒体信息等

前置条件

条件	说明
123 助手	至少有一个可用 123 配置
Token	123 助手需要维护有效 Token
123 API	Redirect STRM 播放需要启用 123 API
本地输出目录	Docker 映射到容器内，例如 /strm
可选 CD2 助手	路径 STRM、元数据下载、实时增量建议配置

配置结构

123 STRM 和 115 网盘 STRM 类似，每个路径任务独立保存。

123 网盘 STRM
├── 账号配置 / 分组
│   └── 默认参数
└── 路径任务
    ├── 123 网盘路径
    ├── 本地输出路径
    ├── STRM 内容格式
    ├── 元数据与清理
    ├── 实时监控
    └── 定时任务

服务设置

设置	说明	示例
使用 123 配置	从哪个 123 助手账号扫描	123主账号
网盘路径	123 云盘目录	/电影、/剧集
本地路径	生成 STRM 的目录	/strm/123
STRM 内容	Redirect STRM 或 路径 STRM	redirect、path
STRM 请求头	Redirect STRM 写入的 NanShare 地址	http://172.17.0.1:8115
STRM 路径前缀	路径 STRM 的前缀	/mnt/cd2/123
CD2 中的网盘名/挂载路径	CD2 事件和元数据下载定位	/123网盘

Redirect STRM

123 Redirect STRM 内容格式：

http://172.17.0.1:8115/api/?redirect123&<size>&<md5>&<s3_key_flag>[&name]

示例：

http://192.168.1.10:8115/api/?redirect123&1073741824&abc123md5hash&s3keyflag&Movie.mkv
http://192.168.1.10:8115/api/?redirect123&1073741824&abc123md5hash&s3keyflag

参数	来源	说明
size	123 文件信息	文件大小，必须是整数
md5	123 文件信息	Etag / MD5
s3_key_flag	123 文件信息	文件定位标记
name	文件名	可选，便于日志识别

播放时 NanShare 会读取 123 API 配置中的账号，调用 123 后端获取下载链接，并按配置缓存。

路径 STRM

路径 STRM 写入可被 Emby 助手路径替换命中的路径：

/mnt/cd2/123/电影/流浪地球2/The.Wandering.Earth.II.mkv

示例配置：

网盘路径：/电影
本地路径：/strm/123/电影
STRM 路径前缀：/mnt/cd2/123

Emby 助手路径替换：

/mnt/cd2/123 => 123主账号

路径 STRM 适合：

• 需要 CloudDrive2 Webhook 实时创建和删除 STRM。
• 不想在 STRM 文件里写 API URL。
• 希望 Emby 侧路径更接近挂载盘路径。

文件后缀与元数据

设置	说明
视频扩展名	命中后生成 .strm
元数据扩展名	字幕、NFO、图片等可下载到本地
下载元数据	开启后处理元数据文件
清理无效元数据	云端不存在时可删除本地元数据
校验元数据	校验大小是否一致；目录树来源时会关闭部分校验

示例：

视频后缀：mp4,mkv,ts,iso
元数据后缀：srt,ass,ssa,nfo,jpg,png,webp

实时增量

123 STRM 支持通过 CloudDrive2 事件实时增量。前端会要求实时监控配合路径 STRM 使用。

流程：

CloudDrive2 文件变化 -> NanShare 接收事件 -> 命中 123 STRM 路径任务 -> 生成或删除本地 STRM / 元数据

配置要点：

• STRM 内容 选择路径 STRM。
• 开启实时监控。
• 填写 CD2 中的网盘名/挂载路径。
• Emby 助手配置对应路径替换。

定时任务

每个路径任务可以单独定时。

30 1 * * *      # 每天 01:30
0 */4 * * *     # 每 4 小时
0 3 * * 0       # 每周日 03:00

同步模式：

模式	说明
增量	只处理新增和变化，适合日常维护
全量	重新扫描完整目录，适合初次生成或规则大改

清理与校验

开关	说明
清理无效 STRM	云端媒体不存在时删除本地 STRM
清理无效元数据	云端元数据不存在时删除本地文件
清理无效文件夹	清理空目录或无有效内容目录
校验 STRM	对 Redirect 或路径内容进行一致性检查
校验元数据	校验元数据大小

路径格式会校验 STRM 内容是否匹配当前路径前缀；Redirect 格式会校验 API URL 参数是否符合当前文件信息。

Emby 刷新

123 STRM 任务可在生成后刷新 Emby。

设置	说明
启用 Emby 刷新	任务完成后触发刷新
Emby 配置	要刷新哪个 Emby
路径替换	本地路径映射到 Emby 媒体库路径
刷新延迟	等待文件写入稳定

示例：

/strm/123 => /media/123
/vol1/1000/strm/123 => /strm/123

123 API 与缓存

Redirect STRM 播放前需要在 123 API 中启用：

启用 123 API：开启
使用 123 配置：123主账号
缓存时间：10 秒

缓存键会包含账号、MD5、文件大小、s3 key flag 和 User-Agent。相同客户端短时间重复播放会直接返回缓存直链，减少 123 请求。

常见问题

播放提示 123 API 未启用

Redirect STRM 必须启用 123 API。路径 STRM 则由 Emby 助手路径替换到 123 配置，不走 redirect123。

参数不完整

redirect123 必须包含 size、md5、s3 key flag：

错误：/api/?redirect123&1073741824&abc123
正确：/api/?redirect123&1073741824&abc123&s3keyflag&Movie.mkv

Token 失效

回到 123 助手 更新或重新获取 Token。STRM 文件本身不需要重建，除非文件移动或文件信息变化。

实时增量没有生效

检查：

• 是否选择路径 STRM。
• 是否开启实时监控。
• CD2 挂载路径是否能和事件路径对应。
• 本地输出路径是否存在且容器可写。