问题：群晖Emby添加文件夹失败如何解决？

Question

在使用群晖Emby媒体服务器时，用户常遇到“添加文件夹失败”的问题。常见原因包括：权限配置错误、路径不存在或不可访问、Emby账户无权读取指定目录等。解决方法如下： 1. **检查路径有效性**：确认所选文件夹路径真实存在且未被删除或移动。 2. **设置正确权限**：确保运行Emby的系统账户（如 `sc-emby`）对目标文件夹具有读取权限，可通过群晖“控制面板 > 用户 > 高级权限设置”进行调整。 3. **使用绝对路径**：避免使用符号链接或相对路径，建议直接选择共享文件夹下的实际路径。 4. **重启Emby服务**：修改权限后重启Emby套件，刷新配置。 5. **查看日志排查**：进入“日志”页面查找具体错误信息，有助于定位问题根源。 通过以上步骤，可有效解决群晖Emby添加媒体文件夹失败的问题。

Answer 1

1. 现象描述：添加媒体文件夹失败

在使用群晖（Synology）NAS 搭载 Emby 媒体服务器时，用户常常会遇到“添加媒体文件夹失败”的问题。此问题通常表现为在 Emby Web 管理界面中尝试添加媒体库路径时提示错误或无法继续。

2. 故障排查流程图

graph TD
    A[开始] --> B{路径是否存在？}
    B -- 是 --> C{Emby账户是否有读取权限？}
    C -- 是 --> D{是否使用绝对路径？}
    D -- 是 --> E{是否重启过服务？}
    E -- 是 --> F[成功添加]
    A --> G[结束]
    B -- 否 --> H[修正路径]
    C -- 否 --> I[设置正确权限]
    D -- 否 --> J[更换为绝对路径]
    E -- 否 --> K[重启Emby服务]

3. 常见原因分析与解决方法

• 路径不存在或不可访问： Emby 添加的目录必须真实存在且未被删除或移动。可以通过 SSH 登录 NAS 验证路径是否存在。
• 权限配置错误： Emby 在群晖系统中运行时，是以特定系统账户身份执行的，如 sc-emby。该账户必须对目标目录具有读取权限。
• 符号链接或相对路径导致的问题： 使用软链接（Symbolic Link）或相对路径可能导致 Emby 无法识别路径结构，建议始终使用共享文件夹下的实际物理路径。

4. 具体操作步骤

1. 检查路径有效性：通过 DSM 文件管理器或命令行进入目标路径，确认其确实存在。
2. 设置正确权限：
   • 登录 DSM 控制面板
   • 进入【用户】→【高级权限设置】
   • 找到 sc-emby 用户，为其分配目标文件夹的读取权限
3. 使用绝对路径：例如：/volume1/media/movies，而不是 ./movies 或指向其他位置的符号链接。
4. 重启 Emby 服务：在 DSM【套件中心】中停止并重新启动 Emby Server，确保新权限生效。
5. 查看日志排查：在 Emby Web 界面中进入【仪表盘】→【日志】页面，查找类似以下内容的报错信息：

   Error: Could not access directory '/volume1/media/tvshows'
   at MediaBrowser.Library.LibraryManager.GetFileSystemChildren(...)
   

5. 日志信息参考示例

时间戳	级别	消息
2024-06-05 14:22:31	Error	Could not read directory contents of /volume1/media/movies
2024-06-05 14:23:05	Warn	Permission denied accessing path /volume1/media/tvshows

6. 进阶建议

对于有经验的 IT 工程师，建议结合 Linux 权限机制深入理解 Emby 的运行环境：

• 使用 id sc-emby 查看 Emby 用户所属组别
• 使用 ls -l /volume1/media 查看目录归属及权限设置
• 必要时可手动修改 ACL（访问控制列表），使用 setfacl 命令精细控制权限