热门搜索:
pabloromeo/clusterplex_worker
pabloromeo
ClusterPlex Worker镜像用于在集群中分布式处理Plex媒体服务器的转码请求，通过与转码编排器通信接收任务，支持动态扩展，确保高效的媒体转码处理。
下载次数: 0状态：社区镜像维护者：pabloromeo仓库类型：镜像最近更新：2 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
ClusterPlex Worker 镜像
概述
ClusterPlex Worker是ClusterPlex分布式转码系统的核心组件之一，负责接收转码编排器分配的转码任务并执行实际的媒体转码操作。它与Plex媒体服务器（PMS）配合工作，通过集群化部署实现转码任务的分布式处理，提升系统的可扩展性和可用性。
核心功能与特性
- 分布式转码：接收转码编排器分配的任务，在集群节点上并行处理转码请求
- 动态扩展：支持集群中Worker节点的动态上下线，由编排器自动管理注册与可用性
- 灵活部署：提供两种部署方式（推荐使用官方Plex镜像配合Worker dockermod，或使用自定义Worker镜像）
- 编解码器持久化：支持编解码器缓存路径挂载，避免重复下载，提升启动速度
使用场景
- 大规模Plex媒体服务器部署，需要分担高并发转码负载
- 多节点集群环境（如Kubernetes、Docker Swarm）中的媒体转码任务分发
- 需要弹性扩展转码能力以应对峰值需求的场景
组件构成
Worker组件有两种部署方式：
- 推荐：基于官方LinuxServer Plex镜像（ghcr.io/linuxserver/plex:latest），配合ClusterPlex Worker dockermod（ghcr.io/pabloromeo/clusterplex_worker_dockermod:latest）
- 自定义Docker镜像：直接使用ClusterPlex Worker专用镜像（ghcr.io/pabloromeo/clusterplex_worker:latest）
工作原理
- Worker启动后向转码编排器注册，报告自身可用性
- 接收编排器通过WebSocket分发的转码任务
- 执行转码操作，并通过PMS上的本地中继（Local Relay）向PMS报告进度
- 支持动态上下线，编排器会自动更新可用Worker列表
系统要求
共享存储
需使用支持ReadWriteMany（RWX）的网络共享存储，确保以下路径在PMS和所有Worker间保持一致：
- 媒体库路径：所有媒体内容的存储路径，必须在PMS和Worker间保持完全一致
- 转码路径：默认为
/transcode，可自定义但需在PMS和所有Worker间统一，并在Plex中配置为转码路径
非共享持久化存储
- 编解码器路径：Worker需要
/codecs目录存储下载的编解码器，建议挂载为持久卷以保留编解码器缓存，避免重复下载。该目录会自动创建按Plex版本和架构划分的子目录
配置与使用
环境变量
Worker支持以下关键环境变量配置：
| 环境变量 | 描述 | 默认值 |
|---|---|---|
ORCHESTRATOR_URL | 转码编排器的WebSocket地址 | ws://orchestrator:3000 |
CODECS_PATH | 编解码器存储路径 | /codecs |
LOCAL_RELAY_ENABLED | 是否启用本地中继转发 | "1"（启用） |
PMS_HOST | PMS服务器地址（当本地中继禁用时需要） | - |
部署示例
Docker Run（使用dockermod方式）
bashdocker run -d \ --name=clusterplex-worker \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ -e ORCHESTRATOR_URL=ws://orchestrator:3000 \ -v /path/to/media:/media \ -v /path/to/transcode:/transcode \ -v /path/to/codecs:/codecs \ --label "dockermod=ghcr.io/pabloromeo/clusterplex_worker_dockermod:latest" \ ghcr.io/linuxserver/plex:latest
Docker Run（使用自定义Worker镜像）
bashdocker run -d \ --name=clusterplex-worker \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ -e ORCHESTRATOR_URL=ws://orchestrator:3000 \ -v /path/to/media:/media \ -v /path/to/transcode:/transcode \ -v /path/to/codecs:/codecs \ ghcr.io/pabloromeo/clusterplex_worker:latest
网络配置
当LOCAL_RELAY_ENABLED设置为"0"（禁用）时，需在Plex的网络配置中，将Worker所在的IP或IP范围添加到"无需身份验证的IP地址和网络列表"中，确保Worker能正常与PMS通信。
注意事项
- 媒体库和转码路径在所有Worker和PMS间必须保持完全一致的路径
- 编解码器路径建议持久化挂载，以提高Worker重启速度
- 确保共享存储系统性能满足转码需求，避免成为性能瓶颈
- 在Kubernetes或Docker Swarm环境中，建议将Worker部署为可扩展的服务，以应对负载变化
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 clusterplex_worker 镜像标签
docker pull docker.xuanyuan.run/pabloromeo/clusterplex_worker:<标签>
DockerHub 原生拉取命令
docker pull pabloromeo/clusterplex_worker:<标签>
更多 clusterplex_worker 镜像推荐
pabloromeo/clusterplex
pabloromeo
ClusterPlex仓库已拆分为多个独立组件仓库（Orchestrator、Worker、PMS等），并迁移至ghcr.io，旧仓库不再更新，最新文档和使用说明请访问指定GitHub地址。
3 次收藏10万+ 次下载
4 年前更新
pabloromeo/clusterplex_orchestrator
pabloromeo
ClusterPlex Orchestrator是ClusterPlex的核心组件，作为Node.js应用接收来自PMS的转码请求，通过WebSocket将请求转发给集群中可用的转码工作节点，管理节点注册与可用性，实现分布式转码任务协调。
1 次收藏1万+ 次下载
2 天前更新
pabloromeo/clusterplex_pms
pabloromeo
ClusterPlex是Plex的扩展版本，支持跨集群的分布式转码工作节点处理转码请求，已在Kubernetes和Docker Swarm上测试，通过转码编排器管理工作节点的注册与可用性。
1万+ 次下载
2 天前更新
镜像拉取常见问题
功能
排错
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"