Emby

提示

如果你正在寻找 Emby 可用的播放器客户端，请移步至这里。

🌐 支持平台与架构

类别	说明
平台	Linux、Windows 10/11 & Server、macOS、FreeBSD、Docker
CPU 架构	amd64 (x86_64)、arm64 (aarch64)、armhf (armv7)
官方 Docker 镜像	emby/embyserver（Multi-arch 自动适配，推荐标签 latest 或固定版本如 4.8.8.0）

🐳 Docker 部署

1. 创建项目目录

mkdir -p ~/emby && cd ~/emby

2. 编写编排文件

docker-compose.yml

services:
  emby:
    image: emby/embyserver:latest
    container_name: emby
    restart: unless-stopped
    ports:
      - "8096:8096"   # HTTP
      - "8920:8920"   # HTTPS
    volumes:
      - ./config:/config
      - /path/to/media:/media  # 替换为实际媒体路径
    devices:
      - /dev/dri:/dev/dri      # Intel/AMD 核显直通（按需）
    environment:
      - TZ=Asia/Shanghai
      - UID=1000               # 执行 `id -u` 获取
      - GID=1000               # 执行 `id -g` 获取

获取 UID/GID

id -u && id -g

3. 启动服务

docker compose up -d

权限说明

容器内默认以 emby 用户运行。通过 UID/GID 环境变量映射可避免媒体文件只读。确保宿主机媒体目录对指定 UID/GID 具备 rwx 权限。

---

🐧 Debian 系统部署

适用于 Debian 11/12 及 Ubuntu 20.04+。采用官方 APT 仓库安装。

1. 添加仓库与密钥

导入 GPG 密钥

sudo apt update && sudo apt install -y curl gnupg2 lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.emby.media/emby-debian.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/emby.gpg

配置 APT 源

echo "deb [signed-by=/etc/apt/keyrings/emby.gpg] https://repo.emby.media/debian $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/emby.list

2. 安装与启动

sudo apt update
sudo apt install -y emby-server
sudo systemctl enable --now emby-server
sudo systemctl status emby-server

3. 防火墙放行

sudo ufw allow 8096/tcp
sudo ufw allow 8920/tcp
sudo ufw reload

路径与权限

配置与数据库默认位于 /var/lib/emby，日志位于 /var/log/emby。服务以 emby 系统用户运行，媒体目录需授权：sudo chown -R emby:emby /path/to/media。

---

🪟 Windows 系统部署

适用于 Windows 10/11 及 Windows Server。

1. 下载安装包

访问 Emby 官方下载页，选择 Windows 平台下载最新 .exe 安装程序。

2. 执行安装向导

1. 运行安装程序，点击 Next。
2. 自定义安装路径（建议非系统盘，如 D:\Emby）。
3. 服务模式：勾选 Install as a Windows Service（推荐，后台静默运行且开机自启）。
4. 完成安装，服务自动启动。

3. 防火墙与访问

• 首次访问时 Windows 防火墙弹窗，勾选 专用网络 与 公用网络 并允许。
• 浏览器访问：http://localhost:8096（局域网使用 http://<IP>:8096）。

数据目录

Windows 服务模式下配置与元数据默认存储在 %ProgramData%\Emby-Server。桌面模式为 %APPDATA%\Emby-Server。迁移需先停止 EmbyServer 服务，整体复制目录后修改服务启动参数。

---

⚙️ 初始化配置（全平台通用）

部署完成后访问 http://<服务器IP>:8096 进入向导：

1. 语言/时区：选择 Chinese Simplified 与对应时区。
2. 管理员账户：设置用户名与强密码。
3. 媒体库：添加库 → 选择类型 → 指定路径（Docker 为 /media/xxx，原生为绝对路径）→ 启用元数据下载。
4. 网络：保持默认端口。外网访问建议后续配置反向代理。
5. 验证：进入 控制台 > 转码，检查硬件加速状态；播放测试视频确认解码正常。

生产环境建议

• 定期备份 config 目录（含数据库、插件、用户配置）
• 媒体目录权限务必与运行用户（UID/GID 或 emby 账户）匹配
• 外网访问务必配置 HTTPS 反向代理，禁止直接暴露 8096 端口