关于 emby 无法读取 .actors 中演员的若干问题

摘要：只读访问：emby 仅从.actors文件夹读取演员图片数据，不会对其进行写入或修改。单一数据源与共享机制：emby 会为每个演员在数据库内创建唯一的数据条目（包含图片信息）。扫描过程中，首个遇到该演员的媒体项（及其关联的.actors图片）将确定此演员的初始

一、emby 读取 .actors 文件夹的核心特性

主要结论如下：emby 在读取.actors文件夹中的演员图片时，要求图片文件名必须使用拉丁文（英文字母）。

此外，emby 对该文件夹的处理具有以下关键特性：

只读访问：emby 仅从 .actors 文件夹读取演员图片数据，不会对其进行写入或修改。

单一数据源与共享机制：emby 会为每个演员在数据库内创建唯一的数据条目（包含图片信息）。扫描过程中，首个遇到该演员的媒体项（及其关联的 .actors 图片）将确定此演员的初始数据。后续扫描到的包含同一演员的其他媒体项，无论其自身 NFO 文件是否指定了演员图片路径，都将共享并使用这份已存在的数据。这意味着后续媒体项的 .actors 图片（即使存在）不会覆盖或新增演员图片数据。

二、关于 TMM (tinyMediaManager) “保存演员图片到 .actors 目录” 功能的说明

起源与适配：.actors 文件夹方案最初由 Kodi 采用并最适合其使用。自 emby 4.8.0 版本起，emby 也开始支持读取此目录下的演员图片。

emby 开发者的立场：emby 的维护者认为，将演员图片分散存储在多个媒体项的 .actors 子文件夹中是一种不理想的管理方式。主要原因在于，当同一演员出演多部作品时，其头像图片会在不同目录下重复存储，导致不必要的磁盘空间占用。

三、关于 TMM 生成的 NFO 文件与 .actors 图片关系的说明

观察 TMM 生成的 NFO 文件内容，会发现其中包含指向 TMDB 的演员信息链接。这引发一个疑问：既然.actors文件夹已包含本地演员图片，为何 NFO 中仍需这些网络链接？原因在于：TMDB 链接是重要的备份机制。当.actors文件夹中的本地图片不可用（例如，文件被误删、路径错误或未被 Emby 识别）时，Emby 可以依据 NFO 文件中的 TMDB 链接，尝试从网络获取该演员的信息和头像。

那么，为何有时即使 NFO 中有链接，演员头像在 Emby 中仍无法显示？
核心问题在于：访问 TMDB 等元数据服务所需的域名可能遭遇网络干扰（DNS污染等），导致 Emby 无法成功连接服务器以下载演员头像信息。

四、在 Emby 中显示演员头像的有效解决方案

要在 Emby 中正常显示演员头像，可采用以下几种方法：

修改 Hosts 文件： 通过修改系统的 Hosts 文件，将受污染的 TMDB 等相关域名解析指向正确的 IP 地址，从而绕过 DNS 干扰。

使用科学

确保 .actors 图片被 Emby 正确读取（需满足特定条件）： 此方法依赖于 Emby 成功读取 .actors 文件夹中的本地图片。其关键前提是：演员图片的文件名必须严格使用拉丁字母（英文字母） 命名。典型的有效文件名格式如下：

原

改为

参考：

https://emby.media/community/index.php?/topic/25797-feature-request-ability-to-save-people-images-in-media-location-actors/page/2/

https://emby.media/community/index.php?/topic/131458-emby-version-4880-cannot-read-actor-photos-in-the-actors-folder/

https://tieba.baidu.com/p/6576244442#