云盘管理

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

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

选哪种来源：推荐顺序

先看影片放在哪里、你已经部署了什么服务，再选择接入方式：

你的情况	推荐来源	需要准备什么
影片已在电脑或 NAS 磁盘上	本地存储	把真实媒体目录映射到 Mediora 容器，并确认读写权限。
已经在用 OpenList 或 CloudDrive2	复用现有服务	准备 Mediora 可访问的服务地址、令牌和媒体目录。
使用绿联NAS，网盘已连接为网络文件夹	绿联NAS网络文件夹挂载	完成目录映射与挂载传播。
只能通过 115 直接接入	作为临时补充，小范围使用	不推荐作为主力，先阅读下面的使用边界。

关于 115：不推荐，且不保证长期可用

Mediora 不推荐把 115 直连作为主力存储，未来可能因接口兼容或维护条件变化停止支持。 重要媒体应保留其他可用副本。

• 115 可能要求账号验证或限制请求，表现为任务等待、登录失效或播放中断。具体以页面提示和官方客户端的账号状态为准。
• Mediora 会执行请求间隔、额度和冷却保护。出现保护性等待时应等到允许继续，不能靠反复扫码、重启或新建实例绕过。
• 接口和认证策略可能变化；当前能连接，不代表后续始终可用。更换接入方式也不能保证消除网盘侧的验证或限流。

已经使用 115 时，建议这样安排：

1. 把它作为补充观看来源，重要影片在本地或其他位置保留副本。
2. 保留默认请求间隔，按需要使用目录缓存和定时任务，避免反复扫描整库。
3. 同一账号的额度与冷却共用，不要为了增加请求额度而重复添加存储实例。
4. 出现验证提示时，先暂停引用该账号的任务，在官方客户端完成验证；冷却仍未结束时继续等待。

需要通过现有服务管理远端来源时，可考虑 CloudDrive2、绿联NAS网络文件夹挂载或 OpenList。它们仍依赖底层网盘、网络和账号权限。

三个页签分别做什么

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

推荐配置顺序

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

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

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

添加存储

点击“存储类型 → 添加存储”，先选择类型，再填写配置。可配置的来源包括本地存储、115、OpenList、CloudDrive2 和绿联NAS网络文件夹挂载。

类型	适合场景	需要填写或完成的内容
本地存储	安装 Mediora 的电脑、硬盘或 NAS 上的目录。	选择类型并填写配置名称。实际目录从 Docker 已挂载的容器路径下选择；/medias 只是安装示例，不是固定要求。
OpenList	使用已接入 OpenList 的目录。	填写配置名称、OpenList 服务地址和令牌。
绿联NAS网络文件夹挂载	绿联 NAS 用户推荐方式：网盘由 NAS 挂载，Mediora 通过 NAS 文件系统读取。	先在绿联云客户端完成“连接网络文件夹”，再按挂载指南完成容器映射与挂载传播，最后选择发现的挂载、业务目录和读写模式。
CloudDrive2	自行部署 CD2 服务聚合多个网盘，由 CD2 负责账号与挂载。	需要先在 CD2 中完成云盘挂载和令牌，再填写服务地址、文件访问令牌、允许访问的目录和播放方式。步骤见CloudDrive2 配置指南。
115	不推荐作为主力：可能遇到账号验证、限频或接口兼容变化，未来可能停止支持。	填写配置名称，选择客户端类型，扫码登录后保存；如果页面显示“115 网盘 Open”，按页面提示填写官方开放接口令牌。

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

115 的适用边界

115 只适合小范围试用或临时补充。不要用它承载整个影音库，也不要把它当作唯一副本；接口策略可能变化，相关入口可能随时下线。理由和降风险方式见上方关于 115。

所有存储都会出现的字段

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

115 的字段和操作

使用前确认

115 直连可能遇到账号验证或限频，导致任务等待或中断；请求保护不会保证账号始终可用。接口策略也可能变化，未来可能停止支持。见关于 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，需要修改文件时不能使用只读挂载。

CloudDrive2 的配置与管理

先在 CD2 里配好，再来这里填

CD2 这侧需要完成的四件事——接入云盘、建令牌、选择允许目录、验证服务可达——见CloudDrive2 配置指南。本节的字段说明假定 CD2 已经配置完成。

CD2 服务必须能从 Mediora 所在设备或容器访问。它使用自己的连接和授权，不需要将 CD2 的挂载目录伪装成本地存储。

字段	怎么填	影响
CD2 服务地址	例如 http://192.168.1.2:19798，使用实际可达的地址与端口。	决定连接哪一套 CD2 服务。
文件访问令牌	在 CD2 创建至少可列出、读取文件及核实账户的令牌；来源核实还可能需要读取云盘列表权限。	上传、搜索等功能另需相应权限。
允许访问的目录	每行一个以 / 开头的路径，相对于令牌根目录；/ 表示整个令牌范围。	文件浏览和任务仅在这些目录内运行，目录名中的空格会保留。
播放方式	选择“严格 CDN 直连”或“经 CD2 和 Mediora 中转”。	严格直连要求播放器满足上游请求头和网络条件，失败时停止；选择中转会产生 CD2 和 Mediora 的视频传输流量。
管理授权（可选）	需要管理云盘、挂载或设置时，填写同一 CD2 账户的管理令牌。	用于管理工作区，文件访问仍受上方目录和文件令牌限制。

保存并测试连接后，从存储卡片菜单打开“CD2 管理工作区”。概览可核实所选目录能力、设置变化观察范围；任务、云盘、缓存、备份、挂载、共享与令牌、运行维护等分区按实际权限提供操作。管理改动先查看预览，再确认执行。

需要在整理、刮削、STRM、同步或下载助手中使用时，直接选择这条 CloudDrive2 存储及允许目录。首次启用变化观察只建立当前基线；要处理目录里已有文件，请明确运行一次任务。远端通知不可用时会使用轮询，目录很大或额度不足时，实际发现可能延迟。

上传完成需等待产物核实；复制、移动仅收到受理回执时仍可能显示“待核实”。从原记录检查目标文件和任务结果，避免重复提交。同目录的原生复制、移动及无法满足保护条件的自动覆盖或删源会被拒绝，按具体提示调整操作。

CloudDrive2 已开放使用，套餐、底层云盘和播放器组合仍可能存在差异。先对实际目录测试连接和少量文件操作；遇到不支持的能力，保留原提示和操作记录以便定位。

浏览和管理文件

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

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

上传、下载、复制和移动

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

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

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

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

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

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

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

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

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

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

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

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

修改或删除存储前

先停止引用它的媒体任务、同步和工作流，查看是否存在待核实写入，再修改账号、业务根或删除实例。旧历史仍绑定原实例和来源身份；新建同名存储不会接管旧任务与历史。新生成的网盘 STRM 在满足严格匹配条件时可以恢复来源，旧文件也可按STRM 来源恢复检查并修复绑定；两者都不支持把变化后的业务根当作原来源。默认目录和快捷方式只决定浏览起点，不会自动修改任务保存的路径。

容易搞错的地方

容易搞错	实际情况
在存储里填宿主机的真实路径，比如 /volume1/电影	页面只认容器内路径。宿主机目录没在 Docker 里挂载，页面上就永远看不到它。
改了 Docker 挂载后执行 docker restart	重启不会增加挂载和端口，必须 docker compose up -d 或重建容器。
以为“测试连接”成功就万事大吉	连接测试只检查能不能连上；目录能不能写入要实际新建或上传一次才能确定。
把 115 当作主力存储，整库都放上面	不推荐将 115 直连作为主力；账号验证、限频或接口调整可能同时影响多个任务和播放，未来可能停止支持。
觉得“慢”是 Mediora 的 bug	先看是否显示额度或冷却等待；网络、目录规模和上游响应也会影响速度，不能一律归因于请求保护。
同一个 115 账号加两次，认为能绕开限速	同一账号的额度与冷却共用，多个实例不会变成双倍的请求额度。
删除存储以为会顺带删除网盘文件	删除的是这份访问配置；网盘里的文件不受影响，反过来重新添加也接不回旧任务。
用“只读”挂载了媒体库，之后刮削全部失败	刮削要写 NFO 和图片，目标目录必须可写，改“全部覆盖”也绕不过去。
目录缓存关掉就以为能看到最新文件	关闭缓存只是“更倾向于”重新读取，存储自身的请求间隔仍生效，必要时手动点刷新。
网盘超时后清缓存	目录缓存只影响列表读取，账号验证、限流和权限问题清缓存没用。

最佳实践

目录规划：把下载区和正式媒体库分开。 本地目录按用途挂载，网络来源尽量选择实际需要的媒体范围：

/medias      电影和剧集库      任务目标和刮削目标
/downloads   下载器写入目录    整理任务的来源
/imports     临时待整理目录    一次性整理任务的来源

来源选择：

你的情况	推荐做法
有本地磁盘或 NAS 空间	本地存储为主，远端只做补充。可减少日常读取对网盘接口的依赖；仍需做好磁盘和数据备份。
绿联 NAS 用户，影片在网盘里	用“连接网络文件夹”把网盘挂到 NAS，再按挂载指南添加为绿联NAS网络文件夹挂载。实际速度仍受网盘、NAS 网络和挂载状态影响。
有多个网盘、想统一管理	部署 CloudDrive2，由 CD2 负责账号和挂载，Mediora 只连 CD2 服务。
已经在用 OpenList	直接添加 OpenList 存储，注意令牌权限。
只有 115 可用	小范围试用，降低频率，重要影片在本地留一份，并预期它可能随时不可用。

命名： 配置名称写清来源和用途，例如“NAS 电影库”“CD2 聚合”“115 备用”，因为网盘 STRM 会记录这个名称作为来源恢复线索。

验证顺序： 添加存储 → 打开文件列表确认目录 → 读写用途在测试目录新建一个文件夹并删除 → 用少量文件试一次任务 → 再扩大范围。只读用途只需验证读取与实际播放，不必测试写入。

只读场景： 只想让 Mediora 读取、不允许改动的媒体库，本地目录可用 :ro 挂载；绿联NAS网络文件夹挂载还应选择实例“只读”并核对实际子挂载权限。需要刮削的目录另行配置写入权限。