powertowerpro/multiplex_stats

MultiPlex Stats

一个用于整合和可视化多个Tautulli/Plex服务器统计数据的Web应用，提供统一仪表板，即使只有一个Plex服务器也能带来极大价值。

!MultiPlex Stats仪表板 !MultiPlex Stats观看历史 !MultiPlex Stats媒体页面 !MultiPlex Stats内容详情 !MultiPlex Stats用户页面

镜像概述和主要用途

MultiPlex Stats是一款专注于Plex媒体服务器统计数据整合与可视化的Web应用。它通过连接Tautulli服务器（Plex监控工具），将分散的媒体播放数据集中展示在统一仪表板中，帮助用户深入了解媒体库使用情况、用户观看习惯和内容流行度，适用于个人媒体服务器管理者和家庭媒体中心用户。

核心功能和特性

• Web界面 - 直接在浏览器中配置服务器和查看分析数据
• 交互式图表 - 使用Highcharts可视化，支持悬停查看详细信息
• 多服务器支持 - 最多可整合2个Tautulli服务器的统计数据
• 用户分析 - 追踪最活跃用户及其观看模式
• 内容洞察 - 发现最受欢迎的电影和电视节目
• 观看历史 - 可搜索的所有观看活动表格
• 趋势分析 - 每日和每月的观看趋势变化
• 实时流地图 - 实时绘制活跃流的地理位置，支持分组标记和每流弹出信息
• 多源评分 - 通过MDBList整合IMDb、烂番茄（影评人和观众）、Metacritic、Letterboxd和TMDb等平台的评分，在媒体表格中显示并使用颜色编码质量指标
• 移除无用内容 - 查看并导出零观看次数的内容数据，释放存储空间
• 真实终身播放计数 - 从完整历史记录构建终身播放次数，合并具有多个Plex键的相同标题，确保播放计数准确且不影响页面加载速度

使用场景和适用范围

• 拥有一个或多个Plex服务器的个人用户，需要集中监控媒体播放情况
• 家庭媒体中心管理者，希望了解家庭成员的观看习惯
• 需要优化媒体库存储，识别并清理无人观看内容的用户
• 希望通过可视化图表直观了解媒体消费趋势的用户

详细使用方法和配置说明

快速开始（Docker）

基础设置

yaml
services:
  multiplex-stats:
    image: docker.xuanyuan.run/powertowerpro/multiplex_stats:latest
    container_name: multiplex-stats
    ports:
      - "8487:8487"
    volumes:
      - ./instance:/app/instance
    environment:
      - PUID=1000
      - PGID=1000
    restart: unless-stopped

运行以下命令启动容器：

bash
docker-compose up -d

在浏览器中访问：http://localhost:8487

预配置设置（可选）

可通过环境变量预配置Tautulli服务器。首次启动时，在设置页面使用"从环境导入"按钮加载配置。

yaml
services:
  multiplex-stats:
    image: docker.xuanyuan.run/powertowerpro/multiplex_stats:latest
    container_name: multiplex-stats
    ports:
      - "8487:8487"
    volumes:
      - ./instance:/app/instance
    environment:
      - PUID=1000
      - PGID=1000
      # 主服务器（必填）
      - TAUTULLI_SERVER_A_NAME=MyServer
      - TAUTULLI_SERVER_A_IP=192.168.1.100:8181
      - TAUTULLI_SERVER_A_KEY=your_api_key_here
      - TAUTULLI_SERVER_A_SSL=false
      - TAUTULLI_SERVER_A_VERIFY_SSL=false
      # 可选的第二个服务器
      # - TAUTULLI_SERVER_B_NAME=Server2
      # - TAUTULLI_SERVER_B_IP=192.168.1.101:8181
      # - TAUTULLI_SERVER_B_KEY=another_api_key
      # - TAUTULLI_SERVER_B_SSL=false
      # - TAUTULLI_SERVER_B_VERIFY_SSL=false
      # 时区（可选，默认America/Los_Angeles）
      # - TZ=America/New_York
      # 仪表板流地图的Stadia Maps API密钥（使用域名验证时可选）
      # - STADIA_MAPS_API_KEY=your_stadia_maps_api_key
      # 用于丰富媒体评分的MDBList API密钥（IMDb、RT、Metacritic等）
      # - MDBLIST_API_KEY=your_mdblist_api_key
    restart: unless-stopped

获取Tautulli API密钥：

1. 在浏览器中打开Tautulli
2. 导航至：设置 > Web界面 > API
3. 复制API密钥

清理重置/重新安装

要完全重置MultiPlex Stats并重新开始（删除所有设置和缓存数据）：

bash
sudo docker stop multiplex-stats && \
sudo rm -rf instance/ && \
sudo docker compose pull multiplex-stats && \
sudo docker compose up -d multiplex-stats

设置页面使用

服务器配置

1. 从导航栏进入"设置"
2. 输入服务器详细信息：
   • 服务器名称 - 友好名称（例如"家庭服务器"）
   • IP地址:端口 - Tautulli地址（例如192.168.1.100:8181）
   • API密钥 - Tautulli API密钥
   • 使用HTTPS/SSL - 勾选如果Tautulli使用HTTPS
   • 验证SSL证书 - 仅在使用有效证书（非自签名）时勾选
   • 服务器顺序 - 选择服务器A（主服务器）或服务器B（次要服务器）
3. 点击"保存服务器"

添加第二个服务器时，重复上述过程并选择"服务器B"。

导入观看历史

MultiPlex Stats需要在设置页面从Tautulli进行一次性数据加载。点击"导入数据"时将自动执行以下步骤：

步骤1 — 媒体同步 → 填充cached_media表 从每个已配置的Tautulli服务器导入电影和电视节目库（标题、海报、元数据等）

步骤2 — 历史同步 + 终身缓存重建 → 填充viewing_history表，然后重建lifetime_media_play_count表 从每个服务器导入完整的观看历史（播放记录）到viewing_history表 完成后，扫描所有本地历史记录行以重建lifetime_media_play_count表，合并可能具有不同评分键的标题的播放计数

两个步骤作为单个"完整数据同步"流程按顺序运行，由一个按钮触发。初始加载后，刷新仪表板时会自动追加新记录。

隐私与安全

• 所有数据保留在本地（使用的外部服务：流地图的IP地理定位，以及可选的媒体评分增强的MDBList）
• API密钥存储在本地SQLite数据库中
• 无遥测或跟踪功能

实时流地图

仪表板包含当前活动的实时流地图。活跃的WAN会话按位置分组，使用服务器感知的标记样式渲染在地图上，弹出窗口显示每个活跃会话的流标题、用户、服务器、平台和播放质量。

私有或未解析的IP地址不会以虚假坐标绘制。本地/私有会话在地图摘要中单独计数，未解析的查询不会显示在地图上（不会回退到0,0）。

配置免费Stadia API密钥时，实时流地图使用Stadia Maps的Alidade Smooth Dark瓦片。在容器环境中设置STADIA_MAPS_API_KEY或在设置中保存密钥。如果没有Stadia密钥，MultiPlex Stats会自动回退到CARTO的dark_all底图。

支持

• 问题反馈：https://github.com/apollolabsai/MultiPlex-Stats/issues
• 版本发布：https://github.com/apollolabsai/MultiPlex-Stats/releases

许可证

本项目是开源的，基于MIT许可证。

鸣谢

• Tautulli - 提供API的Plex监控工具