跳到主要内容

CloudDrive2 配置指南

路径：存储管理 → 云盘管理 → 存储类型 → 添加存储 → CloudDrive2。

CloudDrive2（下文简称 CD2）可以统一管理已连接的网盘。Mediora 通过 CD2 的服务地址和令牌访问文件；网盘授权在 CD2 中完成。实际可用能力仍取决于 CD2 版本、套餐、令牌权限、底层网盘和网络，不能把这种接入方式理解为没有账号验证或限流。

推荐顺序：CD2 中接入网盘 → 准备专用令牌 → 确认服务地址 → 在 Mediora 添加存储 → 小目录验证 → 创建任务和测试播放。

第一步：在 CloudDrive2 中准备媒体目录​

  1. 按 CD2 自身的安装说明部署并启动服务，长期保留它的配置目录。
  2. 在 CD2 中添加需要的网盘，按当前版本界面完成登录或授权。
  3. 在 CD2 的文件列表中打开目标媒体目录，确认能看到实际影片文件。
  4. 记下这次准备提供给 Mediora 的目录范围，例如电影和剧集目录。

选择 Mediora 的 CloudDrive2 存储类型时，不需要把 CD2 的本地挂载目录再映射给 Mediora。 这里通过服务接口访问，与把 CD2 的 FUSE 挂载当作“本地存储”读取是两套配置。只有你另外需要本地 STRM 输出时，才按安装指南挂载相应输出目录。

CD2 容器的配置、缓存、日志和网盘文件是不同内容。请按 CD2 自身要求准备空间；本页不要求改变已有 CD2 挂载点或移动媒体文件。

第二步：准备文件访问令牌​

Mediora 需要 CD2 生成的令牌，不使用 CD2 的登录密码。

  1. 在 CD2 的令牌管理中，为 Mediora 准备专用令牌。
  2. 按实际用途选择权限：日常读取需要列目录、读取文件，以及连接验证所需的账户核实权限；来源核实还可能需要读取云盘列表。
  3. 需要整理写入、上传、移动或删除时，再提供相应写入权限。只读令牌不能执行写入操作。
  4. CD2 的云盘、挂载、共享和令牌在 CD2 自身界面管理；Mediora 只填写文件访问令牌，不需要另填管理令牌。

令牌应保存在你使用的密码管理器或其他可靠位置，不要放到公开截图和配置示例中。怀疑泄露时，到 CD2 撤销对应令牌，再更新 Mediora 的存储配置。

第三步：填写 Mediora 能访问的服务地址​

自己的浏览器能打开 CD2，只能证明浏览器所在设备能够连接；Mediora 所在容器还需要能访问同一个服务。

部署情况地址示例前提
Mediora 和 CD2 在同一个 Docker 网络http://clouddrive2:19798clouddrive2 是该网络中实际可解析的服务名。
两个容器不在同一个网络http://192.168.1.2:19798使用 NAS 实际内网地址和已映射的宿主机端口。
CD2 在另一台设备http://那台设备的内网IP:实际端口Mediora 所在设备能够访问这台设备。

19798 是示例，以你实际部署的端口为准。容器中的 localhost 或 127.0.0.1 指向容器自身，只有 CD2 确实在同一网络环境中时才适用。不要把媒体目录、令牌、账号密码、查询参数或网页片段填进服务地址。

填完后用 Mediora 的“测试连接”验证。失败时先看具体提示：连接拒绝或超时查地址、端口和网络；认证或权限错误则检查令牌，不能一律按网络问题处理。

第四步：添加存储并选择允许目录​

在 Mediora 添加 CloudDrive2 存储：

字段怎样填写
配置名称例如“CD2 电影”。名称也会作为新生成网盘 STRM 的来源恢复线索。
CD2 服务地址填写上一步确认的地址。
文件访问令牌填写为 Mediora 准备的专用令牌。
允许访问的目录每行一个以 / 开头的路径，相对于令牌根目录，只包含实际需要处理的媒体目录。
播放方式根据下方说明选择严格直连或中转，并用实际播放器测试。

目录填写示例​

假设 CD2 令牌的根目录中有 movie、tv 和 documents，只准备让 Mediora 处理前两个目录：

配置名称        CD2 媒体
CD2 服务地址    http://192.168.1.2:19798
允许访问的目录  /movie
                /tv

这些是 CD2 令牌范围中的路径，不是 NAS 宿主机路径，也不是 Mediora 容器的 /medias。/ 表示整个令牌范围：令牌已经限定为单个媒体目录时，允许目录填 / 可以表示该目录；令牌范围很大时，优先收窄到需要的子目录。

“允许访问的目录”会约束文件浏览和任务范围。改 CD2 的目录结构、令牌根或 Mediora 允许目录后，要重新测试，并检查原有任务和 STRM 是否仍能找到来源。

播放方式怎么选​

方式视频怎么传输需要注意
严格 CDN 直连尝试让播放器读取上游直链，视频主体不由 Mediora 中转。播放器需满足上游请求头和网络条件；条件不满足时停止，不自动切换为中转。
经 CD2 和 Mediora 中转视频经过 CD2 和 Mediora，增加相应的传输流量。仍需 CD2 能读取来源、网络可达，并满足实际播放器的格式要求；不是所有文件都能因此播放。

第一次可先用中转方式验证基础读取和播放，再单独测试严格直连。如果准备长期使用严格直连，要在实际使用的电视、手机等客户端分别试播，而不只在浏览器测试。

第五步：小范围验证后再扩大使用​

  1. 测试连接并保存。 连接成功后仍需确认存储已经保存。
  2. 浏览文件。 打开允许目录，确认目录和影片与 CD2 中看到的一致。
  3. 按用途验证权限。 只读用途测试读取；写入用途在专门的测试目录新建、重命名并删除一个测试文件夹，再测试少量复制。
  4. 验证一个任务。 先选 1–3 个影片生成 STRM 或运行媒体处理，检查任务历史与目标文件。
  5. 验证实际播放。 按媒体代理配置，检查开始播放、拖动进度及结束后的任务状态。

一个测试文件能读写，不代表所有云盘和目录都有相同权限。更换网盘、令牌或播放方式后，应重新做对应验证。

可选：目录变化观察​

保存并测试连接后，从存储卡片进入“文件列表”浏览和操作文件。1.1.1 不再提供独立“CD2 管理工作区”；云盘、缓存、备份、挂载、共享与令牌等管理操作使用 CD2 自身界面。

变化观察用于发现目录后续变化。首次启用只建立当前目录基线，不会自动处理目录里已有的所有影片。 已有媒体应先明确运行一次对应任务；后续变化是否触发处理，还取决于媒体任务或工作流的配置。

远端通知不可用时会使用轮询；目录规模、请求预算和 CD2 缓存都可能影响发现时间。不要因为新文件暂未出现就反复创建任务，先检查变化观察状态和文件列表。

常见现象怎么处理​

现象先检查什么
连接被拒绝或超时服务地址、宿主机映射端口、两个容器的网络和防火墙。
认证或权限错误文件访问令牌是否有效，是否具备提示中要求的权限。
能连接但看不到目标目录令牌根目录、允许目录和 CD2 中实际存在的路径是否一致。
能看到影片但打不开CD2 是否仍能读取来源、网盘授权是否有效，以及令牌的读取权限。
严格直连播放失败查看上游请求头、播放器和网络条件；需要尝试中转时明确修改播放方式后再试。
文件操作显示“待核实”到原操作记录查看远端任务和目标文件；收到受理回执不等于写入已完成，不重复提交。
改了目录后旧任务或 STRM 失效重新核对任务路径与来源绑定，改目录不会自动重写旧文件。

详细的写入异常处理见任务运行与结果核对。

日常使用建议​

  • 按用途设置允许目录；观看可用只读令牌，需要写入时再补所需权限。
  • 来源与目标分开，避免同一物理位置或互为上下级；名称不同不代表它们是不同位置。
  • 第一次手动处理一个小目录，确认路径、规则与播放结果，再开启自动触发或定时任务。
  • CD2 或网盘授权发生变化后，先查看正在执行的操作和未核实结果，再调整 Mediora 配置。
  • CD2、NAS 或网盘不可用时，相关任务和播放可能等待或失败。重要媒体另外保留可用副本。