Emby 容器部署的重点不是把页面跑起来，而是把合法自有和授权家庭媒体、配置目录、转码缓存、只读挂载和硬件边界一次说清。

\n
我在家里部署 Emby，只把它当成合法自有资料和已获得授权内容的家庭索引服务。它负责识别、封面、播放入口和家庭成员的客户端体验，不负责改动归档目录，更不应该成为所有文件都能写的万能容器。这个边界先定下来，后面讨论端口、硬解、缓存和备份才不会跑偏。

第一次部署时最容易犯的错，是把配置、媒体资料和临时转码都塞进一个目录。短期看省事，长期会把问题搅在一起：升级后配置坏了，不知道要恢复哪一层；转码缓存涨满了，怕误删索引；权限报错时，既可能是原文件目录，也可能是应用数据库。我的做法是把 Emby 的 /config、只读媒体目录和 /transcode 明确拆开。

目录先定边界

宿主机上我通常会准备三类目录。/srv/appdata/emby 放应用配置和数据库，属于需要备份的核心数据；/srv/media/authorized 放家庭合法自有或授权资料，只以只读方式挂入容器；/srv/cache/emby-transcode 放临时转码缓存，可以定期清理，也可以放到速度更好的磁盘上。这样即便播放时临时文件暴涨，也不会影响配置目录。

容器内路径尽量保持长期稳定，例如统一使用 /media/authorized。以后宿主机从单盘换成 NAS 挂载，或从机械盘换到 SSD，只需要调整 Compose 的左侧路径，Emby 看到的库路径不变。路径少一点，扫描历史和客户端记录就少一点重建成本。

只读媒体目录

我不让 Emby 对原文件目录拥有写权限。Compose 里使用 :ro 很朴素，但很有用：误点删除、插件异常、容器账号映射错误，都不应该影响归档资料本身。封面、元数据和数据库留在 /config，临时输出留在 /transcode，原文件目录只负责被读取。

如果确实需要让 Emby 写入某些辅助文件，我会单独开一个小范围的可写目录，而不是把整个资料根目录改成可写。家庭服务的权限设计不用炫技，重点是出了问题能马上判断影响面。

硬件设备别默认全开

不少机器部署 Emby 时会顺手挂载 /dev/dri，但我会先问两个问题：这台机器真的承担转码吗？客户端是否大多能直连播放？如果家里主要是电视盒子、平板和同一局域网设备，很多时候直连比转码更稳定。

需要硬件加速时，再把设备边界写清楚：只挂载必要的 /dev/dri，确认宿主机驱动正常，容器用户有权限访问设备节点，并观察播放日志里是否真的进入转码流程。硬解不是解决所有卡顿的按钮，网络质量、客户端能力、字幕格式、文件编码和缓存目录空间都会影响播放。

Compose 骨架

下面这份只表达我关心的运行边界，实际使用时镜像版本、目录前缀和用户组要按自己机器调整。

services:
  emby:
    image: lscr.io/linuxserver/emby:latest
    container_name: emby
    restart: unless-stopped
    ports:
      - "8096:8096"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - /srv/appdata/emby:/config
      - /srv/media/authorized:/media/authorized:ro
      - /srv/cache/emby-transcode:/transcode
    devices:
      - /dev/dri:/dev/dri
    logging:
      driver: local
      options:
        max-size: "10m"
        max-file: "3"

如果不需要硬件加速，我会先删掉 devices。部署初期少给一点能力，确认需要后再打开，比一上来把所有设备都给容器更可控。

部署后的验收

我会先跑 docker compose config 看最终配置是否符合预期，再用 docker inspect emby --format '{{json .Mounts}}' 核对挂载。然后从局域网客户端打开页面，新增一个测试库，确认只读目录能扫描、配置目录会写入数据库、转码目录在播放需要时会产生临时文件。

日志要和操作时间对齐看。页面上显示卡住，不一定是 Emby 本身坏了；可能是媒体目录权限不足，可能是封面下载超时，也可能是临时目录不可写。docker compose logs --tail=160 emby、ls -ln /srv/media/authorized、df -h /srv/cache/emby-transcode 这几条命令，通常比反复刷新页面更快定位问题。

维护习惯

升级前我会记录当前镜像、Compose 文件和 /config 目录快照。升级后不急着清理旧镜像，先确认登录、扫描、播放和转码缓存都正常。只读媒体目录不用跟着应用备份走，但它的挂载来源、属主和权限要有记录；这些信息在换硬盘或迁移机器时比一段口头记忆可靠得多。

Emby 在家庭服务器里很好用，前提是别让它承担超过边界的事情。它管理体验，原文件目录保持安静，配置能恢复，缓存可清理，硬件设备按需开放。做到这几项，后面遇到升级、迁移或播放问题，排查就会稳很多。