mirror of https://github.com/SeanChang/xuanyuan_docker_proxy.git synced 2026-10-07 12:58:54 +08:00

Files

T

新增镜像中文简介

2026-07-13 00:37:24 +08:00

12 KiB

Raw Permalink Blame History

image, description, source, canonical, exported_at

image	description	source	canonical	exported_at
linuxserver/plex	这是由LinuxServer.io为您提供的Plex Media Server容器，它是一款集成了Plex媒体服务器软件的轻量级、可移植Docker容器，能够帮助用户高效组织电影、音乐、照片等各类媒体文件，并支持跨设备流式传输与访问，适用于搭建个人或家庭媒体中心；LinuxServer.io作为专注开源容器开发的组织，致力于提供高质量、易于部署的容器镜像，此Plex Media Server容器便是其优质作品，为媒体管理与分享带来便捷体验。	https://xuanyuan.cloud/zh/r/linuxserver/plex	https://xuanyuan.cloud/zh/r/linuxserver/plex	2026-07-12T16:36:12.930Z

轩辕镜像中文简介（在线版）： linuxserver/plex 中文简介

含镜像标签、拉取命令、部署文档与相关推荐。

LinuxServer.io Plex 容器介绍

LinuxServer.io 团队简介

[LinuxServer.io] 团队专注于提供高质量容器化应用，其容器具有以下特点：

定期、及时的应用更新
简单的用户权限映射（通过 PGID、PUID）
基于 s6 overlay 的自定义基础镜像
每周更新基础操作系统，通过共享通用层减少存储空间占用、 downtime 和带宽消耗
常规安全更新

社区与支持

如需了解更多或寻求帮助，可通过以下渠道联系我们：

[博客] ：包含容器使用指南、教程和观点文章
：实时社区聊天与技术支持
[Discourse] ：社区论坛，可发布问题和讨论
[GitHub] ：查看所有仓库源码
[Open Collective] ：支持我们的开发工作（捐赠或贡献预算）

linuxserver/plex 容器

[Plex] 是一款媒体服务器软件，可整理个人媒体库（视频、音乐、照片）并流式传输到智能电视、机顶盒和移动设备。本容器为独立的 Plex Media Server 打包版本，设计简洁，支持批量操作，提升使用效率。

支持的架构

容器通过 Docker manifest 实现多平台支持，拉取 lscr.io/linuxserver/plex:latest 即可自动匹配对应架构。也可通过标签指定具体架构：

架构	支持状态	标签格式
x86-64	✅	amd64-<version tag>
arm64	✅	arm64v8-<version tag>

应用设置

Web 管理界面地址：<你的IP>:32400/web

版本更新说明

注意：若未设置 VERSION 变量，容器不会自动更新 Plex。
注意：新用户首次运行容器时不会触发更新（因缺少偏好文件中的令牌），需通过 Web 界面登录后重启容器以应用更新。

VERSION 变量的有效值：

docker：由 Docker 管理版本（默认，保持与 Dockerhub 镜像同步）
latest：更新至当前账号有权访问的最新版本
public：PlexPass 用户可更新至最新公开版本（避免测试版）
<specific-version>：指定具体版本（如 0.9.12.4.1192-9a47d21），需注意：非 PlexPass 账号无法访问测试版

硬件加速

Intel/ATI/AMD

需将显卡设备挂载到容器内：

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

容器会自动配置 abc 用户对设备的访问权限。

Nvidia

需先在主机安装 [nvidia-container-toolkit] ，然后启动容器时添加：

--runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all

（NVIDIA_VISIBLE_DEVICES 可指定 GPU 的 UUID，通过 nvidia-smi --query-gpu=gpu_name,gpu_uuid --format=csv 获取）

Arm 设备

大多数 Arm 设备（如树莓派 4）需在 /boot/usercfg.txt 中启用 dtoverlay=vc4-fkms-v3d，容器会自动识别 /dev/dri 设备。

只读模式运行

容器支持只读文件系统，详情参考 [官方文档] 。

限制：

不支持运行时更新 Plex（含 PlexPass 测试版）
需将转码目录挂载到主机路径或 tmpfs

非 root 用户运行

容器支持非 root 用户运行，详情参考 [官方文档] 。

限制：

不支持运行时更新 Plex（含 PlexPass 测试版）
需将转码目录挂载到主机路径或 tmpfs

使用方法

docker-compose（推荐）

---  
services:  
  plex:  
    image: docker.xuanyuan.run/linuxserver/plex:latest  
    container_name: plex  
    network_mode: host  
    environment:  
      - PUID=1000          # 用户ID（必填）  
      - PGID=1000          # 组ID（必填）  
      - TZ=Etc/UTC         # 时区（必填，如 Asia/Shanghai）  
      - VERSION=docker     # 版本控制（必填，参考上文说明）  
      - PLEX_CLAIM=        # 可选，Plex 服务器认领令牌（从 [] 获取，4分钟内有效）  
    volumes:  
      - /path/to/plex/library:/config  # Plex 配置目录（必填，建议预留50GB以上空间）  
      - /path/to/tvseries:/tv          # 电视剧目录（可选，可添加多个）  
      - /path/to/movies:/movies        # 电影目录（可选，可添加多个）  
    restart: unless-stopped

docker cli

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/plex/library:/config \  
  -v /path/to/tvseries:/tv \  
  -v /path/to/movies:/movies \  
  --restart unless-stopped \  
  lscr.io/linuxserver/plex:latest

参数说明

参数	作用
`--net=host`	使用主机网络模式（推荐）
`-e PUID=1000`	用户ID，用于权限映射（通过 `id 你的用户名` 查看）
`-e PGID=1000`	组ID，同上
`-e TZ=Etc/UTC`	时区，如 `Asia/Shanghai`
`-e VERSION=docker`	版本控制（见“应用设置”部分）
`-e PLEX_CLAIM=`	Plex 认领令牌（可选，有效期4分钟）
`-v /config`	Plex 配置目录（存储媒体库信息，需大容量空间）
`-v /tv`	媒体目录（可添加多个，如 `/movies`、`/photos`）
`--read-only=true`	只读模式运行（需配合文档配置）
`--user=1000:1000`	非 root 用户运行（指定 UID:GID）

环境变量与文件（Docker Secrets）

可通过 FILE__ 前缀从文件加载环境变量，例如：

-e FILE__MYVAR=/run/secrets/mysecretvariable

容器会将 /run/secrets/mysecretvariable 文件内容作为 MYVAR 的值。

Umask 设置

通过 -e UMASK=022 自定义服务的文件权限掩码（参考 umask 说明）。

可选参数

桥接网络模式（不推荐）

若需使用桥接模式（非 host 网络），需映射端口（[官方端口说明] ）：

-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           # 可选

首次设置需通过 PLEX_CLAIM 认领服务器。

设备挂载

硬件加速：--device=/dev/dri:/dev/dri（Intel/AMD）
DVB 调谐器：--device=/dev/dvb:/dev/dvb

用户/组标识符

使用 -v 挂载卷时，需确保主机目录所有者与容器内 PUID/PGID 一致，避免权限问题。通过以下命令查看当前用户的 UID/GID：

id 你的用户名

示例输出：

uid=1000(你的用户名) gid=1000(你的用户名) groups=1000(你的用户名)

Docker Mods

可通过 [Docker Mods] 扩展容器功能，查看可用模块：

[Plex 专用 Mods]
[通用 Mods]

支持信息

进入运行中的容器：
```
docker exec -it plex /bin/bash  
```
实时查看日志：
```
docker logs -f plex  
```

查看容器版本：

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

查看镜像版本：

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

更新说明

通过 docker-compose

更新镜像：

docker-compose pull  # 更新所有镜像  
# 或  
docker-compose pull plex  # 仅更新 plex

重启容器：

docker-compose up -d  # 重启所有容器  
# 或  
docker-compose up -d plex  # 仅重启 plex

清理旧镜像：
```
docker image prune  
```

通过 docker cli