plex101/plex-docker

plex101/plex-docker

镜像概述

plex101/plex-docker是Plex Media Server的Docker容器镜像，用于快速搭建个人媒体服务器。通过该镜像部署的Plex服务器，结合全平台Plex应用（支持手机、平板、流媒体设备、游戏主机及智能电视），可实现视频、音乐和照片收藏的跨设备、跨地点流式传输。

核心功能与特性

• 支持三种网络模式：bridge（默认）、host、macvlan，满足不同网络环境需求
• 灵活的媒体文件挂载，支持自定义媒体库路径
• 可配置转码临时文件存储路径，优化性能
• 提供丰富的环境变量参数，支持时区设置、服务器认领、网络广告IP等配置
• 兼容Docker Compose，提供模板文件便于部署

使用场景与适用范围

• 个人或家庭媒体服务器搭建，集中管理媒体资源
• 需要在多设备（如智能电视、手机、平板）上访问媒体收藏的用户
• 具备Docker环境的设备（如NAS、个人服务器、台式电脑）
• 对网络配置有不同需求（如端口转发、独立IP）的场景

使用方法

网络模式选择

部署前需确定网络模式，主要有三种：

• bridge：默认模式，创建独立网络，通过端口转发与主机网络连接，配置较复杂
• host：使用主机IP，容器网络表现为宿主机网络，配置简单
• macvlan：创建网络虚拟设备，分配独立IP，与host模式配置类似

推荐优先使用host或macvlan模式，配置简单且问题较少；bridge模式需额外处理端口转发等问题。

Host网络模式

bash
docker run \
-d \
--name plex \
--network=host \
-e TZ="<时区>" \
-e PLEX_CLAIM="<认领令牌>" \
-v <Plex数据库路径>:/config \
-v <转码临时路径>:/transcode \
-v <媒体文件路径>:/data \
docker.xuanyuan.run/plex101/plex-docker

参数说明：

• --network=host：使用主机网络
• TZ：设置时区（如"Asia/Shanghai"）
• PLEX_CLAIM：Plex服务器认领令牌，从Plex认领页面获取
• /config：挂载Plex数据库目录，用于存储配置数据
• /transcode：挂载转码临时文件目录
• /data：挂载媒体文件目录（可根据需要添加多个）

Macvlan网络模式

bash
docker run \
-d \
--name plex \
--network=physical \
--ip=<容器IP地址> \
-e TZ="<时区>" \
-e PLEX_CLAIM="<认领令牌>" \
-h <主机名> \
-v <Plex数据库路径>:/config \
-v <转码临时路径>:/transcode \
-v <媒体文件路径>:/data \
docker.xuanyuan.run/plex101/plex-docker

与Host模式的区别：

• --network=physical：指定macvlan网络（需提前创建，名称可能不同）
• --ip：指定容器IP地址（可选，覆盖网络默认IP分配）
• -h：设置容器主机名（macvlan模式不使用宿主机名）

Bridge网络模式

bash
docker run \
-d \
--name plex \
-p 32400:32400/tcp \
-p 3005:3005/tcp \
-p 8324:8324/tcp \
-p 32469:32469/tcp \
-p 1900:1900/udp \
-p 32410:32410/udp \
-p 32412:32412/udp \
-p 32413:32413/udp \
-p 32414:32414/udp \
-e TZ="<时区>" \
-e PLEX_CLAIM="<认领令牌>" \
-e ADVERTISE_IP="http://<宿主机IP>:32400/" \
-h <主机名> \
-v <Plex数据库路径>:/config \
-v <转码临时路径>:/transcode \
-v <媒体文件路径>:/data \
docker.xuanyuan.run/plex101/plex-docker

额外配置要求：

• 远程访问：需在路由器手动设置端口转发，将外部端口转发至ADVERTISE_IP指定的宿主机IP和32400端口
• Plex Pass用户：设置LAN Networks偏好，指定局域网网段（如"192.168.1.0/24,172.16.0.0/16"），确保带宽控制正确应用

参数说明

端口映射

• -p 32400:32400/tcp：Plex主通信端口，必须映射
• 其他端口：根据需求映射，完整端口说明见Plex网络端口文档

卷挂载

• -v <path>:/config：Plex数据库目录，存储配置数据（注意：底层文件系统需支持文件锁定，远程文件系统如NFS、SMB可能导致数据库损坏）
• -v <path>:/transcode：转码临时文件目录，建议单独挂载（大小通常为几十GB）
• -v <path>:/data：媒体文件目录（可根据媒体类型添加多个，如-v /movies:/data/movies）

环境变量

推荐参数（首次运行有效）

• TZ：容器时区，如"Asia/Shanghai"（时区列表见时区数据库）
• PLEX_CLAIM：服务器认领令牌，用于将服务器关联到Plex账户（从Plex认领页面获取）
• HOSTNAME：容器主机名（Host模式无需设置）
• ADVERTISE_IP：服务器广告IP，仅Bridge模式需要（如"[***]"）

可选参数（首次运行有效）

• PLEX_UID：容器内plex用户ID
• PLEX_GID：容器内plex用户组ID
• CHANGE_CONFIG_DIR_OWNERSHIP：是否修改/config目录所有权（默认true，若权限已配置可设为false加速首次启动）
• ALLOWED_NETWORKS：无需授权的IP/子网（如"192.168.1.0/24"），建议未登录服务器时使用