linuxserver/plexpy Docker镜像文档

镜像概述和主要用途

重要提示：该镜像已弃用（DEPRECATED）
请使用替代镜像：linuxserver/tautulli，现有数据可继续使用。

linuxserver/plexpy 是由 LinuxServer.io 团队维护的Docker镜像，用于部署 Plexpy 应用。Plexpy 是一款基于Python的Plex媒体服务器使用跟踪工具，可监控Plex服务器的用户活动、媒体访问记录等使用情况，目前处于积极开发阶段。

核心功能和特性

• Plex使用跟踪：实时监控Plex媒体服务器的用户访问、观看时长、媒体类型等数据。
• 数据统计与报表：生成用户观看***惯、热门媒体、访问频率等统计报表。
• 轻量级架构：基于Alpine Linux构建，体积小、资源占用低。
• 配置持久化：支持数据卷挂载，确保配置文件和数据库持久化存储。
• 用户权限控制：通过PUID/PGID参数实现容器内用户与主机用户权限映射，避免文件权限冲突。

使用场景和适用范围

适用于需要监控Plex媒体服务器使用情况的个人或管理员，尤其适合：

• 家庭或小型团队Plex服务器管理员，需跟踪用户观看行为。
• 需要统计媒体资源访问频率、热门内容的场景。
• 希望通过Web界面直观查看Plex服务器活动日志的用户。

使用方法和配置说明

容器创建命令

docker create \ 
  --name=plexpy \
  -v <主机数据路径>:/config \
  -v <主机Plex日志路径>:/logs:ro \
  -e PGID=<组ID> -e PUID=<用户ID>  \
  -e TZ=<时区> \
  -p 8181:8181 \
  linuxserver/plexpy

创建容器后，通过以下命令启动：

docker start plexpy

参数详解

端口映射（-p）

• -p 8181:8181：将容器内Web UI端口8181映射到主机的8181端口，通过http://<主机IP>:8181访问Plexpy界面。

数据卷挂载（-v）

• -v <主机数据路径>:/config：挂载配置目录，用于持久化Plexpy的配置文件、数据库等数据。
  示例：-v /home/user/plexpy/config:/config
• -v <主机Plex日志路径>:/logs:ro：挂载Plex媒体服务器的日志目录（只读权限），Plexpy需读取日志以跟踪使用情况。
  示例：-v /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Logs:/logs:ro

环境变量（-e）

• -e PUID=<用户ID>：指定容器内运行应用的用户ID，避免文件权限冲突。
• -e PGID=<组ID>：指定容器内运行应用的组ID，与PUID配合使用。
  获取方法：在主机终端执行 id <用户名>，输出中的uid=xxx(用户)即为PUID，gid=xxx(组)即为PGID。
• -e TZ=<时区>：设置容器时区，格式为 Continent/City，如 Asia/Shanghai（中国上海）、Europe/London（欧洲伦敦）。

用户/组标识符（PUID/PGID）

容器通过PUID和PGID参数确保内部进程与主机用户权限一致，避免挂载数据卷时出现权限错误。例如，若主机用户的PUID=1000、PGID=1000，需将参数设置为 -e PUID=1000 -e PGID=1000，确保容器内用户对挂载的/config和/logs目录有正确的读写权限。

应用设置

1. 容器启动后，通过浏览器访问 http://<主机IP>:8181 打开Plexpy Web UI。
2. 首次使用需配置Plex媒体服务器连接：在界面中输入Plex服务器的IP、端口及访问令牌（可从Plex服务器设置中获取）。
3. 配置完成后，即可查看实时使用统计、历史记录、用户活动等数据。

容器管理信息

实时监控日志

docker logs -f plexpy

查看容器版本

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

查看镜像版本

docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/plexpy

版本历史

• 12.12.17：重新基于Alpine 3.7构建。
• 21.07.17：优化内部Git拉取流程，替代运行时拉取。
• 12.07.17：更新README，添加镜像检查命令，迁移至Jenkins构建推送流程。
• 25.05.17：重新基于Alpine 3.6构建。
• 20.04.17：添加py***domex pip包。
• 07.02.17：重新基于Alpine 3.5构建。
• 09.09.16：在README中添加分层徽章。
• 27.08.16：在README中添加镜像徽章。
• 08.08.16：重新基于Alpine Linux构建。
• 16.07.15：初始发布。