haveagitgat/tdarr

Tdarr V2: 分布式转码系统

音视频库分析与转码/重封装自动化

概述

Tdarr V2是一个跨平台的条件转码应用，旨在自动化媒体库的转码/重封装管理，按需求处理媒体文件。通过设置媒体所需的编解码器、容器、语言等规则，可有效组织文件并提高设备兼容性。常见用途包括将h264视频转换为h265（hevc），节省40%-50%的存储空间。

应用形式为即点即运行的Web应用，包含两个核心组件：

• Tdarr_Server：所有节点连接的中央进程
• Tdarr_Node：运行在本地/其他设备上的进程，从服务器获取任务

系统采用模块化、并行化和可扩展性设计，可与Sonarr/Radarr等应用协同工作，每个媒体库可配置独立的转码设置、过滤器和调度计划。

核心功能与特性

• 跨平台节点：支持Windows、Linux（含arm/arm64架构）和macOS的Tdarr节点，协同服务器处理文件
• GPU与CPU工作节点：分为转码CPU/GPU和健康检查CPU/GPU四种类型，可按需启停，支持负载均衡
• 插件系统：通过插件实现自定义文件处理逻辑，社区插件库丰富（https://github.com/HaveAGitGat/Tdarr_Plugins%EF%BC%89
• 媒体库管理：支持多库配置，每库独立设置转码规则、过滤器和调度计划
• 灵活调度：7天24小时任务调度，支持工作节点数量自动/手动管理
• 实时监控：文件夹变动监控，自动触发文件处理
• 异常检测：工作节点停滞检测与处理
• 工具支持：集成FFmpeg和HandBrake作为转码工具
• 大规模兼容：已在100万文件的模拟媒体库上测试通过
• 高级搜索：基于数百种文件属性进行精准搜索
• 统计分析：提供媒体库详细统计信息
• 硬件转码：支持Nvidia硬件加速（需unRAID插件或Ubuntu运行时容器）

使用场景与适用范围

• 媒体库管理者：需统一管理大量音视频文件，优化存储占用与设备兼容性
• 家庭服务器用户：配合Sonarr/Radarr等下载工具，自动化处理新下载媒体
• 多设备适配：确保媒体文件在智能电视、手机、平板等多设备上正常播放
• 存储优化：通过格式转换（如h264→h265）减少存储空间占用
• 闲置硬件利用：将闲置设备作为转码节点，提升处理效率

使用方法与配置说明

组件部署

1. Tdarr_Server部署

启动中央服务器，负责任务分发与节点管理：

bash
docker run -d \
  --name tdarr_server \
  -p 8265:8265 \  # WebUI访问端口
  -p 8266:8266 \  # 节点通信端口
  -v /path/to/server/config:/app/server/config \  # 配置文件目录
  -v /path/to/server/logs:/app/server/logs \      # 日志目录
  -v /path/to/media:/media \                      # 媒体文件目录（按需挂载）
  --restart unless-stopped \
  haveagitgat/tdarr:latest

2. Tdarr_Node部署

启动转码节点，连接服务器并执行任务：

bash
docker run -d \
  --name tdarr_node \
  -e "NODE_NAME=MyNode" \            # 节点名称（自定义）
  -e "NODE_SERVER_IP=tdarr_server" \ # 服务器IP或容器名称
  -e "NODE_SERVER_PORT=8266" \       # 服务器通信端口
  -e "NODE_CPU_THREADS=4" \          # CPU线程数（根据硬件配置调整）
  -v /path/to/node/config:/app/node/config \  # 节点配置目录
  -v /path/to/node/logs:/app/node/logs \      # 节点日志目录
  -v /path/to/media:/media \                  # 需与服务器一致的媒体目录
  --restart unless-stopped \
  haveagitgat/tdarr:latest

基础配置流程

1. 访问WebUI：通过http://服务器IP:8265登录管理界面
2. 添加媒体库：配置媒体目录、转码规则和调度计划
3. 配置插件栈：选择或创建插件序列，定义文件处理流程（如转码、去字幕、音频标准化等）
4. 节点管理：在WebUI监控节点状态，调整CPU/GPU工作节点数量
5. 启动任务：手动触发或等待调度计划执行媒体库处理任务

插件栈示例

典型插件栈配置（优化存储与兼容性）：

1. 将非h265视频转码为h265
2. 移除所有字幕流
3. 移除视频标题元数据
4. 添加英语aac立体声音频流（如不存在）
5. 移除隐藏字幕轨道

更多信息

• 官方网站：[***]
• 文档中心：[***]
• 社区支持：Reddit (r/Tdarr)、*** (Tdarr Chat)