docker-plex-ghost 镜像文档

镜像概述与主要用途

docker-plex-ghost 是一个围绕 linuxserver/plex 镜像的配置包装器（Config wrapper），旨在简化 Plex Media Server 的部署与配置流程。该镜像保留了 linuxserver/plex 的核心功能，同时通过预设配置模板、简化的参数管理等方式，降低用户在部署和维护 Plex 媒体服务器时的配置复杂度，适用于需要快速搭建媒体服务的场景。

核心功能与特性

• 配置简化：提供预设配置模板，减少手动配置步骤，支持通过环境变量快速调整核心参数。
• 兼容性：完全兼容 linuxserver/plex 镜像的底层功能与数据结构，可无缝迁移现有 linuxserver/plex 部署。
• 配置持久化：支持配置文件独立挂载，确保配置修改在容器重启后不丢失。
• 轻量级封装：仅添加配置管理层，不增加额外运行时依赖，保持与基础镜像一致的性能。

使用场景与适用范围

适用场景

• 家庭媒体中心部署：快速搭建个人/家庭 Plex 媒体服务器，管理电影、音乐、照片等媒体资源。
• 小型媒体服务：适用于小型团队或社区的媒体共享服务，简化管理员配置工作。
• 自动化部署流程：集成到 CI/CD 或容器编排系统（如 Docker Compose、Kubernetes），实现 Plex 服务的标准化部署。

适用用户

• 家庭用户：无需深入了解 Plex 底层配置，通过简单参数即可启动服务。
• 系统管理员：需要快速部署多实例 Plex 或标准化配置的场景。
• 媒体爱好者：希望专注于媒体内容管理，减少服务配置时间的用户。

使用方法与配置说明

快速启动（docker run）

通过以下命令可快速启动容器，基础配置继承自 linuxserver/plex：

docker run -d \
  --name=plex-ghost \
  --net=host \  # 推荐使用 host 网络以确保 Plex 网络功能正常（如 DLNA、远程访问）
  -e PUID=1000 \  # 运行容器的用户 UID，需与宿主机用户匹配以避免权限问题
  -e PGID=1000 \  # 运行容器的用户 GID
  -e TZ=Asia/Shanghai \  # 时区设置，如 Asia/Shanghai、Europe/London 等
  -e VERSION=docker \  # Plex 版本策略，"docker" 表示使用容器内置版本
  -v /path/to/plex-config:/config \  # 挂载配置目录（持久化配置）
  -v /path/to/media:/media \  # 挂载媒体文件目录（如电影、音乐等）
  -v /path/to/transcode:/transcode \  # 挂载转码临时目录（可选，提升转码性能）
  --restart unless-stopped \
  docker-plex-ghost

Docker Compose 部署

使用 docker-compose.yml 配置文件可更便捷地管理服务，示例如下：

version: "3.8"

services:
  plex-ghost:
    image: docker-plex-ghost
    container_name: plex-ghost
    network_mode: host  # 推荐 host 网络
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - VERSION=docker
      # 可选：指定配置模板（若镜像提供预设模板）
      # - CONFIG_TEMPLATE=default  # 或 custom 等模板名称
    volumes:
      - /path/to/plex-config:/config  # 配置目录（必填，持久化配置）
      - /path/to/movies:/media/movies  # 电影目录（按需挂载）
      - /path/to/music:/media/music  # 音乐目录（按需挂载）
      - /path/to/transcode:/transcode  # 转码目录（可选）
    restart: unless-stopped

配置说明

环境变量

挂载卷

配置文件管理

• 配置文件路径：容器内 /config 目录下，与 linuxserver/plex 一致（如 Preferences.xml、Library/Application Support/Plex Media Server/）。
• 预设模板：若指定 CONFIG_TEMPLATE，镜像会自动将对应模板文件复制到 /config 目录，覆盖默认配置（首次启动时生效）。

注意事项

1. 网络模式：推荐使用 --net=host（或 network_mode: host）以确保 Plex 远程访问、DLNA 等功能正常，若需自定义端口映射，需手动映射 Plex 所需端口（如 32400/tcp、1900/udp 等）。
2. 权限设置：宿主机挂载目录（如 /path/to/plex-config、/path/to/media）的所有者 UID/GID 需与 PUID/PGID 一致，避免容器无权限读写文件。
3. 兼容性：该镜像完全兼容 linuxserver/plex 的数据结构，可直接迁移原 linuxserver/plex 的 /config 目录至本镜像使用。
4. 版本更新：通过 VERSION=latest 可强制拉取最新 Plex 版本，但建议使用 docker 策略以保持容器稳定性。