跳到正文

同步目标与运行记录 ​

同步目标把 115 网盘的一个目录转换成下游应用可扫描的 STRM 目录。本章覆盖服务地址、创建/重新同步/删除目标,以及运行记录。

保存播放服务地址 ​

在 设置 → 播放服务地址 输入下游播放器能够访问的地址,再点击 保存地址。地址通过后端保存,刷新或重启后继续有效。

使用飞牛网关时应保留应用前缀,例如(端口与应用前缀以你的实际部署为准,可从浏览器地址栏复制):

text
https://你的NAS地址:端口/app/leelaa-strm

地址填应用入口本身,只接受 HTTP 或 HTTPS,不要携带账号密码或查询参数,也不要包含任何接口路径。不要填写只有 NAS 本机能访问的 127.0.0.1。播放经过飞牛网关时,播放器还需要具有有效的访问身份;能在浏览器打开管理页,不代表所有独立播放器都能自动继承登录态。

修改地址后,重新同步目标,才能更新已有 STRM 中的中继地址。 原文件中的地址不会因修改设置自动变化。

未保存服务地址时无法创建或重新同步目标。

创建目标 ​

  1. 先在 应用授权 取得有效试用/许可,再保存 115 凭据和播放服务地址(同步目标 会提示缺少的设置)。
  2. 在 云端目录 找到作品所在目录并点击 使用此目录,或在 同步目标 → 新建目标 中直接输入数字 CID。
  3. 选择目标应用:短了个剧(短剧)、VR 播放器(3DVR)或有声书;填写作品标题。
  4. 点击 创建并同步,等待返回实际结果。只读/普通成员没有创建入口。
  5. 在 运行记录 核对成功/失败、文件数与说明,再到 设置 → 生成文件位置 检查生成的对应目录;下一步见下游扫描与播放。成功文件数不代表下游已入库。

新建同步目标表单,包含目标应用、作品标题和 115 目录 CID

界面示例(示例数据):选择应用、填写标题和自己的目录 CID,再创建并同步;不要照抄示例 CID。

同步规则 ​

  • 只处理所选目录当前层内的媒体文件,不递归子目录;需要按子目录分别创建目标。
  • 单次同步最多 500 项(文件和子目录合计)。超过上限会明确拒绝且不写入任何输出,请先在网盘拆分目录。
  • 只识别媒体扩展名。视频:mp4、m4v、mov、ts、mkv、webm、flv、avi;音频(有声书):mp3、m4a、m4b、flac、wav、ogg、opus。其他文件被忽略。
  • 文件按文件名排序编号:短剧生成 drama/{标题}/S01E01.strm… 和 tvshow.nfo;有声书生成 audiobook/{标题}/001_{章节名}.strm…;3DVR 生成 3dvr/{标题}/{视频名}.strm。3DVR 目录内出现仅大小写不同的重名视频会被拒绝。
  • 标题会成为文件夹名,不能包含 /、\、..、以点开头,最长 200 字节;中文标题建议控制在约 60 字以内。

同一类型和标题对应一个目标;对同名目标再次创建会更新其目录 CID 并重新同步。创建或同步过程中不要重复提交;请求超时后先刷新目标和运行记录,核对是否已经完成——关闭页面或超时不会取消后台同步。

重新同步与删除 ​

网盘新增文件、服务地址变化或需要重新生成目录时,使用目标行的 重新同步。成功计数仅表示生成文件写入完成,不表示下游已扫描或播放成功。

点击删除后需再次确认。删除会清理该目标的生成目录及目标记录,不会删除 115 网盘原文件。需要保留输出时,先备份再操作。

同一时间只允许一个同步或删除操作,进行中时会提示「另一项同步或删除正在进行」;等运行记录出现终态后再操作。

生成结果的保护 ​

重新同步会先在暂存目录生成完整新输出,再整体替换该目标目录;新文件生成失败时保留原输出;若提示已切换输出但备份清理/恢复失败,保留现场核对,不把失败一概当作没有文件变化。每个目标目录带有精确的文件清单(含内容摘要),用于防止误删:

  • 目标内新增了手工文件(包括手工放置的 .strm)、原生成文件被编辑或清单缺失时,替换和删除都会被拒绝。
  • 不同目标互不清理;旧版本扁平的 VR 文件也不会自动删除。
  • 115 返回的目录数据不完整时按失败处理,不会把不完整结果当成完整目录清空原输出。

中断与恢复 ​

服务重启后,上次未完成的同步在运行记录中显示 已中断,需要核对输出后重新同步。

若输出根目录出现 .backup- 备份或 .sync- 暂存目录:

  1. 停止应用,保留现场,不要直接删除。
  2. 核对当前目标目录、备份目录内容和最近的运行记录。
  3. 确认无误后人工恢复或移走,再启动应用。存在未处理的备份目录时,后续同步和删除会被拒绝,这是防误删的保护。

旧版本生成的目录不受当前版本管理,升级后不会被自动认领或删除。请停服备份,核对旧目录后移到输出根目录以外,再对目标重新同步。

运行记录 ​

运行记录 页面按时间倒序显示最近 50 条同步记录:目标、状态(成功/失败/进行中/已中断)、写入的文件数(成功数/总数)、时间和失败说明。目标行的状态摘要对应其最近一次运行。

  • 失败 记录保留具体原因(如 Cookie 失效、超上限、目录含异常文件),处理方法见故障排查。
  • 已中断 表示服务重启打断了同步;核对输出后重新同步即可。
  • 记录只用于核对,不支持从记录页重试;重试请用目标行的 重新同步。