linuxserver/tautulli Docker镜像文档

镜像概述和主要用途

Tautulli 是一个基于Python的Web应用程序，用于监控、分析Plex Media Server并提供通知功能。LinuxServer.io团队提供的此Docker镜像包含定期更新、简单的用户映射、自定义基础镜像以及每周安全更新等特性。

!tautulli

核心功能和特性

• 为Plex Media Server提供全面的监控和分析功能
• 支持多种通知方式，及时了解服务器活动
• 定期和及时的应用更新
• 简单的用户权限映射(PGID, PUID)
• 基于s6覆盖的自定义基础镜像
• 每周基础OS更新，优化空间使用和带宽消耗
• 定期安全更新
• 支持多架构部署
• 可配置为只读文件系统运行
• 支持非root用户运行

使用场景和适用范围

• Plex Media Server管理员需要监控服务器活动和性能
• 需要了解媒体消费***惯、用户行为分析的Plex用户
• 希望接收Plex服务器活动通知（如新内容添加、用户观看等）的用户
• 需要集中管理多个Plex服务器的场景
• 家庭媒体中心或小型企业媒体服务的监控需求

详细的使用方法和配置说明

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取lscr.io/linuxserver/tautulli:latest即可获取适合您架构的正确镜像，也可通过标签拉取特定架构的镜像。

版本标签

应用设置

通过 <your-ip>:8181 访问Web界面，更多信息请访问Tautulli***网站。

如需使用内置的Plex日志查看器，需添加一个卷（最好是只读），然后在Tautulli设置界面的"Plex Media Server"下，开启"显示高级选项"，并将"日志文件夹"设置为您映射的文件夹。

只读操作

此镜像可以在只读容器文件系统下运行，详情请参阅***文档。

非Root操作

此镜像可以使用非root用户运行，详情请参阅***文档。

部署方案示例

Docker Compose (推荐)

yaml
---
services:
  tautulli:
    image: lscr.io/linuxserver/tautulli:latest
    container_name: tautulli
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/tautulli/config:/config
    ports:
      - 8181:8181
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=tautulli \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8181:8181 \
  -v /path/to/tautulli/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/tautulli:latest

配置参数说明

端口映射

环境变量

卷映射

特殊参数

环境变量从文件加载（Docker Secrets）

可以通过特殊前缀FILE__从文件中设置任何环境变量：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据/run/secrets/mysecretvariable文件的内容设置环境变量MYVAR。

用户/组标识符

使用卷映射(-v标志)时，主机OS和容器之间可能出现权限问题。通过指定用户PUID和组PGID可以避免此问题。

确保主机上的任何卷目录都归您指定的相同用户所有，权限问题就会迎刃而解。

默认情况下PUID=1000和PGID=1000，可以通过以下命令查找您的用户ID和组ID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

可以通过Docker Mods为容器启用额外功能。可用的Mods列表可通过***渠道获取：

• Tautulli专用Mods
• 通用Mods

支持信息

容器内Shell访问

bash
docker exec -it tautulli /bin/bash

实时查看容器日志

bash
docker logs -f tautulli

查看容器版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' tautulli

查看镜像版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/tautulli:latest

更新说明

大多数镜像都是静态的、版本化的，需要更新镜像并重新创建容器来更新内部应用。不建议或支持在容器内更新应用。

使用Docker Compose更新

更新镜像:

• 所有镜像:

  bash
  docker-compose pull
  

• 单个镜像:

  bash
  docker-compose pull tautulli
  

更新容器:

• 所有容器:

  bash
  docker-compose up -d
  

• 单个容器:

  bash
  docker-compose up -d tautulli
  

清理旧镜像:

bash
docker image prune

使用Docker Run更新

bash
# 更新镜像
docker pull lscr.io/linuxserver/tautulli:latest

# 停止运行中的容器
docker stop tautulli

# 删除容器
docker rm tautulli

# 使用相同参数重新创建容器
docker run -d \
  --name=tautulli \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8181:8181 \
  -v /path/to/tautulli/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/tautulli:latest

# 清理旧镜像
docker image prune

镜像更新通知 - Diun (Docker Image Update Notifier)

推荐使用Diun进行更新通知。不建议或支持使用其他自动更新容器的工具。

本地构建方法

如需本地修改镜像进行开发或自定义：

bash
git clone [***]
cd docker-tautulli
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/tautulli:latest .

可以使用lscr.io/linuxserver/qemu-static在x86_64硬件上构建ARM变体，反之亦然：

bash
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

注册后，可以使用-f Dockerfile.aarch64指定要使用的dockerfile。

版本历史

• 05.07.25: - 重新基于Alpine 3.22构建
• 03.01.25: - 重新基于Alpine 3.21构建
• 19.11.24: - 使用上游Python包
• 24.06.24: - 重新基于Alpine 3.20构建
• 23.12.23: - 重新基于Alpine 3.19构建
• 26.08.23: - 重新基于Alpine 3.18构建
• 22.06.23: - 将主分支恢复到Alpine 3.17，解决Python 3.11问题
• 25.05.23: - 重新基于Alpine 3.18构建，弃用armhf架构
• 15.12.22: - 将主分支重新基于Alpine 3.17构建
• 04.10.22: - 将主分支重新基于Alpine 3.16构建，迁移到s6v3
• 10.01.22: - 重新基于Alpine 3.15构建
• 11.07.21: - 添加curl包
• 23.01.21: - 重新基于Alpine 3.13构建
• 11.07.20: - 添加py3-openssl
• 05.06.20: - 重新基于Alpine 3.12构建，迁移到python3
• 12.04.20: - 从pip添加mock和***链接
• 19.12.19: - 重新基于Alpine 3.11构建
• 28.06.19: - 重新基于Alpine 3.10构建
• 23.03.19: - 切换到新的基础镜像，迁移到arm32v7标签
• 22.02.19: - 重新基于Alpine 3.9构建
• 26.01.19: - 添加流水线逻辑和多架构支持
• 23.10.18: - 更新README中的plex日志信息
• 16.08.18: - 重新基于Alpine 3.8构建
• 10.03.18: - 重命名为tautulli
• 12.12.17: - 重新基于Alpine 3.7构建
• 21.07.17: - 内部git pull而非运行时拉取
• 12.07.17: - 添加检查命令到README，迁移到jenkins构建和推送
• 25.05.17: - 重新基于Alpine 3.6构建
• 20.04.17: - 添加py***domex pip包
• 07.02.17: - 重新基于Alpine 3.5构建
• 09.09.16: - 添加层徽章到README
• 27.08.16: - 添加徽章到README
• 08.08.16: - 重新基于Alpine Linux构建
• 16.07.15: - 初始发布