tautulli/tautulli Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Tautulli Docker镜像文档

!tautulli

1. 镜像概述

这是官方Tautulli Docker镜像，支持版本和分支的唯一标签，用于部署Tautulli服务。Tautulli是一款专为Plex媒体服务器设计的监控工具，提供实时活动监控、用户行为分析和媒体播放统计等功能。

2. 核心功能与特性

• Plex服务器监控：实时监控Plex媒体服务器的活动状态，包括当前播放、用户连接等信息
• 用户行为分析：记录用户观看历史、播放时长、偏好媒体类型等详细数据
• 统计报告生成：生成用户活跃度、媒体播放量、热门内容等统计报告
• 通知系统集成：支持通过邮件、推送等方式发送服务器活动通知
• 配置数据持久化：所有配置和数据库文件存储在持久化卷中，确保数据不丢失

3. 使用场景与适用范围

适用于个人或企业Plex媒体服务器管理员，具体场景包括：

• 需要实时监控Plex服务器活动状态的场景
• 需要统计分析用户Plex使用行为和媒体播放数据的场景
• 需要记录Plex服务器历史播放记录并生成报告的场景
• 需要通过通知及时了解Plex服务器异常或重要活动的场景

4. 部署与使用方法

4.1 使用docker run部署

创建并运行容器

使用以下命令创建并启动Tautulli容器（需替换<values>为实际值）：

sh
docker run -d \
  --name=tautulli \
  --restart=unless-stopped \
  -v <宿主机数据路径>:/config \
  -e PUID=<用户ID> \
  -e PGID=<组ID> \
  -e TZ=<时区> \
  -p 8181:8181 \
  ghcr.io/tautulli/tautulli

更新容器

通过以下步骤更新Tautulli容器至最新版本：

sh
# 停止当前Tautulli容器
docker stop tautulli
# 删除当前Tautulli容器
docker rm tautulli
# 拉取最新镜像
docker pull ghcr.io/tautulli/tautulli
# 使用原参数重新创建并启动容器
docker run -d ...  # 此处使用创建容器时的原始参数

4.2 使用docker-compose部署

创建docker-compose.yml文件

创建包含以下内容的docker-compose.yml文件（需替换<values>为实际值）：

yml
version: '3'
services:
  tautulli:
    image: ghcr.io/tautulli/tautulli
    container_name: tautulli
    restart: unless-stopped
    volumes:
      - <宿主机数据路径>:/config  # 持久化配置和数据库文件
    environment:
      - PUID=<用户ID>              # 运行容器的用户ID
      - PGID=<组ID>                # 运行容器的组ID
      - TZ=<时区>                  # 容器时区
    ports:
      - 8181:8181                  # Web UI端口映射

创建并启动容器

在docker-compose.yml文件所在目录执行以下命令：

sh
docker-compose up -d

更新容器

通过以下命令更新Tautulli容器至最新版本：

sh
# 拉取最新镜像
docker-compose pull
# 更新并重启容器
docker-compose up -d

5. 配置参数说明

6. 用户/组标识符（PUID/PGID）

当使用卷挂载（-v参数）时，宿主机与容器间可能出现文件权限冲突。通过指定PUID（用户ID）和PGID（组ID），可确保容器内进程使用与宿主机一致的用户权限，避免权限问题。

获取PUID和PGID

在宿主机终端执行以下命令获取当前用户的PUID和PGID：

sh
id <用户名>  # 将<用户名>替换为实际用户名

示例输出：

uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

其中uid=1001即为PUID，gid=1001即为PGID。