绿联NAS网络文件夹挂载
路径：先在绿联云客户端完成网络文件夹设置，再到 存储管理 → 云盘管理 → 存储类型 → 添加存储 → 绿联NAS网络文件夹挂载。
绿联 NAS 用户接入网盘媒体，推荐用这种方式。 网盘由 NAS 自己挂载，Mediora 通过 NAS 文件系统读取文件，文件管理无需在 Mediora 中再次填写网盘凭据。实际读写仍依赖 NAS 与网盘的网络、账号授权和上游限制，不能按本地磁盘速度或“没有风控”来理解。
本页按三个层面展开：绿联客户端怎么设置 → Docker 怎么映射 → Mediora 里怎么添加。看不到目录时，按这个顺序逐层检查，先确认上一层能够正常读取。
开始前检查
- NAS 系统能正常打开“文件管理”，并能看到存储空间。
- 使用 NAS 上的 Linux Docker（绿联 Docker 应用），Docker Desktop 无法验证挂载传播。
- Mediora 运行身份能进入每一级目录；需要写入时，账号、挂载和业务目录都必须允许写入。
- 准备一个独立的小目录用于验证，不要直接拿唯一副本试。
同一网盘通过“115”“OpenList”或绿联NAS网络文件夹挂载接入，是不同的访问方式。绿联NAS网络文件夹挂载的文件操作通过 NAS 文件系统执行，不提供网盘原生离线下载和账号额度；可选的直链播放需另外连接 NAS 并核实当前来源能力。
配置绿联NAS网络文件夹挂载
以下步骤以绿联云 PC 客户端为例，NAS 内置网页端的菜单位置基本一致。
1. 打开文件管理
- 在电脑上启动绿联云桌面客户端，或浏览器登录 NAS 网页端。
- 进入文件管理。这里是 NAS 上所有文件和共享文件夹的入口。
2. 连接网络文件夹
- 点击文件管理顶部的 “＋”，在菜单中选择 “连接网络文件夹”。
- 在弹出的窗口里选择要接入的网盘。列表随 NAS 版本和已安装套件变化，常见的有 115、123 云盘、阿里云盘、夸克等。
- 点击下一步，按页面提示完成授权：
- 需要扫码的网盘（例如 115），用对应网盘的手机 App 扫码并在手机上点确认；
- 需要账号登录的网盘，填写账号或使用授权码；
- 等待授权完成。界面提示连接成功后，网络文件夹会出现在文件管理的列表中。
3. 确认挂载真的可用
这两步必须做，否则后面排查会跑偏：
- 在文件管理里双击打开刚连接的网盘，进入媒体目录，确认能看到实际影片文件，而不是空目录或“加载中”。
- 点击文件管理里的刷新，再关闭客户端重新打开一次，确认网盘仍然在列表中——有些授权问题只在重进界面后才暴露。
4. 确认挂载物理位置（后面要用）
网络文件夹在 NAS 文件系统里的物理位置是 /mnt/@remote，Mediora 需要把它映射进容器。这个目录是 NAS 自动生成的，不要手动创建空目录代替，映射方法见下方Docker 映射。
在 NAS 的“网盘工具”里登录账号，只是让 NAS 能访问网盘，并不会把网盘暴露成文件管理里的网络文件夹。必须在文件管理 → ＋ → 连接网络文件夹里完成授权，容器里才可能看到。
界面和授权方式会随 NAS 版本变化，可对照绿联官方连接网络文件夹说明和123 云盘挂载说明。
绿联NAS网络文件夹挂载当前可以自动发现 115、123、阿里云盘和夸克；NAS 中通过 SMB、WebDAV 等协议连进来的目录不属于这一范围，不能因为显示在“网络文件夹”中就按本页方式添加。
建议的目录安排
可以在网盘里按用途分目录，后面只选择实际需要的范围：
网盘根/
├── movie 电影
├── tv 剧集
└── downloads 临时下载（可选）
业务根就是这条存储允许处理的起点。例如选择 movie 后，任务里的 /示例电影.mkv 指的是这个电影目录下的文件。默认目录和快捷方式只影响浏览时先打开哪里，不会改变业务根。
Docker 映射
NAS 上的网络文件夹挂在 /mnt/@remote 下面。Mediora 容器必须能看到这个目录，并且能接收之后新出现的子挂载，否则新连接的网盘不会出现在容器里。
在安装页的完整配置中，取消绿联NAS网络文件夹挂载的目录映射和 UGREEN_REMOTE_ROOT 的注释即可。已有 Compose 就在 Mediora 服务的 volumes 和 environment 中分别追加一行，保留原来的数据、媒体和端口配置：
volumes:
- /mnt/@remote:/ugreen:rslave
environment:
UGREEN_REMOTE_ROOT: /ugreen
/mnt/@remote 是 NAS 上的发现目录，/ugreen 是容器里的发现目录。自定义右侧路径时，同步修改 UGREEN_REMOTE_ROOT。不要创建一个普通空目录来替代真实挂载。
使用已有 docker run 配置时，在镜像名之前追加：
--mount type=bind,source=/mnt/@remote,target=/ugreen,bind-propagation=rslave \
-e UGREEN_REMOTE_ROOT=/ugreen
修改 Compose 后执行 docker compose up -d mediora 重新创建容器。rslave 用于接收宿主机之后出现的子挂载，宿主机的上级挂载也必须支持传播。Docker Desktop 不支持这种挂载传播，不能用桌面环境的结果替代 NAS 重连验证。传播规则见 Docker 官方说明。
确认映射是否真的生效，在 NAS 终端执行：
docker inspect mediora --format '{{range .Mounts}}{{println .Source "->" .Destination "RW=" .RW "Propagation=" .Propagation}}{{end}}'
找到目标为 /ugreen 的记录：RW=true 表示这条 Docker 映射允许写入，实际能否写还要看子挂载和目录权限；Propagation=rslave 表示配置了需要的传播方式。若显示 rprivate，需修改 Compose 或命令后重新创建容器；NAS 上级挂载也必须支持传播。
运行身份仍通过 PUID、PGID 设置，数值按 NAS 实际权限选择。目录名称里出现的用户编号只是线索，不是必须照抄的运行身份；不要递归改动绿联NAS网络文件夹挂载目录的属主。
绿联界面只有“读写 / 只读”时
“读写 / 只读”控制文件访问权限，rslave 控制后续子挂载是否从 NAS 传播到容器，两者可以同时设置。选择“读写”本身不会妨碍挂载，也不会自动启用传播；实际写入还取决于 NAS 挂载、账号权限和 Mediora 的运行身份。
Docker 普通绑定默认会带入创建容器时已经存在的子挂载，所以不配置传播时，已有网盘也可能正常发现。但默认的 rprivate 不接收后续子挂载，网盘新增、断开重连后的新挂载可能无法出现在容器内。不能只用首次能访问来判断配置完整。
手动创建向导未提供传播选项时，可以在绿联 Docker → 项目中新建 Compose 项目，使用安装页的完整 Compose 配置，同时启用绿联NAS网络文件夹挂载的目录映射和 UGREEN_REMOTE_ROOT，保留原有数据等配置。项目入口见绿联官方说明。
添加与测试
回到 Mediora：存储管理 → 云盘管理 → 存储类型 → 添加存储 → 绿联NAS网络文件夹挂载。
| 字段 | 怎么填 | 关键点 |
|---|---|---|
| 配置名称 | 例如“绿联-115 电影”。 | 网盘 STRM 会记录这个名称，作为来源恢复线索。 |
| 网盘与账号 | 选择从 NAS 发现的挂载。 | 列表为空时先刷新，再依次检查 NAS 的真实挂载、Docker 映射、发现根和传播。 |
| 业务目录 | 进入目标目录后点击“选择当前目录”。 | 所选目录就是这条存储的业务根，/ 指的是它，不是 NAS 根。 |
| 读写模式 | “读写”或“只读”。 | 只读实例不能刮削回写、不能接收上传、不能做移动来源。 |
| 显示隐藏文件和文件夹 | 按需开启。 | 媒体库通常不需要；开启后可能扫到 @eaDir 之类的系统目录。 |
- 点击“添加存储”，填写配置名称。
- 在“网盘与账号”选择发现的挂载；没有显示时点击刷新，先检查 NAS 挂载和容器映射。
- 进入需要的业务目录，点击“选择当前目录”。所选目录成为这个存储的业务根。
- 选择“读写”或“只读”，按需开启“显示隐藏文件和文件夹”。
- 测试连接并保存，在文件列表检查目录。
- 读写实例先上传小文件，再下载核对；随后测试新建、重命名、复制和移动。
验证传播是否真的生效
创建容器时已存在的子挂载可能正常使用，因此还要检查新增或重连后的情况。先停止依赖该挂载的任务与播放，选择测试用连接操作，避免中断正在读写的目录：
- 在绿联云客户端里新连接一个网络文件夹（或用同一个网盘断开后重新连接）。
- 回到 Mediora 的添加存储页面，点击刷新。
- 新挂载出现在列表后，再打开测试目录确认能读取实际文件。
如果新挂载不出现，先用 docker inspect 查看传播方式，再核对 NAS 上级挂载是否支持传播、发现根是否正确，以及 NAS 是否真正完成重连；不能仅凭列表为空就认定一定是 rprivate。
一个挂载可以保存多个业务目录实例。任务里的 / 指所选业务根，不是整个 NAS 根；默认目录和快捷方式只改变打开位置，不改变业务根。
只读实例可以浏览、下载和作为读取来源，不能刮削回写、接收上传或移动来源。只读部署还应按 Docker 和 NAS 的能力限制实际子挂载写入，不能只根据父目录的 :ro 就认定所有子挂载都已只读。
可用功能与限制
| 功能 | 使用条件或限制 |
|---|---|
| 文件管理 | 浏览、新建、重命名、删除；上传文件、单文件下载、目录或多项打包下载、复制和移动。写入操作要求读写实例。 |
| 媒体整理 | 可作来源或目标；不提供硬链接。移动必须确认目标结果后才清理来源。 |
| 媒体刮削 | 目录可写才能保存 NFO 和图片；写入不明时先核实。 |
| STRM | 统一通过 Mediora 提供播放来源，媒体服务器扫描 STRM 输出目录并接入媒体代理。 |
| 媒体库分析（Pro） | 当前支持有界目录盘点和复用有效缓存，不新增媒体正文读取，不执行新的音轨、字幕等正文检查。 |
| 同步 | 支持手动、定时和轮询；不支持文件监听，不承诺可靠修改时间或随机写增量。 |
| 自动触发 | 不作为本地目录监控或本地下载器目录；需要周期处理时使用定时任务。 |
| 目录缓存 | 不走 115 / OpenList 的网盘目录缓存策略。NAS 自身缓存和同步延迟仍可能存在。 |
同一物理位置不能通过另建实例或改成“本地存储”来绕过来源与目标重叠检查。复制、移动和同步时，避免相同目录及互为上下级的目录。
STRM 播放
STRM 统一保存 Mediora 播放入口，无需选择播放方式或填写媒体服务器的视频目录映射。按媒体代理配置 Emby / Jellyfin 和代理端口；媒体服务器只需扫描 STRM 输出目录，播放时由 Mediora 读取来源影片。
默认通过 NAS 的现有挂载读取来源。NAS、Mediora 和来源挂载都需要在播放期间可用。
旧任务中的目录映射配置会在下次执行时采用 Mediora 入口。已经生成的文件不会自动改写；要转换旧 STRM，请明确选择覆盖或备份后覆盖，并先验证少量文件。删除重加存储或更换业务根，不会让旧 STRM 自动指向新位置。
可选的网盘直链播放
- 在已保存的绿联NAS网络文件夹挂载配置中打开“网盘直链”，填写 NAS 服务地址和可访问相应目录的 NAS 账号，按页面要求核实连接、设备及可见目录。
- 到“播放服务 → 媒体代理”的 Emby 实例，配置绿联NAS网络文件夹挂载的播放策略，选择实际 Emby 用户、来源和画质限制。
- 选择仅直链、准备阶段允许文件流或显式文件流。仅直链无法满足条件时停止并显示原因；需要 NAS 文件流时明确选择相应方式。
- 使用已鉴权设备限时试播，并查看播放任务是否正常结束或需要恢复。
实际是否能取得直链、可用画质和媒体格式取决于 NAS 版本、网盘来源与播放器。部分无格式信息的来源需要显式开启“允许有界格式检查”，页面会说明有限前缀读取范围；连接成功不等于所有客户端、字幕或音轨组合均已可播。
尚未解决的播放任务会保留恢复信息。修改来源目录或忘记凭据前，先在原任务中核对并完成收尾。
写入完成与异常处理
上传或复制后，系统还需要关闭文件、确认发布并回读核对。挂载可能延迟显示新文件；页面仍在“正在核实”时，先等待结果，不要马上重复上传。核对当前挂载可读内容不代表 NAS 后台已完成上传到网盘，后台同步状态仍需在绿联查看。
大文件可能需要完整回读，会增加 NAS 读取、网络流量和等待时间。单次浏览目录最多 10,000 项，超过时缩小业务目录；这不是媒体任务总量的承诺。
| 现象 | 怎样处理 |
|---|---|
| 没有可选网盘、只看到空壳目录 | 检查真实挂载、发现根、容器映射及传播。不要把空壳目录当作空网盘。 |
EACCES、只读或 EPERM | 核对 UID/GID、父目录进入权限、NAS 账号权限和子挂载状态；不要切换 root 绕过。 |
文件关闭后消失或出现 ENOENT / ENOTSUP | 检查网盘容量、文件名、零字节文件支持和 NAS 后台传输；不同挂载可能有不同限制。 |
| 挂载断开后结果待核对 | 先停止原任务、恢复原挂载，再从原记录核对。新挂载不一定能证明旧写入结果。 |
| 文件操作不能结束 | 查看原工作进程、业务根身份和核对证据是否满足要求，保留文件和提示。 |
文件管理在“文件操作记录”核对。媒体整理、刮削和同步的未决记录仍保留冲突保护，存储编辑弹窗已隐藏原核对入口，独立入口待后续提供；重新保存存储配置不会解除保护。文件管理的核实和结束操作见写入结果不明确时，不会补传、覆盖、删除来源或自动重跑。
容易搞错的地方
| 容易搞错 | 实际情况 |
|---|---|
| 在绿联“网盘工具”里登录了网盘，就以为挂载好了 | “网盘工具”登录 ≠ 网络文件夹挂载。必须在“文件管理 → ＋ → 连接网络文件夹”完成授权，容器里才看得见。 |
| 在绿联云客户端里连上了，就以为 Mediora 也能用 | 客户端能看是第一步。还要 /mnt/@remote 映射进容器、并且容器内能发现它，三步缺一步都不行。 |
自己 mkdir /mnt/@remote 建个空目录 | 这个目录由 NAS 的真实挂载提供，手动创建只会得到一个空壳，表现为“添加存储后没有任何网盘”。 |
| 在手动创建向导里选了“读写”，以为传播也开了 | “读写”只管文件权限，rslave 必须单独配置；向导里没有这个选项就改用 Compose 项目或命令。 |
| 第一次能访问就认为配置正确 | 不加传播时，创建容器时已存在的子挂载也能用；网盘新增或断线重连后才会暴露问题。 |
| 用 Docker Desktop 验证传播 | Docker Desktop 不支持这种挂载传播，结果不能代表 NAS。 |
| 通过 SMB 或 WebDAV 连进来的目录也想当本类型添加 | 自动发现只覆盖 115、123、阿里云盘和夸克；其他协议不属于本类型。 |
| 把“只读”实例放到整理任务的来源位置做移动 | 只读实例不能移动来源，也不能接收刮削回写和上传。 |
目录里路径写 / 以为是整个 NAS | / 指的是这条存储的业务根，即你在添加时选中的那个目录。 |
| 直接用 115 直连，而不是走 NAS 挂载 | 绿联NAS网络文件夹挂载由 NAS 管理网盘授权，Mediora 通过文件系统读写；它仍会受网盘账号、网络和挂载状态影响。 |
最佳实践
为什么推荐绿联 NAS 用户用这条路径：
| 对比 | 绿联NAS网络文件夹挂载 | 115 直连 |
|---|---|---|
| 账号授权在哪 | NAS 客户端里一次性完成 | Mediora 内扫码，登录状态可能失效 |
| 账号验证与限制 | 由 NAS 与网盘交互，仍可能遇到账号验证或限流 | 由 Mediora 的 115 接入处理；不推荐作为主力，未来可能停止支持 |
| 读取速度 | 受 NAS、网盘与网络影响 | 受接口响应、请求间隔、额度及网络影响 |
| 依赖什么 | NAS 常在线、挂载传播正确 | 115 接口策略保持稳定 |
| 缺什么 | 网盘原生离线下载、账号额度 | — |
第一次接入，按这个顺序验证：
- 在绿联云客户端的文件管理里打开网络文件夹，确认能看到真实文件。
docker inspect确认目标为/ugreen的映射是Propagation=rslave。- 在 Mediora 添加存储，业务根选一个小目录，测试连接并打开文件；需要写入时，再在读写实例里新建、删除一个测试文件夹。
- 暂停相关任务和播放后，在 NAS 上新增或重连一个测试用网络文件夹；回到 Mediora 刷新，确认能发现并读取实际文件。
目录规划： 在网盘里就分好 movie、tv 等目录，每类建一条存储实例，业务根指向对应目录。业务根越窄，扫描越快，误操作影响面越小。
权限： 只读观看的媒体库用只读实例；需要刮削写回时，仅给对应目录配置必要的写入权限。只读实例设置不能代替对 Docker 和 NAS 子挂载权限的检查。
自动触发： 需要周期性处理时用定时任务。这类存储不会被当作本地目录监控，修改时间也不可靠，所以同步建议先预演再执行。
NAS 常在线： 播放和任务都依赖 NAS 上的挂载，NAS 关机、睡眠或网络文件夹重连中都会失败。需要长期播放的影片，考虑用同步管理复制一份到本地。