群晖挂载115网盘后刮削失败常见原因？

Question

群晖挂载115网盘后刮削失败，常见原因在于路径映射错误或权限配置不当。由于115网盘通过WebDAV或rclone挂载为本地磁盘后，媒体文件的实际访问路径与Plex/Jellyfin等刮削器识别路径不一致，导致无法正确读取文件元数据。此外，挂载点权限未设为可读写、用户组未加入套件运行账户，也会引发访问拒绝。部分情况还涉及rclone配置中未启用“vfs-cache-mode”或缓存策略不合理，造成文件短暂不可见。需检查日志确认是否出现I/O错误或超时。确保挂载稳定、路径统一、权限开放，是解决刮削失败的关键所在。

Answer 1

1. 问题背景与常见现象

在群晖NAS系统中，用户常通过rclone或WebDAV方式将115网盘挂载为本地存储卷，以实现媒体库的扩展。然而，在Plex、Jellyfin等媒体服务器进行元数据刮削时，频繁出现“文件无法读取”、“路径不存在”或“I/O错误”等问题。这类故障的核心通常集中于路径映射不一致、权限配置不当以及挂载层缓存策略缺失。

典型表现包括：

• Plex提示“找不到匹配项”，即使文件名符合命名规范
• Jellyfin日志显示“File not found”但实际路径存在
• rclone mount进程运行正常，但访问延迟高或超时
• 使用ls命令可列出文件，但媒体服务无法索引

2. 深度分析：从底层机制到应用层交互

要彻底解决该问题，需理解挂载机制与媒体刮削器之间的协同逻辑。当115网盘通过rclone挂载后，其本质是一个FUSE（Filesystem in Userspace）虚拟文件系统，文件并非真实存在于本地磁盘，而是按需从远程拉取元数据和内容。

层级	组件	潜在故障点
网络层	115 WebDAV API	连接中断、限速、认证失效
挂载层	rclone mount / WebDAV Client	VFS缓存未启用、挂载参数错误
权限层	Synology 用户组 & ACL	sc-media未加入挂载目录权限组
应用层	Plex/Jellyfin 扫描引擎	路径解析失败、硬链接检测异常

3. 路径映射一致性校验流程

媒体刮削器依赖精确的文件路径来调用元数据API。若rclone挂载路径与Plex库设置路径不一致，即使物理上指向同一资源，也会导致识别失败。

# 示例：正确的rclone挂载命令应确保路径统一
rclone mount 115drive:/Media /volume1/115mount \
  --vfs-cache-mode full \
  --cache-dir /volume1/cache/rclone \
  --allow-other \
  --uid 1026 --gid 100 \
  --umask 002 \
  --daemon

上述命令中，/volume1/115mount 必须与Plex中添加媒体库的路径完全一致，包括大小写和结尾斜杠。可通过以下步骤验证：

1. 进入SSH终端执行：findmnt | grep 115
2. 确认挂载点输出为预期路径
3. 使用stat /volume1/115mount/电影/xxx.mkv检查inode可访问性
4. 在Plex Web UI中查看“已扫描路径”是否匹配

4. 权限模型与用户上下文深入剖析

群晖套件如Plex默认以sc-plex用户运行，而rclone通常由admin或特定计划任务用户启动。若挂载目录的父级未赋予sc-plex读取权限，则会出现“Permission denied”错误。

graph TD
    A[115网盘] --> B[rclone mount]
    B --> C{挂载点权限}
    C -->|未开放| D[Plex无法访问]
    C -->|正确配置| E[sc-plex 可读]
    E --> F[成功刮削]
    C --> G[用户组: users 或 sc-media]
    G --> H[ACL 设置包含 sc-plex]

解决方案如下：

• 进入【控制面板】→【共享文件夹】→ 编辑115mount权限
• 添加用户sc-plex并赋予“读取”权限
• 或将其所属群组（如users）设为可读
• 通过CLI检查：getfacl /volume1/115mount

5. rclone VFS 缓存机制的关键作用

FUSE文件系统的一个核心问题是“元数据可见性”。若未启用VFS缓存，rclone仅在访问时动态获取文件列表，造成媒体服务器扫描期间文件“闪现”或“消失”。

# 推荐的rclone配置片段（config file）
[115drive]
type = webdav
url = https://dav.115.com/
vendor = other
user = your_115_account
pass = encrypted_password
bearer_token = 
vendor_options = dav_no_head

# 必须启用vfs-cache-mode
[vfs]
chunk_size = 16M
poll_interval = 15s
cache_mode = full
max_age = 72h

其中cache_mode = full表示本地缓存元数据与部分数据块，极大提升稳定性。同时建议设置--buffer-size=64M减少I/O阻塞。