1. 创建目录结构

bash

# 创建主目录
sudo mkdir -p /opt/emby

# 创建配置目录(与 compose 中 volumes 对应)
mkdir -p /opt/emby/config

# 给普通账号写入权限(假设你的用户名为 $USER)
sudo chown -R $USER:$USER /opt/emby

2. 创建 docker-compose.yml

bash

cat > /opt/emby/docker-compose.yml << 'EOF'
services:
  emby:
    image: w12725/emby:4.9.3.0
    container_name: emby
    network_mode: host
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - HTTP_PROXY=http://192.168.3.100:1082
      - HTTPS_PROXY=http://192.168.3.100:1082
      - http_proxy=http://192.168.3.100:1082
      - https_proxy=http://192.168.3.100:1082
      - NO_PROXY=localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12
      - no_proxy=localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12
    volumes:
      - /opt/emby/config:/config
      - /mnt/Media:/media/Media
    devices:
      - /dev/dri:/dev/dri
    restart: always
EOF

3. 安装 Docker 和 Docker Compose(如未安装)

bash

# 更新包索引
sudo apt update

# 安装依赖
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 添加 Docker 仓库(以 Ubuntu 22.04 jammy 为例,可通用)
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# 将当前用户加入 docker 组(避免每次 sudo)
sudo usermod -aG docker $USER

# 退出重新登录使组生效,或执行以下命令立即生效
newgrp docker

# 安装 Docker Compose 插件
sudo apt install -y docker-compose-plugin

4. 启动 Emby

bash

cd /opt/emby
docker compose up -d

5. 验证运行状态

bash

# 查看容器状态
docker compose ps

# 查看日志
docker compose logs -f

6. 访问 Emby

浏览器打开 http://你的服务器IP:8096 进行初始化设置。

注意事项

  1. 代理地址:请确认 192.168.3.100:1082 是否可访问,如不需要可删除相关环境变量
  2. 挂载点:确保 /mnt/Media 和 /mnt/9KG 目录存在且有读取权限
  3. 硬件加速/dev/dri 需要 root 权限,如果你用户不在 render 组,可用 sudo usermod -aG render $USER
  4. PUID/PGID=0:表示以 root 运行,如有安全顾虑可改为普通用户 ID(使用 id -u 和 id -g 查看)

如启动时遇到 /dev/dri 权限问题,可先注释 devices 行启动测试,确认正常再开启。

此作者没有提供个人介绍。
最后更新于 2026-06-30