docker-tautulli-ghost

镜像概述和主要用途

docker-tautulli-ghost 是基于 linuxserver/tautulli 的配置包装器镜像，旨在简化 Tautulli 中终止转码流程的配置。Tautulli 是 Plex 媒体服务器的监控工具，本镜像通过集成自定义脚本（如 killstream.py），允许管理员设置自动化规则以限制或终止用户的转码行为，适用于资源管理与访问控制场景。

核心功能和特性

• 转码终止脚本集成：内置 killstream.py 脚本支持，可直接通过 Tautulli 通知系统触发转码终止。
• 自定义触发器：支持基于播放事件（如播放开始、播放恢复、转码决策变更）触发脚本执行。
• 灵活条件配置：可设置多维度条件（如用户、媒体类型、带宽等），满足复杂场景下的转码控制需求。
• 自定义终止消息：支持为终止的转码流配置自定义提示信息，提升用户体验。

使用场景和适用范围

适用于 Plex 媒体服务器管理员需要限制用户转码行为的场景，例如：

• 控制服务器资源占用（如 CPU/内存消耗）；
• 避免高带宽转码对网络的影响；
• 执行特定访问策略（如仅允许直接播放）。

Docker 部署方案

基础部署（docker run）

bash
docker run -d \
  --name=tautulli-ghost \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8181:8181 \
  -v /path/to/tautulli/config:/config \
  -v /path/to/scripts:/app/tautulli/scripts \  # 挂载包含 killstream.py 的脚本目录
  --restart unless-stopped \
  docker-tautulli-ghost

Docker Compose 配置

yaml
version: "3"
services:
  tautulli-ghost:
    image: docker-tautulli-ghost
    container_name: tautulli-ghost
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    ports:
      - "8181:8181"
    volumes:
      - /path/to/tautulli/config:/config  # Tautulli 配置目录
      - /path/to/scripts:/app/tautulli/scripts  # 脚本目录（包含 killstream.py）
    restart: unless-stopped

说明：

• /path/to/tautulli/config：本地存储 Tautulli 配置文件的目录。
• /path/to/scripts：本地存储 killstream.py 脚本的目录，需确保容器内路径与后续配置一致。

详细配置说明

前提条件

• 已部署 Plex 媒体服务器并连接 Tautulli。
• killstream.py 脚本已放置于容器可访问的目录（如上述部署中的 /app/tautulli/scripts）。

配置流程：设置转码终止脚本

步骤 1：添加新通知

在 Tautulli 管理界面中，导航至 Settings > Notifications，点击 Add Notification。

!step1

步骤 2：配置脚本路径

在通知设置的 Script 标签页中：

• Script Folder：填写 killstream.py 所在路径（如容器内路径 /app/tautulli/scripts）。
• Script File：从下拉菜单中选择 killstream.py（目录正确时会自动加载）。

!step2

步骤 3：选择触发器

在 Triggers 标签页中，勾选触发脚本执行的事件：

• 推荐选项：播放开始（Playback Start）、播放恢复（Playback Resume）、转码决策变更（Transcode Decision Change）。

!step3

步骤 4：设置执行条件

在 Conditions 标签页中，配置脚本执行的条件（如特定用户、媒体类型等）。

• 支持多条件组合，默认逻辑为“与”（所有条件需同时满足）。
• 示例场景：仅对用户“guest”或播放4K媒体时触发。

!step4

注意：每完成一个标签页配置后建议保存（不会关闭弹窗），避免内容丢失。

步骤 5：传递脚本参数

在 Arguments 标签页中，为每个触发器事件配置 killstream.py 的执行参数。

• 示例参数（终止转码并提示用户）：

  bash
  --jbop stream --username {username} --sessionId {session_id} --killMessage '不允许转码，请使用直接播放。'
  

  • {username}：Tautulli 内置变量，指代当前播放用户。
  • {session_id}：当前播放会话ID，用于精确定位并终止流。

!step5

脚本参数说明

killstream.py 支持以下核心参数（根据实际脚本版本可能略有差异）：