跳到主要内容

云盘管理

路径：存储管理 → 云盘管理。

这里是所有文件功能的起点。媒体整理、刮削、STRM、同步和下载助手都会从这里选择文件所在的位置。先添加存储并验证目录，再创建任务；不同类型不一定支持同样的写入、监听和下载能力。

三个页签分别做什么​

页签用途
存储类型添加、测试、编辑和排序存储实例。
文件列表浏览实际文件，建立文件夹、重命名、删除，并保存常用目录快捷方式。
目录缓存调整某个网盘目录多久重新读取一次。

推荐配置顺序​

第一次进入时，建议按这个顺序操作：

  1. 先添加存储实例，只填写一个你准备马上使用的位置。
  2. 点击“测试连接”，或直接进入“文件列表”确认能打开目标目录。
  3. 给常用目录设置默认显示目录和快捷方式，减少以后反复定位。
  4. 需要远端网盘时，再到“目录缓存”调整读取频率；不要为了追求速度把请求间隔设得过低。

一条存储配置只代表一个可访问的位置。任务中选择的“来源存储”和“目标存储”会绑定到具体实例，不是只按名称或目录字符串判断。

添加存储​

点击“存储类型 → 添加存储”，先选择类型，再填写配置。添加入口提供本地存储、115 和 OpenList。

类型适合场景需要填写或完成的内容
本地存储安装 Mediora 的电脑、硬盘或 NAS 上的目录。选择类型并填写配置名称。实际目录从 Docker 已挂载的容器路径下选择；/medias 只是安装示例，不是固定要求。
115使用 115 网盘中的媒体或下载目录。填写配置名称，选择客户端类型，扫码登录后保存；如果页面显示“115 网盘 Open”，按页面提示填写官方开放接口令牌。
OpenList使用已接入 OpenList 的目录。填写配置名称、OpenList 服务地址和令牌。

页面中如果出现其他已保存的历史类型，请先确认该类型的当前适配器和权限，不要把源码中存在的驱动当作已开放并验收的新增入口。

所有存储都会出现的字段​

字段怎么填影响
存储类型新建时选择；保存后不能改类型。决定后续显示哪些连接字段和可用能力。选错时请新建正确的存储。
配置名称用能辨认的名称，例如“NAS 电影库”“115 主账号”。只在 Mediora 页面中显示，方便后续任务选择。
请求间隔（毫秒）使用网盘 API 的类型显示；保留默认值即可。本地存储不使用这个字段。控制该远端存储连续请求的最短间隔，仍受账号保护下限、额度和冷却约束；调低不会绕过保护。

115 的字段和操作​

项目怎么用影响
客户端类型选择你用于扫码的 115 客户端类型。决定本次扫码登录方式；登录失效时可在编辑页重新扫码。
获取二维码 / 扫码登录在手机 115 中完成扫码并确认。登录成功后，Mediora 才能读取该账号可访问的目录。
测试连接保存前或编辑时点击。只检查当前连接是否可用，不会修改网盘文件。

115 扫码配置和“115 网盘 Open”是两种授权方式：前者在页面内扫码，后者需要官方开放接口的访问令牌和刷新令牌。不要把扫码登录得到的内容粘贴到 Open 表单中；如果当前版本没有给出对应字段，就使用页面提供的扫码入口。

115 提示需要验证或冷却​

账号要求验证时，先在 115 官方客户端完成验证，再回到该存储点击“测试连接”确认恢复。反复扫码、重启 Mediora 或删除重加存储不会清除账号阻断。已有的限频冷却也不会因为连接测试成功而提前结束。

同一账号的请求会共同受保护，建立多个存储实例不等于得到多份独立额度。任务显示等待时，查看具体原因；账号验证、配额耗尽和临时限频需要分别处理，不能一律按网络故障重试。

OpenList 的字段​

字段怎么填影响
服务地址填写 OpenList 的完整访问地址，包含端口，例如 http://192.168.1.100:5244。地址错误时无法浏览或处理该存储。
令牌填写在 OpenList 中获取的令牌。令牌需要具备浏览、上传、新建目录、重命名、复制、移动和删除权限，才能使用全部文件功能。
测试连接填完后点击。可在保存前发现地址、令牌或权限问题。

本地存储只能看到 Docker 里已经挂载的目录。比如把宿主机媒体库挂载为 /medias，页面中就选择 /medias/电影；如果把它挂载为 /library，页面中就选择 /library/电影。页面里填写的是容器内路径，不是安装机器上的原始绝对路径。

如果要读取下载目录或其他本地目录，也要先在安装时增加对应挂载，然后再在这里选择挂载后的容器路径。未挂载的宿主机目录不会出现在文件选择器中。

目录能显示但打不开时，通常是容器对某一级父目录缺少读取或进入权限；浏览正常但新建、重命名、刮削或同步失败时，则要检查目标目录是否允许容器写入。只读媒体库可在 Docker 挂载后加 :ro，需要修改文件时不能使用只读挂载。

浏览和管理文件​

在“文件列表”中选择一个存储后，可以：

  • 浏览目录，进入文件夹或返回上级目录；
  • 新建文件夹、重命名或删除；
  • 把当前目录加入快捷方式，方便以后直接打开；
  • 点击刷新，重新读取当前目录。

上传、下载、复制和移动​

当前分支的文件列表还提供以下操作，实际可用项受所选存储能力和权限约束：

操作怎样使用需要注意
上传文件本地读写实例点击“上传文件”，或将文件拖入上传区域。上传的是文件，目录请通过复制或移动处理；默认遇到同名文件停止上传，也可明确选择覆盖。
下载 / 打包下载选择一个文件点击下载；多项或目录使用打包下载。浏览器下载完成后再检查结果，只有部分 ZIP 内容不能视为完整备份。
复制到选择文件或目录，再选目标存储和目录。目录包含全部子项；默认保留已有文件并跳过同名项。
移动到核对来源、目标及覆盖选项，点击“确认并排队”。目标完整核实后才删除来源，异常时可能保留两端文件或待核对记录。

“选择当前页”最多选择 1,000 项，不代表所有目录页都已选中。切换目录前先核对选择范围。来源和目标不能指向相同物理位置或互为上下级的范围，即使它们使用不同存储名称。

点击提交后，在“文件操作记录”查看排队、执行、核实和清理来源等阶段，并打开逐项结果。上传字节全部送达后，发布和核实仍可能继续。停止操作只阻止后续工作，不撤回已写入的文件。

遇到“结果待核对”，使用原记录的“核对实际文件”，证据充分后再“结束并保留文件”。该操作保留现有文件，不继续传输或删除来源，详见异常结果核对。

如果卡片显示连接异常，先重新测试或编辑该存储，再继续运行整理、刮削、同步等任务。任务已经在运行时不要同时从 OpenList、115 或其他文件工具修改同一批文件，否则任务看到的目录可能和实际目录不一致。

新建、重命名和删除会直接作用于真实文件或网盘文件。操作前请先核对页面顶部的存储名称和当前目录；删除后不能由 Mediora 自动恢复。

目录缓存：让网盘读取更合适​

本节适用于网盘 API / OpenList 的目录读取，不适用于本地存储。清缓存不会修复权限、账号验证或 NAS 挂载故障。

在“目录缓存”中先选择一个已配置的网盘存储，再调整以下字段：

字段选择后会怎样
启用目录缓存开启后，近期打开过的目录会暂时复用读取结果，列表打开更快、网盘请求更少；关闭后每次更倾向于重新读取。关闭不会绕过该存储的请求间隔。
读取策略：实时优先约 10 秒内优先复用，最长约 3 分钟；适合经常在其他工具中改动目录。
读取策略：均衡约 1 分钟内优先复用，最长约 15 分钟；适合大多数日常使用。
读取策略：省请求约 5 分钟内优先复用，最长约 1 小时；适合目录很大或希望尽量少访问网盘时。
清理目录缓存立刻丢弃已保存的目录读取结果。

改为“省请求”后，外部刚改过的文件可能不会立刻出现在列表中；需要即时确认时可点击刷新或清理目录缓存。定时任务也会参考这套读取策略，以减少重复扫描。

修改或删除存储前​

先停止引用它的媒体任务、同步和工作流，查看是否存在待核实写入，再修改账号、业务根或删除实例。旧历史与 STRM 绑定原实例和来源身份；新建一个同名存储不会自动接管旧记录。默认目录和快捷方式只决定浏览起点，不会自动修改任务保存的路径。