接入媒体应用

先在 运行记录 核对小目标成功，再到 设置 → 生成文件位置 找到实际输出根。STRM 只是中继地址，不是视频；生成成功还不表示下游能扫描或播放。

选对目录

目标应用	生成结构
短了个剧	drama/{作品}/tvshow.nfo 和 S01E01.strm…
VR 播放器	3dvr/{作品}/{视频名}.strm
有声书	audiobook/{作品}/001_{章节}.strm…

短剧和有声书按文件名升序编号；先用小目录确认顺序。下游只读共享输出的对应类型目录，不共享含账号和 Cookie 的应用数据。

Docker 中 /media 是网盘流容器路径，不自动等于 VR/短剧/有声书容器的路径。需要部署维护者把同一宿主输出目录只读挂进下游，再使用其容器内路径；fnOS 也须授予下游应用读取权限。

扫描之前先确认访问身份

普通中继 URL 要求有效网盘流应用会话；飞牛系统头、另一个应用登录或浏览器曾登录管理页，都不代表下游服务有该会话。下游服务器在扫描时就可能需要探测媒体，并不一定等到按播放才访问。

独立服务和播放器通常不带网盘流会话，应先由管理员按播放授权启用内网专用通道、为目标 确认并更新 STRM。等专用地址写好，再让下游扫描。不要把管理员密码、Cookie 交给播放器，不关闭身份校验来消除 401。

网盘流软件许可也必须有效，专用播放凭据不会绕过许可门禁。两应用的账号及软件授权独立。

以 VR 播放器为例

1. 在网盘流选 VR 播放器 目标类型完成同步，再确认需要的专用播放授权。
2. 核对下游能只读访问 输出根/3dvr，网盘流的专用 IP/端口也能被 VR 后端和实际播放设备访问。
3. 在 VR 的应用管理员账号下，进入 系统设置 → 储存库 → 添加来源 → STRM 目录，填写 VR 实际可读路径，点 添加 后 运行任务。
4. 在 VR 来源行核对入库数量。探测失败时看文件名和实际原因；不能把“已保存来源”当作已经入库。
5. 在 VR 资源库打开一段视频，按下面的播放检查确认结果。

这是两应用当前界面的操作路径；较旧版本若入口不同，先核对各自的版本说明，不因为文档有步骤就推断旧包已包含该能力。

验证播放链路

1. 确认实际目标生成了预期数量的 STRM，下游作品、剧集/章节或视频数量与排序正确。
2. 从真正使用的设备启动播放，检查画面/声音、拖动进度和重新打开。
3. 稍后再次播放；若要核对直链更新，可在超过 1 小时缓存期后重新打开。一次播放成功不代表所有编码/设备均兼容。

播放先请求本服务，换取 115 直链后重定向；媒体由播放器直连 115 CDN。NAS 不转发媒体正文，也不承诺零延迟。中继阶段失败看网盘流，已转向 CDN 后的持续卡顿还需检查播放器到上游的网络。

常见未成功结果

• 下游无作品：核对只读挂载、扫描目录和下游扫描失败详情。
• 401：确认使用的是已写入专用播放地址的 STRM；旧地址可能仍在下游缓存，需要重新扫描。
• 播放资源不可用：核对通道状态、目标授权和软件许可；撤销/地址变更后按播放授权处理。
• 缓存的旧地址：服务地址或专用 IP/端口改变后，先重新同步/轮换授权，再让下游重新扫描。

旧版本曾把 VR 文件直接放在 3dvr/，当前每个目标有独立子目录。旧扁平文件不会自动清理，先备份并核对下游引用，确认不再需要后由维护者处理，不按标题前缀批量删除。