Emby 媒体库不扫描元数据 — 海报没出来、名字匹配错了、一直转圈
现象描述
媒体库扫描完了，但：
- 电影/电视剧显示纯文件名，没有海报、评分、剧情
- 或者匹配到了完全不对的内容（你存的《星际穿越》匹配成了老版同名短片）
- 扫描进度条走到一半卡住不动
排查清单
检查点 1：文件命名对不对
最常见的原因。Emby 靠解析文件名来搜索元数据源，命名格式差一点就搜不到。
对照 文件命名与目录结构 里的规范检查：
电影：
- ✅
星际穿越 (2014).mkv - ✅
Interstellar (2014).mkv - ❌
视频.mp4（完全没名字） - ❌
Interstellar.mkv（缺年份，容易和重名内容搞混） - ❌
[下载站广告]星际穿越高清版[蓝光1080P]YYDS.mkv（名字被各种修饰符污染）
电视剧：
- ✅
绝命毒师/Season 01/s01e01.mkv - ❌
绝命毒师第1集.mkv（没按 Season/Episode 组织，也没 sXXeYY 标记）
音乐：
- ✅
周杰伦/叶惠美/01-晴天.flac（ID3 标签也要对） - ❌
音乐大杂烩/001.flac（没按艺人/专辑组织，ID3 标签也是乱的）
命名不对 → 用 FileBot 批量重命名，然后 Emby Dashboard → Library → 对应库 → Scan Library Files 重新扫描。
检查点 2：Emby Server 能访问外网吗
Emby 需要联网去 TheMovieDB / TheTVDB / IMDB 等源拉元数据和海报。如果 Server 连不上外网，元数据肯定拉不到。
验证方法：
在 Emby Server 上（或同一台机器上）打开浏览器访问：
TheMovieDB（电影元数据源）（电影元数据源）TheTVDB（电视剧元数据源）（电视剧元数据源）
两个都能打开 → 外网没问题。有一个打不开 → Server 网络有问题。
Emby Server 出站被拦 的典型场景：
| 场景 | 解决 |
|---|---|
| Windows 防火墙拦了出站 | Windows 防火墙 → 出站规则 → 确保 EmbyServer.exe 有"允许出站"规则 |
| Docker 容器网络问题 | Docker 日志里看 Network 有没有错误；确认容器能 curl TheMovieDB（电影元数据源） |
| 群晖 DSM 防火墙拦了 | DSM 控制面板 → 安全 → 防火墙 → 给 Emby 出站放行 |
| 代理没配 | Server 在代理网络里，但没给 Emby 配代理。Dashboard → Advanced → System → Proxy Settings 里填 |
| 纯 IPv6 网络 | 某些 NAS 在纯 IPv6 环境下 Emby 无法访问 IPv4 的元数据服务器。需要在路由器里开 IPv4 出站 |
检查点 3：元数据语言设置对不对
Dashboard → Library → 对应库 → Edit Library → Advanced Settings → Metadata language：
如果设的是 English 但你希望显示中文，改成 Chinese Simplified（简体中文）。改完后需要重新扫描。
检查点 4：Emby Server 版本过老
老版本 Emby 的元数据抓取逻辑可能有 bug，或者元数据源的 API 变了。升级到最新稳定版试试：
Dashboard → Advanced → System → Server Update → 检查更新。
检查点 5：实时监控 vs 定时扫描
如果媒体路径是 SMB/CIFS 网络共享（NAS 上大多数场景），Real-time monitoring（实时监控）不工作：
- 你扔进去新文件，Emby 不会自动扫描
- 需要定时扫描或手动触发 Scan Library Files
检查 Dashboard → Library → 对应库 → Edit Library → Advanced Settings → 看 Enable real-time monitoring 是不是灰的或提示不支持。如果不支持就关掉这个选项，靠定时扫描（Daily 或 Weekly）。
检查点 6：元数据源本身查不到
有些冷门内容确实在 TheMovieDB / TheTVDB 上搜不到：
- 特别小众的国产独立电影
- 自己拍的家庭视频
- 未上映的片子（只有名字没有上映记录）
这种情况：
- 手动 Identify：Web Client 里找到那个条目 → 详情页 → 菜单 → Identify → 手动搜正确的名字，或者直接填 TheMovieDB 的 ID（URL 里的数字）
- 自己在 TheMovieDB 上补录（如果你能登录 TheMovieDB 社区）
- 用本地 NFO 文件（Emby Dashboard → Advanced → Metadata → 开启 "Save local metadata to media folders"）
检查点 7：IPv6-only 网络问题
这个坑特别隐蔽。某些 NAS（特别是群晖）默认只开启 IPv6 出站。而 Emby 的元数据源（TheMovieDB 等）很多只支持 IPv4 出站或 IPv6 支持不好。
现象：Emby Server 能正常启动，能访问内网设备，但就是拉不到元数据。Windows 下没有这个问题，但 NAS 上很常见。
排查：在 NAS 上打开 Shell Station，执行：
ping -4 www.themoviedb.org # 强制 IPv4
ping -6 www.themoviedb.org # 强制 IPv6如果 IPv4 通 IPv6 不通，或者 Emby Server 只走 IPv6，就是这个问题。
解决：DSM 控制面板 → 网络 → 接口 → IPv4 设置 → 确保 IPv4 是开启的（不要只有 IPv6）。
扫描时卡住不动
扫描中途卡住（进度条停在某个百分比）：
- 检查日志：Dashboard → Help → Logs → 看 Emby Server 日志，最后一行在干什么
- 是不是某个文件坏了：日志里如果提到了某个文件的名字，可能是那个文件损坏或格式 Emby 解析不了。把它移出去试试
- 数据库损坏：极少见，但如果扫描了 N 遍都卡，可能 libraries.db 数据库坏了。先备份，然后 Dashboard → Advanced → Run Startup Wizard → 重新走向导重建库（会丢观看记录但媒体索引能重建）