Repolode
connorgallopo

connorgallopo/Tracearr

统一监控 Plex、Jellyfin 和 Emby 服务器的播放会话、观看数据与账号共享情况的自托管面板。

Star
2,743
Fork
122
未关闭 Issue
2
最近提交
23小时前

这是什么?

Tracearr 是一个自托管的监控平台,面向 Plex、Jellyfin 和 Emby 服务器。它可以在一个页面上查看多台服务器的实时播放会话和运行状态,并保存完整的观看历史,包括谁在何时、在哪台设备上看了什么,每条播放还附带地理位置信息。

在数据分析方面,它能区分转码播放与直接播放,统计带宽、编码和分辨率分布以及设备兼容性。系统会把不同服务器上的同一用户合并为一个身份,为每个账号计算信任分,并标记异地登录、同时播放过多等异常。自动化规则可将通知发送到 Discord、邮件、ntfy、Webhook 等渠道。

项目还提供跨服务器的媒体库目录,支持重复内容检测和存储分析,并可向成员发送内容更新通讯,同时提供公开 REST API,并以 Docker 方式部署。

核心功能

  • 01在一个界面中查看 Plex、Jellyfin 和 Emby 的实时播放与服务器 CPU、内存、带宽。
  • 02保存完整的播放历史,包含设备与地理位置信息。
  • 03分析转码与直接播放、编码格式和分辨率分布。
  • 04合并同一用户在不同服务器上的账号,并计算账号信任分。
  • 05通过自动化规则将告警发送到 Discord、邮件、Webhook 等渠道。
  • 06提供跨服务器的媒体库目录,支持重复内容与存储分析。

适用场景

  • 家庭媒体服务器管理员需要查看谁在播放、从哪里播放。
  • 同时运行多台 Plex、Jellyfin 或 Emby 服务器、希望统一管理的用户。
  • 在媒体服务器上发现共享账号和异常播放行为。
  • 定期向成员发送新增影片和剧集的邮件通讯。

快速上手

  1. 1

    下载 Docker Compose 文件

    curl -O https://raw.githubusercontent.com/connorgallopo/Tracearr/main/docker/examples/docker-compose.pg18.yml
  2. 2

    生成密钥并写入 .env 文件

    echo "JWT_SECRET=$(openssl rand -hex 32)" > .env echo "COOKIE_SECRET=$(openssl rand -hex 32)" >> .env
  3. 3

    启动容器

    docker compose -f docker-compose.pg18.yml up -d
  4. 4

    打开 localhost:3000 并连接你的 Plex、Jellyfin 或 Emby 服务器

使用前须知

  • 采用 AGPL-3.0 许可证,这是一种著作权传承许可证,要求衍生的网络服务公开源代码。
  • 标准 Docker 部署需要额外运行外部 PostgreSQL/TimescaleDB 和 Redis 服务。
  • 除非在服务器上安装 Tracearr SSE 插件,否则 Jellyfin 和 Emby 将回退为轮询方式获取数据。

收录于专题

标签

常见问题

Tracearr 是什么?
统一监控 Plex、Jellyfin 和 Emby 服务器的播放会话、观看数据与账号共享情况的自托管面板。 Tracearr 是一个自托管的监控平台,面向 Plex、Jellyfin 和 Emby 服务器。它可以在一个页面上查看多台服务器的实时播放会话和运行状态,并保存完整的观看历史,包括谁在何时、在哪台设备上看了什么,每条播放还附带地理位置信息。
Tracearr 可以免费使用吗?用的什么许可证?
Tracearr 以 AGPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
Tracearr 还在维护吗?
活跃维护中。Tracearr 最近一次提交是在 2026年10月23日。
Tracearr 适合用来做什么?
家庭媒体服务器管理员需要查看谁在播放、从哪里播放。 同时运行多台 Plex、Jellyfin 或 Emby 服务器、希望统一管理的用户。 在媒体服务器上发现共享账号和异常播放行为。 定期向成员发送新增影片和剧集的邮件通讯。
Tracearr 怎么安装和运行?
下载 Docker Compose 文件: curl -O https://raw.githubusercontent.com/connorgallopo/Tracearr/main/docker/examples/docker-compose.pg18.yml 生成密钥并写入 .env 文件: echo "JWT_SECRET=$(openssl rand -hex 32)" > .env echo "COOKIE_SECRET=$(openssl rand -hex 32)" >> .env 启动容器: docker compose -f docker-compose.pg18.yml up -d 打开 localhost:3000 并连接你的 Plex、Jellyfin 或 Emby 服务器
在哪里获取 Tracearr?
源代码和安装说明在 GitHub 上:https://github.com/connorgallopo/Tracearr

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目