herdo/plexffmpeg

plexffmpeg 镜像文档

镜像概述

plexffmpeg是基于官方plexinc/plex-docker镜像构建的Docker镜像，已预先集成ffmpeg工具。该镜像旨在解决部分系统（如unRAID）中ffmpeg安装困难的问题，同时为不想单独配置和管理ffmpeg容器的用户提供便捷的一体化解决方案。

核心功能与特性

• 官方基础：基于plexinc官方Plex媒体服务器镜像构建，确保与官方版本的兼容性
• 集成ffmpeg：内置ffmpeg工具，无需额外安装或配置，开箱即可使用
• 多版本支持：提供两个分支版本
  • master：对应Plex最新稳定版
  • plexpass：对应PlexPass订阅用户的测试版

使用场景与适用范围

• 系统限制场景：适用于unRAID等原生环境下ffmpeg安装配置复杂的操作系统
• 简化部署需求：适合希望简化媒体服务器部署流程，避免单独管理ffmpeg容器的用户
• Plex生态用户：需要Plex媒体服务器与ffmpeg协同工作的个人或家庭媒体中心场景

使用方法与配置说明

镜像拉取

根据需求拉取对应分支的镜像：

• 最新稳定版（master分支）：

bash
docker pull plexffmpeg:master

• PlexPass测试版（plexpass分支）：

bash
docker pull plexffmpeg:plexpass

容器运行

基本运行命令示例（需根据实际环境调整路径和参数）：

bash
docker run -d \
  --name plexffmpeg \
  --net=host \
  -e TZ="Asia/Shanghai" \
  -v /your/local/plex/config:/config \
  -v /your/media/files:/media \
  --restart unless-stopped \
  plexffmpeg:master

参数说明：

• --net=host：使用主机网络模式，确保Plex能正常发现和通信（推荐配置）
• -e TZ：设置时区（如"Asia/Shanghai"）
• -v /your/local/plex/config:/config：挂载Plex配置目录
• -v /your/media/files:/media：挂载媒体文件目录
• --restart unless-stopped：设置容器自动重启策略

配置参考

详细配置可参考Plex官方容器文档，本镜像配置方式与官方plexinc/plex-docker保持一致，额外集成的ffmpeg可通过Plex服务器设置界面进行验证和使用。

注意事项

• 确保宿主机网络环境允许Plex所需端口（如32400等）的通信
• 媒体文件目录需正确配置权限，确保容器内进程可访问
• 使用plexpass分支需确保已拥有有效的PlexPass订阅
• 镜像更新时建议先备份Plex配置目录，避免数据丢失