Emby扫描不到新增影片？

Question

Emby扫描不到新增影片的常见原因是媒体库路径配置错误或文件权限不足。当新增影片未存放在Emby已索引的目录中，或存储设备（如NAS、外接硬盘）挂载后路径发生变化时，系统将无法识别新内容。此外，Linux系统下运行Emby服务的用户若缺乏对媒体文件的读取权限，也会导致扫描失败。建议检查媒体库设置中的文件夹路径是否正确，确保共享目录可被Emby服务账户访问，并在必要时手动触发“扫描媒体库”任务以刷新内容。

Answer 1

一、Emby扫描不到新增影片的常见原因与排查路径

在多媒体服务器管理中，Emby作为主流媒体中心软件之一，其核心功能依赖于对本地或网络存储中媒体文件的准确索引。然而，在实际运维过程中，常出现“新增影片无法被扫描识别”的问题。该现象虽表象简单，但背后涉及文件系统、权限模型、服务账户配置等多个层面。

1.1 基础层：路径配置错误是首要排查点

• 确认媒体库设置中添加的文件夹路径是否真实存在且拼写无误。
• 检查挂载点是否稳定，例如NAS通过CIFS/NFS挂载后路径是否发生变化（如/mnt/nas/media变为/media/server）。
• 若使用Docker部署Emby，需验证卷映射（volume mount）是否正确指向宿主机的实际媒体目录。
• 建议在Emby Web界面进入“设置 → 库 → 管理媒体库”中逐一核对路径，并尝试“测试路径”功能。

1.2 权限层：Linux系统下服务账户读取权限至关重要

在类Unix系统中，Emby通常以特定用户身份运行（如emby或mediacenter）。若该用户不具备目标目录的执行和读取权限，则即使路径正确也无法访问内容。

# 查看目录权限
ls -ld /path/to/media

# 将目录所有权赋予Emby运行用户（假设为emby）
sudo chown -R emby:emby /path/to/media

# 设置适当权限
sudo chmod -R 755 /path/to/media

1.3 存储层：动态挂载设备带来的路径漂移问题

外接硬盘或NAS在重启后可能出现设备节点变化（如/dev/sdb1 → /dev/sdc1），导致fstab或systemd mount unit失效，进而使原挂载路径为空。

设备类型	典型挂载方式	风险点
NAS (SMB)	/mnt/nas via CIFS	网络中断后未自动重挂
USB硬盘	/dev/sdX in fstab	设备顺序变更
LVM卷	/dev/mapper/vg-media	逻辑卷未激活
iSCSI Target	iscsiadm + mount	会话丢失

1.4 服务层：Emby索引机制与手动触发策略

Emby默认周期性扫描媒体库，但不会实时监控文件变更。因此新增影片可能需等待数小时才能被发现。

1. 登录Emby管理后台。
2. 导航至“仪表板 → 库”。
3. 点击“扫描媒体库”按钮强制刷新。
4. 观察日志输出是否有I/O错误或跳过文件提示。
5. 启用“实时监控”选项（需inotify支持）可提升响应速度。

1.5 深度诊断：结合系统日志与Emby日志定位根源

当基础排查无效时，应深入分析日志信息。Emby日志通常位于：

• Linux: /var/log/emby/
• Docker: docker logs emby_server
• Synology: /volume1/@appstore/EmbyServer/logs/

关注关键词如“Permission denied”、“No such file or directory”、“Failed to stat path”等。

1.6 架构视角：分布式环境下的共享存储一致性挑战

在多节点Emby集群或Kubernetes环境中，必须确保所有实例访问的是同一份存储视图。若采用NFSv3而未开启文件句柄同步，可能导致部分节点无法感知文件更新。

graph TD
            A[新增影片上传] --> B{路径是否在Emby库中?}
            B -- 否 --> C[调整媒体库路径配置]
            B -- 是 --> D{Emby服务账户可读?}
            D -- 否 --> E[修改权限或变更运行用户]
            D -- 是 --> F{存储已正确挂载?}
            F -- 否 --> G[修复fstab或mount unit]
            F -- 是 --> H[手动触发扫描任务]
            H --> I[检查日志确认结果]

1.7 自动化运维建议：构建健壮的媒体入库流水线

为避免人工干预，可设计自动化流程：

• 使用inotifywait监听目录变化并调用Emby API触发扫描。
• 编写脚本定期校验挂载状态与权限配置。
• 集成Prometheus+Alertmanager实现异常告警。
• 利用Ansible统一管理多台服务器上的Emby部署一致性。

1.8 容器化部署特殊考量

Docker环境下常因SELinux/AppArmor策略限制容器访问宿主机文件系统。

# 正确的Docker运行示例
docker run -d \
  --name emby \
  -v /path/on/host:/mnt/media:ro \
  -v /config/emby:/config \
  --user $(id -u emby):$(id -g emby) \
  --device=/dev/dri:/dev/dri \
  linuxserver/emby

注意:ro标签不影响读取，关键在于宿主目录权限与用户UID匹配。

1.9 跨平台兼容性注意事项

Windows与Linux之间共享媒体库时，需注意：

• 大小写敏感性差异（Linux区分，Windows不区分）。
• 符号链接处理方式不同。
• NTFS/FAT32权限模型缺失可能导致Emby误判。

1.10 高级调试手段：使用strace追踪系统调用

当常规方法无法定位问题时，可通过系统级工具抓取Emby进程行为：

# 获取Emby主进程PID
ps aux | grep emby

# 追踪openat系统调用
sudo strace -p <PID> -e trace=openat -f

观察是否返回ENOENT或EACCES错误码，精准定位访问失败环节。