问题：Docker版Emby开心版如何配置持久化存储？

Question

问题：在使用Docker部署Emby开心版时，如何正确配置持久化存储以保障数据安全与容器升级时不丢失配置及媒体信息？

Answer 1

一、问题背景与基本概念

在使用 Docker 部署 Emby 开心版时，一个常见的问题是：如何配置持久化存储以保障数据安全？尤其在容器升级或重建时，如何确保配置信息和媒体文件不丢失？这涉及到 Docker 的数据持久化机制，包括 Volume 和 Bind Mount。

Emby 开心版通常基于官方镜像进行修改，因此其目录结构和数据路径可能与标准 Emby 不同。了解这些路径是配置持久化的第一步。

二、Emby 数据结构分析

Emby 主要涉及以下几类数据：

• 配置文件：包括用户设置、插件状态、数据库等。
• 媒体元数据：如电影海报、剧集信息、播放记录等。
• 日志文件：用于排查运行时问题。
• 插件数据：第三方插件的配置和缓存。

这些数据通常位于容器内的如下路径中：

数据类型	默认路径
配置与数据库	/config
媒体库索引	/metadata
日志文件	/log
插件数据	/plugins

三、Docker 持久化方式对比

Docker 提供了多种数据持久化方式，常见的是 Bind Mount 和 Named Volume，它们各有优劣：

方式	优点	缺点
Bind Mount	直接映射主机目录，便于调试	依赖主机文件系统路径，移植性差
Named Volume	由 Docker 管理，可跨容器共享	初始配置较复杂

对于生产环境部署建议使用 Named Volume，开发调试阶段可用 Bind Mount。

四、正确配置持久化存储的方法

以下是推荐的持久化配置方案（使用 Docker Compose）：

version: '3.8'

services:
  emby:
    image: emby/embyserver:latest
    container_name: emby
    volumes:
      - emby_config:/config
      - emby_metadata:/metadata
      - emby_log:/log
      - emby_plugins:/plugins
      - /path/to/media:/media
    ports:
      - "8096:8096"
    restart: unless-stopped

volumes:
  emby_config:
  emby_metadata:
  emby_log:
  emby_plugins:

其中：

• /path/to/media 是你本地的媒体文件路径，使用 Bind Mount 映射到容器内。
• 其余使用 Named Volume，由 Docker 自动管理。

五、升级与迁移策略

为保证升级时不丢失数据，需遵循以下步骤：

1. 备份当前所有卷的数据（特别是 /config 和 /metadata）。
2. 停止并删除旧容器：docker-compose down
3. 拉取新版本镜像：docker-compose pull
4. 重新启动服务：docker-compose up -d

由于数据卷未被删除，新的容器将继续使用原有的配置和媒体信息。

流程图如下：

graph TD
      A[开始升级] --> B{是否已备份数据?}
      B -- 是 --> C[停止旧容器]
      B -- 否 --> D[备份/config, /metadata等]
      C --> E[拉取新镜像]
      E --> F[启动新容器]
      F --> G[完成升级]