lsiodev/plex

linuxserver/plex

Plex 可组织个人媒体库中的视频、音乐和照片，并将其流式传输到智能电视、流媒体盒子和移动设备。此容器打包为独立的Plex Media Server，设计简洁且支持批量操作，提高使用效率。

!plex

支持的架构

我们利用Docker manifest实现多平台支持。直接拉取 lscr.io/linuxserver/plex:latest 即可获取对应架构的镜像，也可通过标签拉取特定架构镜像。

支持的架构：

应用设置

Web界面可通过 <你的IP>:32400/web 访问。

关于更新的注意事项：若未设置VERSION变量，则不会进行更新。
新用户注意：首次运行容器时不会更新，因为没有偏好文件读取令牌，需通过Web界面登录后重启Docker容器以更新。

VERSION的有效值：

重要提示：若未使用PlexPass账户登录，无法更新到仅PlexPass可用的（测试版）版本

• docker：让Docker管理Plex版本，我们会保持Dockerhub端点与最新公共版本同步（与不设置此参数效果相同）。
• latest：将Plex更新到你有权访问的最新版本。
• public：PlexPass用户更新到最新公共版本，适合不想使用前沿版本但需最新公共更新的用户。
• <specific-version>：安装特定版本（如0.9.12.4.1192-9a47d21），无PlexPass则无法访问PlexPass版本。

硬件加速

Intel

使用Intel QuickSync硬件加速的用户需将/dev/dri视频设备挂载到容器中，运行或创建容器时添加以下命令：

--device=/dev/dri:/dev/dri

容器会自动确保内部abc用户拥有访问该设备的适当权限。

Nvidia

使用Nvidia硬件加速的用户需在主机上安装Nvidia提供的容器运行时，详见：
https://github.com/NVIDIA/nvidia-docker

我们会自动添加必要的环境变量以利用主机GPU的所有功能。安装nvidia-docker后，需使用nvidia容器运行时重新创建容器：--runtime=nvidia，并添加环境变量 -e NVIDIA_VISIBLE_DEVICES=all（也可设为特定GPU的UUID，通过 nvidia-smi --query-gpu=gpu_name,gpu_uuid --format=csv 查看）。NVIDIA会自动将主机的GPU和驱动挂载到Plex容器中。

使用方法

可通过docker-compose（推荐）或docker cli创建容器。

docker-compose（推荐，点击查看更多信息）

yaml
---
version: "2.1"
services:
  plex:
    image: lscr.io/linuxserver/plex:latest
    container_name: plex
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - VERSION=docker
      - PLEX_CLAIM= #可选
    volumes:
      - /path/to/library:/config
      - /path/to/tvseries:/tv
      - /path/to/movies:/movies
    restart: unless-stopped

docker cli（点击查看更多信息）

bash
docker run -d \
  --name=plex \
  --net=host \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e VERSION=docker \
  -e PLEX_CLAIM= `#可选` \
  -v /path/to/library:/config \
  -v /path/to/tvseries:/tv \
  -v /path/to/movies:/movies \
  --restart unless-stopped \
  lscr.io/linuxserver/plex:latest

参数

容器通过运行时参数配置，格式为 <外部>:<内部>。例如 -p 8080:80 表示将容器内80端口映射到主机8080端口。

来自文件的环境变量（Docker secrets）

可通过特殊前缀 FILE__ 从文件设置环境变量。例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这会将环境变量 MYVAR 设置为 /run/secrets/mysecretvariable 文件的内容。

应用运行的Umask设置

所有镜像支持通过可选参数 -e UMASK=022 覆盖容器内服务的默认umask设置。注意umask是权限减法而非加法，详情参考umask说明。

可选参数

若要使用桥接网络模式（非推荐的主机网络模式），需指定端口。官方端口文档 指出32400是唯一必填端口，其他端口用于特定功能。首次设置未声明服务器时，需设置 PLEX_CLAIM 以声明桥接网络模式下的服务器。

  -p 32400:32400 \
  -p 1900:1900/udp \
  -p 5353:5353/udp \
  -p 8324:8324 \
  -p 32410:32410/udp \
  -p 32412:32412/udp \
  -p 32413:32413/udp \
  -p 32414:32414/udp \
  -p 32469:32469

应用接受一系列环境变量以进一步自定义启动：

用户/组标识符

使用卷（-v 标志）时，主机OS与容器可能出现权限问题。通过指定用户 PUID 和组 PGID 可避免此问题。确保主机上的卷目录归指定用户所有，权限问题将解决。

示例中 PUID=1000 和 PGID=1000，可通过 id your_user 命令获取你的ID：

bash
id your_user

输出示例：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

我们发布多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E5%A2%9E%E5%BC%BA%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%E3%80%82%E4%B8%8A%E8%BF%B0%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E5%8F%AF%E8%AE%BF%E9%97%AE%E6%AD%A4%E9%95%9C%E5%83%8F%E7%9A%84%E5%8F%AF%E7%94%A8mods%E5%8F%8A%E9%80%82%E7%94%A8%E4%BA%8E%E6%89%80%E6%9C%89%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8mods%E3%80%82

支持信息

• 容器运行时的Shell访问：

  bash
  docker exec -it plex /bin/bash
  

• 实时监控容器日志：

  bash
  docker logs -f plex
  

• 容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' plex
  

• 镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/plex:latest
  

更新信息

大多数镜像为静态、版本化，需更新镜像并重建容器以更新内部应用。部分例外（如nextcloud、plex）不建议在容器内更新应用。请参考应用设置部分确认是否推荐。

以下是更新容器的说明：

通过Docker Compose

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull plex
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d plex
    

• 移除旧的悬空镜像：

  bash
  docker image prune
  

通过Docker Run

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/plex:latest
  

• 停止运行中的容器：

  bash
  docker stop plex
  

• 删除容器：

  bash
  docker rm plex
  

• 使用相同的docker run参数重建容器（若正确映射到主机文件夹，/config文件夹和设置将保留）

• 移除旧的悬空镜像：

  bash
  docker image prune
  

通过Watchtower自动更新（仅在忘记原始参数时使用）

• 拉取最新镜像并使用相同环境变量替换：

  bash
  docker run --rm \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower \
    --run-once plex
  

• 移除旧的悬空镜像：docker image prune

警告：不建议使用Watchtower作为现有Docker容器的自动更新解决方案。但对于忘记原始参数的容器，这是一次性手动更新的有用工具。长期建议使用Docker Compose。

镜像更新通知 - Diun（Docker镜像更新通知器）

提示：推荐使用Diun获取更新通知。不推荐或支持其他自动更新容器的工具。

本地构建

若需修改镜像进行开发或自定义：

bash
git clone https://github.com/linuxserver/docker-plex.git
cd docker-plex
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/plex:latest .

可使用 multiarch/qemu-user-static 在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后，使用 -f Dockerfile.aarch64 指定Dockerfile。

版本历史

• 16.08.23：从https://github.com/linuxserver/docker-unrar%E5%AE%89%E8%A3%85unrar%E3%80%82
• 03.07.23：弃用armhf，详见公告。
• 16.10.22：基于jammy重建，更新至s6v3，移除opencl包（Plex已内置）。
• 18.07.22：固定所有opencl相关驱动包版本。
• 16.05.22：固定opencl版本。
• 04.03.22：增加视频设备权限修复的详细日志，尝试修复组读写权限缺失问题。
• 25.12.21：从官方仓库安装Intel驱动。
• 20.01.21：弃用 UMASK_SET，改用基础镜像中的UMASK，详见上文。
• 10.12.20：从github仓库添加最新Intel Compute包，支持最新代核显的opencl。
• 23.11.20：添加Bionic分支，Focal为默认。
• 03.05.20：更新桥接模式的暴露端口和示例文档。
• 23.03.20：移除udev hack（不再需要），抑制首次启动时日志中的uuid错误。
• 04.12.19：添加PLEX_CLAIM变量设置，移除/transcode卷映射（现在通过Plex GUI设置，默认位于/config下）。
• 06.08.19：添加UMASK设置变量。
• 10.07.19：修复调谐器（/dev/dvb）设备权限。
• 20.05.19：修复Intel QuickSync所有权规则不允许Root组的问题。
• 23.03.19：切换到新基础镜像，使用arm32v7标签。
• 22.03.19：修复 VERSION=public 的更新逻辑。
• 14.03.19：切换到新API端点，支持armhf和aarch64的测试版（Plex Pass）更新。
• 15.02.19：在非干净停止后清理Plex pid。
• 11.02.19：修复nvidia变量，添加设备变量。
• 16.01.19：添加流水线逻辑、多架构和硬件转码配置，移除avahi服务。
• 07.09.18：基于ubuntu bionic重建，添加udev包。
• 09.12.17：修复续行符。
• 12.07.17：添加README中的检查命令，移至jenkins构建和推送。
• 28.05.17：根据需求添加unrar包，用于subzero插件。
• 11.01.17：使用Plex环境变量，将abc主文件夹改为/app以减少usermod对库的chown操作。
• 03.01.17：使用不区分大小写的版本变量匹配，而非导出并转为小写。
• 17.10.16：允许使用大写版本变量。
• 01.10.16：在README中添加时区信息。
• 09.09.16：在README中添加层徽章。
• 27.08.16：在README中添加徽章。
• 22.08.16：基于xenial和s6 overlay重建。
• 07.04.16：移除/transcode卷支持（上游Plex变更），修改PlexPass下载方法以防止未授权使用付费PMS。
• 24.09.15：添加可选的转码卷（/transcode）支持，修复多处拼写错误。
• 17.09.15：改为仅运行一次chmod。