Docker 部署 Emby 官方版媒体服务器 🎬

Emby 媒体服务器

📋 目录导航

🎯 项目简介

Emby 官方版 是一款专业的媒体服务器软件，可以将您的个人媒体库（电影、电视剧、音乐、照片）转换成精美的流媒体体验。
通过 Docker 部署，您可以轻松搭建一个功能完整、稳定可靠的媒体服务器，支持全平台访问和智能转码功能。

🛠️ 核心特性

特性类别 功能描述 优势
🎥 专业媒体管理 自动整理电影、电视剧、音乐和照片 智能识别元数据，生成精美媒体库
📱 全平台支持 支持网页、手机、电视、游戏机等多种设备 随时随地享受媒体内容
🔄 智能转码 根据设备能力自动调整视频格式和码率 优化播放体验，节省带宽
🎨 美观界面 现代化用户界面，支持主题定制 个性化观看体验
👥 多用户系统 创建多个用户并设置不同权限 适合家庭共享使用
📊 观看统计 记录观看历史和播放进度 方便续播和管理
🌐 远程访问 通过互联网随时随地访问媒体库 打破地域限制

🐳 一、Docker 部署 Emby

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
mkdir -p /mnt/mydisk/home/emby && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  emby-server:
    container_name: emby-server
    image: emby/embyserver:latest
    restart: unless-stopped
    network_mode: bridge
    ports:
      - 8996:8096  # Web界面端口
      - 8920:8920  # HTTPS端口（可选）
    volumes:
      - ./config:/config  # 配置文件目录
      - ./metadata:/metadata  # 元数据目录
      - /mnt/ARS2-NFS/nas/link:/media/video  # 视频媒体目录
      - /mnt/ARS2-NFS/nas/music:/media/music  # 音乐目录（可选）
      - /mnt/ARS2-NFS/nas/photos:/media/photos  # 照片目录（可选）
    environment:
      - UID=1000  # 建议使用实际用户ID
      - GID=1000  # 建议使用实际用户组ID
      - TZ=Asia/Shanghai  # 时区设置
      - UMASK_SET=022  # 文件权限掩码
    deploy:
      resources:
        limits:
          memory: 8G
        reservations:
          memory: 1G
    devices:
      - /dev/dri:/dev/dri  # 硬件加速设备
    extra_hosts:
      - "api.themoviedb.org:13.224.161.90"
      - "image.tmdb.org:108.138.246.49"
      - "www.themoviedb.org:54.192.151.79"
      - "themoviedb.org:99.84.238.136"
      - "api4.thetvdb.com:13.225.142.99"
EOF

🔐 安全提示：首次使用后请立即修改默认密码，建议使用强密码并定期更换

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 Emby

1. 访问 Web 界面 💻

2. 首次使用步骤 🎯

  1. 打开浏览器访问上述地址
  2. 选择语言（推荐中文）
  3. 创建管理员账户
  4. 添加媒体库：
    • 电影：指向 /media/video/Movies
    • 电视剧：指向 /media/video/TV Shows
    • 音乐：指向 /media/music（如已挂载）
    • 照片：指向 /media/photos（如已挂载）
  5. 配置元数据下载器（推荐TMDB和TVDB）
  6. 设置网络和远程访问选项

🌐 三、Nginx 反向代理配置

访问地址示例：https://emby.yourdomain.com

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/emby.conf <<'EOF'
server {
    listen 80;
    server_name emby.yourdomain.com;
    
    # 重定向到 HTTPS
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name emby.yourdomain.com;
    
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/private.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384;
    ssl_prefer_server_ciphers off;
    
    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    
    # 提高上传大小限制
    client_max_body_size 20G;
    
    location / {
        proxy_pass http://127.0.0.1:8996;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 增加超时时间
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
        proxy_connect_timeout 300s;
    }
    
    # 静态资源缓存
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        proxy_pass http://127.0.0.1:8996;
    }
    
    # 错误页
    error_page 404 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器  
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

# 以root身份进入容器  
docker exec -u 0 -it <container_name> sh

# 在容器中执行命令
docker exec <container_name> ls -la

# 查看容器详情和资源使用
docker inspect <container_name>     # 查看详细配置
docker stats <container_name>       # 实时资源监控

## 容器日志管理
docker logs <container_name>           # 查看日志
docker logs -f <container_name>        # 实时跟踪日志
docker logs --tail 100 <container_name>  # 查看最后100行
docker logs -t <container_name>        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航媒体，娱乐无限

通过本文档，你已经成功使用 Docker 部署了 Emby 官方版媒体服务器，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🎬 专业管理 打造精美的个人媒体库，智能整理电影、电视剧、音乐和照片资源
🌐 全平台畅享 在任何设备上流畅播放媒体内容，智能转码确保最佳观看体验
📊 智能优化 自动获取元数据和艺术封面，让媒体库既美观又井井有条

媒体之路，是一场与影音娱乐相伴的精彩旅程。愿 Emby 成为你可靠的媒体管家，陪伴你在每一次家庭观影和音乐欣赏的美好时刻。

从现在开始，随心观影，畅享音乐——构建你个性化的家庭娱乐生态系统吧！🚀

📌 持续迭代：建议关注 Emby 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可通过 Emby 官方社区 获取帮助。

祝你使用愉快，观影体验更上一层楼！🎉