Plex Media Server Docker镜像

镜像概述

Plex Media Server通过组织所有个人媒体、美观呈现并流式传输到所有设备，丰富您的生活。它易于使用、功能强大且免费。本镜像基于Arch Linux AUR构建，包含最新稳定版Plex Media Server。

核心功能与特性

• 媒体组织：集中管理所有个人媒体文件（电影、音乐、照片等）
• 美观呈现：自动整理媒体元数据，提供美观的用户界面
• 多设备流传输：支持将媒体内容流式传输到所有设备（电脑、手机、平板、智能电视等）
• 易用性：简单配置即可使用，无需复杂设置
• 免费：基础功能完全免费

使用场景与适用范围

• 个人媒体库管理：整理和访问个人收藏的电影、音乐和照片
• 家庭媒体中心：构建家庭共享媒体中心，供家庭成员在不同设备上访问
• 多设备访问：随时随地通过各种设备访问媒体内容
• 媒体服务器搭建：需要轻量级、稳定的Plex Media Server部署环境

使用方法与配置说明

基本使用命令

docker run -d \
    --net="host" \
    --name=<容器名称> \
    -v <媒体文件路径>:/media \
    -v <配置文件路径>:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e HEALTHCHECK_COMMAND=<健康检查命令> \
    -e HEALTHCHECK_ACTION=<健康检查操作> \
    -e HEALTHCHECK_HOSTNAME=<健康检查主机名> \
    -e UMASK=<创建文件的权限掩码> \
    -e PUID=<用户ID> \
    -e PGID=<组ID> \
    binhex/arch-plex

参数说明

网络配置

• --net="host": 使用主机网络模式，Plex需要直接访问主机网络以确保正常运行，不支持使用-p端口映射

卷挂载

• -v <媒体文件路径>:/media: 挂载媒体文件目录，Plex将从此目录扫描媒体内容
• -v <配置文件路径>:/config: 挂载配置文件目录，用于持久化存储Plex的配置数据
• -v /etc/localtime:/etc/localtime:ro: 挂载本地时间文件，确保容器内时间与主机一致

环境变量

• HEALTHCHECK_COMMAND: 健康检查命令（可选）
• HEALTHCHECK_ACTION: 健康检查操作（可选）
• HEALTHCHECK_HOSTNAME: 健康检查主机名（可选）
• UMASK: 创建文件的权限掩码，控制新文件的默认权限（例如000表示无权限限制）
• PUID: 运行Plex进程的用户ID，用于权限控制
• PGID: 运行Plex进程的组ID，用于权限控制

访问应用

容器启动后，通过以下地址访问Plex Web界面：
http://<主机IP>:32400/web

使用示例

docker run -d \
    --net="host" \
    --name=plex \
    -v /media/movies:/media \  # 本地电影目录挂载到容器/media
    -v /apps/docker/plex:/config \  # 配置文件存储在本地/apps/docker/plex
    -v /etc/localtime:/etc/localtime:ro \
    -e UMASK=000 \  # 文件权限掩码设为000
    -e PUID=0 \  # 使用root用户（UID 0）运行
    -e PGID=0 \  # 使用root组（GID 0）运行
    binhex/arch-plex

注意事项

用户ID和组ID获取

用户ID（PUID）和组ID（PGID）可通过以下命令获取（替换<username>为实际用户名）：

id <username>

网络模式说明

本镜像必须使用--net="host"（主机网络模式），无法通过-p参数指定端口映射，因为Plex需要直接访问主机网络以确保媒体流传输正常。