spritsail/tautulli

镜像概述和主要用途

spritsail/tautulli 是用于运行 Plex 监控与统计工具 Tautulli 的 Docker 镜像。Tautulli 是一款专为 Plex 媒体服务器设计的跟踪与统计程序，可帮助用户监控 Plex 服务器的使用情况，包括用户活动、媒体播放记录、观看统计等核心功能。该镜像提供容器化部署环境，简化 Tautulli 的安装与管理，适用于需要集中跟踪 Plex 媒体服务器运行状态的场景。

核心功能和特性

• 容器化部署：通过 Docker 容器运行 Tautulli，简化依赖管理和环境配置，支持跨平台快速部署。
• 数据持久化：需通过卷映射 /config 目录存储配置数据，确保容器重启或升级后数据不丢失。
• 权限控制：容器内使用 UID 905 的用户运行进程，需确保宿主机映射的 /config 目录对该 UID 用户有写入权限。
• 端口兼容性：默认端口为 8181，可通过端口映射调整，避免与其他服务（如 Headphones）冲突。

使用场景和适用范围

• Plex 服务器管理员：适用于需要监控家庭或小型企业 Plex 媒体服务器使用情况的管理员，跟踪用户观看行为、热门媒体等统计数据。
• 媒体服务器维护者：需长期记录 Plex 服务器运行日志、用户活动历史的场景，通过持久化 /config 目录实现数据长期保存。
• 多服务环境：与其他媒体类 Docker 镜像（如 Headphones、Sonarr 等）共存时，可通过端口调整避免服务冲突。

使用方法和配置说明

基本要求

• 宿主机需安装 Docker 环境。
• 准备用于存储 Tautulli 配置数据的宿主机目录（如 /volumes/tautulli），并确保该目录对 UID 905 的用户有写入权限。

部署示例

Docker Run 命令

docker run -d \
  --restart=always \
  --name tautulli \
  -v /volumes/tautulli:/config \  # 映射宿主机目录至容器内 /config，存储配置数据
  -p 8182:8181 \                  # 端口映射：宿主机 8182 端口映射至容器内 8181 端口（避免冲突）
  spritsail/tautulli

参数说明

• -d：后台运行容器。
• --restart=always：容器退出时自动重启。
• --name tautulli：指定容器名称为 tautulli。
• -v /volumes/tautulli:/config：将宿主机目录 /volumes/tautulli 映射至容器内 /config 目录，用于持久化存储 Tautulli 配置、日志等数据。
• -p 8182:8181：将容器内 Tautulli 服务端口（8181）映射至宿主机 8182 端口，避免与其他服务（如 Headphones）的默认端口冲突。

注意事项

• 用户权限：容器内使用 UID 905 的用户运行进程，需确保宿主机映射的 /config 目录（如 /volumes/tautulli）对该 UID 用户有写入权限，可通过 chown -R 905:905 /volumes/tautulli 调整目录权限。
• 端口冲突：若与其他媒体类 Docker 镜像（如 spritsail/headphones）共存，需注意端口映射调整（示例中使用 8182 端口），避免默认端口冲突。
• 数据备份：/config 目录包含 Tautulli 的所有配置和数据，建议定期备份该目录以防止数据丢失。