tautulli

核心用法

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. 配置灵活：通过环境变量管理连接信息，支持多实例切换

潜在缺点与局限性

1. 功能只读：无法执行管理操作（如停止播放、删除记录、管理用户权限）
2. 无内置可视化：输出为纯文本/JSON 格式，需配合其他工具实现图表展示
3. 网络依赖：要求运行环境与 Tautulli 实例网络可达，无法离线使用
4. 参数验证有限：history.sh 和 recent.sh 的 limit 参数仅提供默认值，无严格的正整数校验
5. T3 来源风险：个人开发者维护，长期更新保障相对较弱

适合的目标群体

• 家庭 Plex 管理员：需要快速查看谁在看什么、服务器负载如何
• 媒体库运营者：统计内容增长趋势、用户活跃度分析
• 自动化爱好者：将监控数据接入 Home Assistant、Discord 机器人等通知渠道
• 小型团队 IT：管理内部媒体服务器，无需复杂商业监控方案

使用风险

• API Key 泄露风险：若环境变量配置不当，可能导致 Tautulli 访问凭证暴露
• HTTP 明文传输：默认配置可能使用 HTTP，建议优先启用 HTTPS
• curl/jq 版本差异：老旧系统上的工具版本可能影响 JSON 解析行为
• Tautulli 服务可用性：API 查询依赖 Tautulli 自身运行状态，非 Plex 直连