Emby 目录规划要先区分合法内容类型，再把原文件、封面元数据缓存和临时目录分开管理。

\n
Emby 的目录规划看起来只是命名问题，实际会影响扫描速度、封面匹配、权限排查和迁移成本。我的原则很简单：内容先按合法来源和使用场景分层，原文件目录只读，应用生成的封面、元数据缓存、播放历史和临时转码都放在 Emby 自己的配置或缓存目录里。

如果一开始把所有资料混在一个大目录里，后面再整理会很痛苦。库路径改了，Emby 可能重新扫描；封面重新生成，客户端记录也容易变乱；家里其他服务如果也读同一个目录，还会出现同一份内容在不同服务里路径不一致的问题。目录规划不需要复杂，但要稳定。

我会先分合法分类

我习惯把资料根目录拆成几个明确的桶，例如：

/srv/media/
  home-videos/
  public-domain/
  authorized-materials/
  lectures/
  family-events/

home-videos 放家庭拍摄、旅行记录、孩子活动和自己剪辑的内容；public-domain 放公版或明确允许个人保存和观看的资料；authorized-materials 放已经获得授权的学习素材、购买附带的可本地保存资料或机构允许家庭内部使用的内容；lectures 和 family-events 则按我的实际使用习惯继续细分。

这些名字不追求华丽，重点是让每个目录的来源和用途一眼能看明白。以后新增内容时，先判断该放进哪一类；判断不了的，不急着丢进库里。家庭服务器越用越久，模糊目录会比磁盘空间更早制造麻烦。

容器内路径保持稳定

宿主机目录可以跟着硬盘、NAS 或挂载方式变化，但容器内路径最好长期不变。我会把上面的目录映射成：

volumes:
  - /srv/media/home-videos:/media/home-videos:ro
  - /srv/media/public-domain:/media/public-domain:ro
  - /srv/media/authorized-materials:/media/authorized-materials:ro
  - /srv/appdata/emby:/config
  - /srv/cache/emby-transcode:/transcode

Emby 建库时只看到 /media/home-videos、/media/public-domain、/media/authorized-materials。以后宿主机左侧路径变了，容器内路径不变，扫描规则和库设置就不用跟着大动。

缓存不要贴着原文件放

封面、元数据、章节图、播放历史和索引状态属于 Emby 的配置资产，应该进 /config；转码过程产生的临时文件属于可清理缓存，应该进 /transcode。我不会把这些东西写回原文件目录，也不会把 .nfo、图片缓存和临时文件散落到家庭资料旁边。

这样做有两个好处。第一，原文件目录保持干净，备份和校验都简单；第二，应用状态可以独立备份和恢复。哪天 Emby 配置坏了，我可以恢复 /srv/appdata/emby；哪天缓存占满了，我可以清理 /srv/cache/emby-transcode，不会误碰归档资料。

扫描策略要克制

目录稳定后，再考虑扫描频率。家庭自用不一定需要频繁全量扫描，我更倾向于新增内容后手动刷新对应分类，或设置一个低频计划任务。大量封面和元数据刷新会占用 CPU、网络和磁盘 I/O，影响正在观看的客户端。

首次扫描时，我会只加一个小目录做测试，确认命名、权限和封面缓存位置都正常，再逐步加入其他分类。一次性把所有目录加进去，出错时很难判断是哪一类内容、哪一个路径或哪一种权限导致的问题。

排障时看路径表

我的目录规划会留一张很短的路径表：宿主机路径、容器内路径、是否只读、归属用户、是否备份。出现“扫描不到”“封面缺失”“播放失败”时，先看这张表，再看日志。很多问题不是应用能力不够，而是容器内路径和自己脑子里记的路径不是同一个。

常用检查命令也很固定：

docker compose config
docker inspect emby --format '{{json .Mounts}}'
find /srv/media -maxdepth 2 -type d
ls -ln /srv/media/home-videos
docker compose logs --tail=160 emby

如果 Emby 能看到目录但扫描为空，我会先查文件权限和目录层级；如果扫描正常但封面异常，再查 /config 写入和网络访问；如果播放时失败，再看客户端是否直连、是否触发转码、/transcode 是否有空间。

目录规划的目标不是让树形结构看起来专业，而是让家庭内容的来源清楚、服务边界清楚、缓存位置清楚。只要这些固定下来，Emby 后续升级、迁移或换硬盘时，真正要改的地方会少很多。