greensheep/plex-server-docker-rpi

Raspberry Pi 的 Plex 服务器

一种在树莓派上通过 Docker 运行 Plex 媒体服务器的简单方法。

注意：不支持 Pi 1。

镜像概述与主要用途

该镜像旨在为树莓派用户提供便捷的 Plex 媒体服务器部署方案，通过 Docker 容器化技术，简化安装和配置流程，实现媒体文件的集中管理与流式播放。适用于家庭媒体中心搭建，支持多设备访问。

核心功能与特性

• 容器化部署：通过 Docker 实现 Plex 服务器的隔离运行，简化环境配置
• 持久化存储：支持本地目录挂载，保存 Plex 配置文件和媒体数据
• 自动重启：配置容器自动重启，确保服务稳定性
• 网络优化：使用主机网络模式，保障媒体流传输效率

使用场景与适用范围

• 家庭媒体中心搭建，集中管理电影、音乐、照片等媒体文件
• 多设备（智能电视、手机、平板等）通过 Plex 客户端访问媒体内容
• 适用硬件：树莓派 2 及以上型号（Pi 1 不支持）

使用方法与配置说明

前提条件

1. 在树莓派上安装 Docker，推荐使用官方脚本：

   bash
   curl -sSL https://get.docker.com | sh
   

   来源：[**]

2. 创建本地目录用于存储 Plex 配置和媒体数据（建议使用外部硬盘以应对大容量需求）：

   bash
   mkdir -p ~/media/plex/{config,data}
   

启动 Plex 服务器

使用以下命令启动容器，挂载上述创建的目录：

bash
docker run \
  -d \
  --name plex \
  --net host \
  -p 32400:32400 \
  --restart always \
  --volume $(echo $HOME)/media/plex/config:/config \
  --volume $(echo $HOME)/media/plex/data:/data \
  greensheep/plex-server-docker-rpi:latest

启动后约 30 秒，可通过 http://{树莓派IP地址}:32400/web 访问 Plex 网页管理界面。

更新方法

Plex 无法通过网页界面更新，需执行以下命令更新镜像并重启容器：

bash
docker pull greensheep/plex-server-docker-rpi:latest
docker stop plex
docker rm -f plex
# 重新执行上述 docker run 命令

转码说明

树莓派性能不足以支持媒体转码，但对于支持直接播放的媒体文件，可正常流式传输。已在 Pi 2（Hypriot 系统）和 Pi 3（Arch 系统）上测试通过。

播放故障解决

若媒体应支持直接播放但出现问题，且媒体文件存储在外部驱动器时，可尝试设置转码临时目录：

1. 在数据目录下创建转码文件夹：

   bash
   mkdir {数据目录路径}/transcode
   

2. 在 Plex 管理界面中设置：设置 -> 服务器 -> 转码 -> 转码临时目录，填入 /data/transcode

原因：SD 卡容量通常较小（16/32/64GB 等），易因空间不足导致转码失败（参考 Plex 论坛帖子）。

开发构建

如需自行构建镜像，可使用项目中的 docker-compose.yml 文件：

bash
docker-compose build
docker-compose up