tianon/plex

Plex Media Server Docker镜像

镜像概述

Plex Media Server Docker镜像是用于部署Plex Media Server的容器化解决方案。Plex Media Server是一款功能强大的媒体服务器软件，允许用户组织、管理个人媒体库（如电影、电视节目、音乐、照片等），并通过网络在各种设备（包括电脑、手机、平板、智能电视、流媒体设备等）上流式传输媒体内容。该镜像提供了便捷的部署方式，简化了Plex Server的安装和配置流程。

核心功能与特性

• 媒体库管理：自动组织媒体文件，生成元数据（如封面、描述、演员信息等），支持多种媒体类型（电影、电视、音乐、照片等）。
• 跨设备流式传输：支持在所有支持Plex的设备上访问媒体内容，包括iOS、Android、Windows、macOS、智能电视（如Samsung、LG）、流媒体设备（如Roku、Fire TV）等。
• 转码支持：根据客户端设备的能力自动转码媒体文件，确保流畅播放，即使在网络带宽有限的情况下。
• 远程访问：通过Plex账户实现安全的远程访问，无需复杂的网络配置。
• DVR功能：支持连接电视调谐器，录制直播电视节目（需额外硬件支持）。
• 多用户支持：创建多个用户账户，共享媒体库并设置访问权限。

使用场景与适用范围

• 家庭媒体中心：搭建家庭集中式媒体库，供家庭成员在各种设备上观看电影、听音乐。
• 个人媒体管理：整理个人收藏的媒体文件，通过统一界面浏览和播放。
• 远程媒体访问：出差或外出时，通过手机或电脑远程访问家中的媒体库。
• 小型办公/团体共享：在小团队或团体内部共享指定媒体内容。

使用方法与配置说明

基本运行命令

使用docker run命令启动Plex Media Server容器：

bash
docker run -d \
  --name plex \
  --net=host \  # 推荐使用host网络以确保网络兼容性，特别是DLNA和自动发现功能
  -e TZ="Asia/Shanghai" \  # 设置时区
  -e PLEX_CLAIM="claim-XXXXXXXXXXXXXXXXXXXX" \  # Plex声明码，从https://www.plex.tv/claim获取（24小时内有效）
  -v /path/to/plex/config:/config \  # 配置文件目录（持久化存储）
  -v /path/to/media:/data \  # 媒体文件目录（可根据需要挂载多个子目录）
  -v /path/to/transcode:/transcode \  # 转码缓存目录（建议使用SSD以提高转码性能）
  tianon/plex

注意：--net=host模式会让容器使用主机网络，直接暴露Plex的端口（默认32400/tcp）。如果不使用host网络，需手动映射必要的端口（如-p 32400:32400/tcp），但可能影响部分功能（如DLNA）。

必要的卷挂载

环境变量配置

Docker Compose配置示例

创建docker-compose.yml文件，简化部署和管理：

yaml
version: '3.8'

services:
  plex:
    image: tianon/plex
    container_name: plex
    network_mode: host  # 推荐使用host网络
    environment:
      - TZ=Asia/Shanghai
      - PLEX_CLAIM=claim-XXXXXXXXXXXXXXXXXXXX  # 替换为实际的声明码
      - ADVERTISE_IP=http://192.168.1.100:32400/  # 替换为服务器实际IP
    volumes:
      - /path/to/plex/config:/config  # 本地配置目录
      - /path/to/media/movies:/data/movies  # 电影目录
      - /path/to/media/music:/data/music  # 音乐目录
      - /path/to/media/photos:/data/photos  # 照片目录
      - /path/to/transcode:/transcode  # 转码缓存目录
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动容器：

bash
docker-compose up -d

首次配置

1. 获取Plex声明码：访问Plex官网，登录Plex账户后获取声明码（有效期24小时）。
2. 启动容器时通过PLEX_CLAIM环境变量传入声明码。
3. 容器启动后，访问http://<服务器IP>:32400/web打开Plex Web界面。
4. 按照界面引导完成初始设置，包括创建媒体库、添加媒体文件夹等。

注意事项

• 网络配置：推荐使用host网络模式以确保所有Plex功能正常工作，特别是DLNA和自动发现。如需使用桥接网络，需映射多个端口（除32400外，还可能包括3005/tcp、8324/tcp、32469/tcp、1900/udp、32410/udp、32412/udp、32413/udp、32414/udp等）。
• 存储性能：转码目录（/transcode）建议使用SSD，以避免转码过程中的卡顿。
• 媒体文件权限：确保容器对挂载的媒体目录有读取权限，可通过-u参数指定用户ID和组ID（如-u 1000:1000）以匹配宿主机文件权限。
• 更新：如需更新Plex Server，可停止容器后拉取最新镜像并重新启动：docker pull tianon/plex && docker restart plex。