eafxx/traktarr

eafxx/traktarr 镜像文档

镜像概述和主要用途

eafxx/traktarr 是一个用于运行通过变量配置的应用命令的Docker镜像，支持PUID/PGID权限管理、多架构部署，并可在容器重启时自动更新应用（可禁用）。主要用于集成Trakt账户与Arr系列应用（如Sonarr、Radarr），实现媒体内容的自动化管理与同步。

核心功能和特性

• 通过环境变量配置应用命令运行参数
• 支持PUID/PGID用户组权限管理，避免宿主与容器权限冲突
• 多架构支持，适配不同硬件平台
• 容器重启时自动更新应用（可通过配置禁用）

使用场景和适用范围

适用于需要通过Trakt账户管理媒体内容，并与Sonarr、Radarr等Arr系列应用集成的用户。适合家庭媒体服务器、个人媒体库管理场景，尤其适合希望通过简单配置实现自动化媒体同步的用户。

详细使用方法和配置说明

前置要求

1. Trakt账户
2. Trakt应用（需按下方说明创建）
3. 已配置Arr系列应用（Sonarr、Radarr等）

安装指南

Docker

镜像标签

Docker Run 命令

bash
docker run -d --name='Traktarr' --net='bridge' \
  -e TZ="Europe/London" \
  -e 'PUID'='99' \
  -e 'PGID'='100' \
  -e 'DELAY'='' \
  -e 'SORT'='rating' \
  -e 'NOSEARCH'='yes' \
  -e 'NOTIFICATIONS'='yes' \
  -e 'BLACKLIST'='yes' \
  -e 'RUNNOW'='no' \
  -e 'SKIPUPDATE'='no' \
  -e 'APP_BRANCH'='master' \
  -v '<path to data>':'/config':'rw' \
  'eafxx/traktarr:latest'

Docker Compose 配置

yaml
traktarr:
  container_name: traktarr
  image: eafxx/traktarr
  volumes:
    - <path to data>:/config
  environment:
    - PUID=<uid>
    - PGID=<gid>
    - TZ=<timezone>
    - DELAY=2.5
    - SORT=rating
    - NOSEARCH=yes
    - NOTIFICATIONS=yes
    - BLACKLIST=yes
    - RUNNOW=no
    - SKIPUPDATE=no
    - APP_BRANCH=master

Unraid 安装

1. 打开Unraid的"Apps"标签
2. 搜索"traktarr"
3. 点击"Install"按钮进行安装

!Unraid安装界面

注意：首次运行时，容器会在/config目录下创建config.json文件并退出。需编辑该文件添加Sonarr、Radarr配置及Trakt应用信息（需先完成Trakt应用创建步骤），然后启动或重启容器。

参数说明

容器通过运行时参数（如下表）进行配置：

用户/组标识符

使用卷（-v参数）时，宿主系统与容器可能出现权限冲突。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保宿主卷目录的所有者与指定的PUID/PGID一致，即可解决权限问题。

获取当前用户的PUID和PGID：

bash
$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

应用配置

应用详细配置步骤请参考项目仓库README：https://github.com/l3uddz/traktarr#2-create-a-trakt-application