集成

Muvyo 管理网盘里的影视资源并生成 STRM。接入后，Muvyo 发现某个网盘账号有风控迹象时，Cirvel 先停下这个账号的后台请求并放慢节奏。文件被替换或整理完成时只校验对应的几条。不用 Muvyo 时不需要任何设置，Cirvel 照常工作。

1. 1在 Muvyo 的「设置中心 → 系统配置」生成 API Key。
2. 2打开 Cirvel 管理面板左侧的「Muvyo」，填入 Muvyo 的管理地址（例如 http://192.168.1.10:7811，Cirvel 所在的主机能访问到即可）与 API Key，点「测试连接」确认，再保存。
3. 3想在网盘文件变化时立即更新，在同一页点「生成密钥」。到 Muvyo 的「设置中心 → 插件」安装并启用「Webhook 推送」，把 Cirvel 显示的接收地址、Header 名称与 Header 值照抄进去，然后回到 Cirvel 保存。

• 文件大小与 SHA-1 直接取自 Muvyo，远端校验与 STRM 改名后都不必再访问网盘。
• 「测试连接」从 Plex 里取最多 50 条 STRM 问一次 Muvyo，还没保存的地址与 API Key 也可以先测试。
• 改了 Muvyo 管理地址的协议、主机或端口后，要重新填写 API Key 才能保存。
• 取样的 STRM 都不是 Muvyo 生成的时，这些条目照常处理。如果它们其实来自 Muvyo，多半是两边挂载的媒体路径不同。
• 配好 Webhook 后，网盘文件有变化时 Cirvel 及时更新对应条目的媒体信息。

浏览器里的 Plex Web 自己放不了 HDR、杜比视界、MKV 等片源。ShimWeave 是一个 Chrome 扩展，装上之后这些 STRM 也能在浏览器里直接播放，媒体从 CDN 直达浏览器，不经过 NAS。

1. 1在管理面板左侧打开「ShimWeave」，点「前往下载」。
2. 2按发布页上的说明在 Chrome 里安装扩展。它暂未上架 Chrome 应用商店。
3. 3回到 Plex Web 播放 STRM，ShimWeave 页的「接管情况」会显示接管次数。

每位观看者在自己的浏览器里安装，服务器不需要设置。扩展拿不到 Plex 的登录令牌，播放地址只经过 Cirvel。

没装扩展的浏览器遇到放不了的 STRM 时，Plex Web 默认只报网络错误。「未安装扩展时提示安装」打开时改为提示安装扩展并给出下载位置，不想显示时在 ShimWeave 页关闭。装了扩展的浏览器，以及勾进「局域网交给 Plex 播放」的 Plex Web 都不会看到提示。提示需要 ShimWeave 0.0.2 或更新的版本，更早的版本装了也会看到提示。

ShimWeave 播放 STRM 时，外挂 SRT 字幕由扩展自己显示，播放中可以选择、切换或关闭，稍作缓冲后从原来的位置继续。这需要 ShimWeave 0.0.5 或更新的版本。ASS 等其它格式的外挂字幕暂时不能显示，选中时会给出提示。

STRM 里写的是挂载路径时，OpenList 可以按网盘路径给出直链，客户端直连网盘播放，不占用 NAS 上行。免费版与 Pro 都支持。STRM 里写的本来就是 OpenList 的 http 地址的，不需要这一节的设置，Cirvel 直接跟随跳转。

1. 1在 OpenList 里确认 STRM 所在的网盘已经添加为存储，记下它的挂载路径，例如 /115。
2. 2在 Cirvel 管理面板「STRM 分析」页的设置里找到「本机路径 STRM」，「跳转服务地址」填 OpenList 的地址加 /d、挂载路径与 {path}，例如 http://192.168.1.10:5244/d/115{path}。填 Cirvel 所在的主机能访问到的局域网地址即可，客户端只拿到网盘的直链。
3. 3OpenList 默认给直链签名。在 OpenList 后台「设置 → 其他」复制「令牌」，填进同一组设置的「OpenList 令牌」，Cirvel 自动给请求签名。
4. 4「挂载路径前缀」填 STRM 里路径开头、OpenList 里没有的那一段，例如 /CloudNAS/115。它是 STRM 内容里的路径，不是 STRM 文件所在的目录，也不必在 Cirvel 容器里存在。留空时 Cirvel 第一次播放时自动识别。
5. 5保存后播放一条这样的 STRM，同一组设置末尾的「识别结果」显示交给 OpenList 前去掉的部分。

按上面的例子，播放 /CloudNAS/115/电影/示例.mkv 时，Cirvel 去掉 /CloudNAS/115，请求 OpenList 上的 /d/115/电影/示例.mkv。

• 不想填令牌时，在 OpenList 的「设置 → 全局」关闭「签名所有」，存储里单独打开了「启用签名」的也一并关闭，效果相同。
• STRM 里本来就写 OpenList 的 http 地址时，签名由生成 STRM 的工具带上，或者按上一条关闭签名。
• 存储打开「Web 代理」时由 OpenList 自己传出数据，在外播放仍占用 NAS 上行。想让客户端直连网盘，保持关闭。
• OpenList 拒绝访问时，「识别结果」会提示，这期间这些 STRM 由 NAS 读取挂载传出。改好 OpenList 的设置或填好令牌后重新播放即可，Cirvel 会按新设置重新去问。

能按网盘路径跳转到直链的服务都可以填进「本机路径 STRM」的「跳转服务地址」，网盘路径的位置写 {path}，「挂载路径前缀」的填法与上文的「OpenList」相同。已接入 Muvyo 时留空即可，由 Muvyo 跳转。

• {path} 写在 ? 后面时整条路径按查询参数编码，例如 http://192.168.1.10:8080/redirect?path={path}。写在路径里时逐段编码。
• 跳转服务先跳到另一个局域网地址时，Cirvel 继续跟着跳，客户端只拿到最终的网盘地址。
• 跳转服务自己传出数据、不跳转时，由 Cirvel 经 NAS 转给客户端，在外播放占用 NAS 上行。
• 没有跳转服务，或跳转服务找不到文件时，由 NAS 读取挂载传出。这时需要把挂载目录也映射进 Cirvel 容器，挂载不在媒体库文件夹里时再填进「NAS 可读取的挂载目录」，见「播放」一章的「挂载路径的 STRM」。