Plex 媒体服务器实时监控

基于 Tautulli API 的 Plex 媒体服务器监控工具，支持实时查看播放活动、历史记录及库统计，适合家庭媒体管理员快速掌握服务器状态。

基本信息

• 技能名称?tautulli
• 中文名称?Plex 媒体服务器实时监控
• 作者?rjmurillo
• 分类?效率
• 版本?v1.0.0
• 标签?content-media, api, automation, monitoring, self-hosted

使用方法

使用说明
核心用法
Tautulli Skill 是一套用于监控 Plex Media Server 的轻量级命令行工具集，通过调用 Tautulli 的 REST API 实现数据查询。用户需预先配置 TAUTULLI_URL 和 TAUTULLI_API_KEY 两个环境变量，即可通过六个独立脚本获取服务器状态：
activity.sh ：实时查看当前播放流，包括用户名、影片标题、播放进度、画质及播放设备
history.sh ：查询观看历史，支持自定义返回条数（默认10条）
libraries.sh ：列出所有媒体库分区及内容数量统计
recent.sh ：查看最近添加的媒体内容
users.sh ：获取用户列表及总观看时长、最后活跃时间
server.sh ：显示 Plex 服务器名称、版本、平台及连接状态
所有脚本均采用统一的 API 调用模式，通过 curl 发送 GET 请求至 $TAUTULLI_URL/api/v2 ，并使用 jq 解析 JSON 响应。
显著优点

1. 零侵入式监控 ：纯只读查询，不修改任何服务器配置，风险极低
2. 轻量依赖 ：仅需系统自带的 curl 和 jq ，无需额外运行时或复杂依赖链
3. 脚本化工作流 ：适合集成到自动化脚本、定时任务或通知系统中
4. 清晰的输出格式 ：通过 jq 格式化后的数据便于人工阅读或二次处理
5. 配置灵活 ：通过环境变量管理连接信息，支持多实例切换
   潜在缺点与局限性
6. 功能只读 ：无法执行管理操作（如停止播放、删除记录、管理用户权限）
7. 无内置可视化 ：输出为纯文本/JSON 格式，需配合其他工具实现图表展示
8. 网络依赖 ：要求运行环境与 Tautulli 实例网络可达，无法离线使用
9. 参数验证有限 ： history.sh 和 recent.sh 的 limit 参数仅提供默认值，无严格的正整数校验
10. T3 来源风险 ：个人开发者维护，长期更新保障相对较弱
    适合的目标群体
    家庭 Plex 管理员 ：需要快速查看谁在看什么、服务器负载如何
    媒体库运营者 ：统计内容增长趋势、用户活跃度分析
    自动化爱好者 ：将监控数据接入 Home Assistant、Discord 机器人等通知渠道
    小型团队 IT ：管理内部媒体服务器，无需复杂商业监控方案
    使用风险
    API Key 泄露风险 ：若环境变量配置不当，可能导致 Tautulli 访问凭证暴露
    HTTP 明文传输 ：默认配置可能使用 HTTP，建议优先启用 HTTPS
    curl/jq 版本差异 ：老旧系统上的工具版本可能影响 JSON 解析行为
    Tautulli 服务可用性 ：API 查询依赖 Tautulli 自身运行状态，非 Plex 直连