haveagitgat/tdarr_node

Tdarr V2: 分布式转码系统

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

镜像概述和主要用途

Tdarr V2 是一个闭源分布式转码系统，旨在自动化媒体库的转码/重封装管理，确保文件在编解码器、流、容器等方面符合用户需求。它设计用于与 Sonarr/Radarr 等应用配合使用，以模块化、并行化和可扩展性为核心目标，支持跨平台节点协作处理媒体文件。每个添加的媒体库可独立配置转码设置、过滤器和调度计划，能充分利用闲置硬件资源进行高效媒体处理。

注：本仓库代码对应 Tdarr V1，Tdarr V2 为闭源软件。

核心功能和特性

• 跨平台节点协作：支持 Windows、Linux（含 Linux arm）、macOS 系统的 Tdarr 节点，与 Tdarr 服务器协同处理文件
• GPU 与 CPU 支持：提供转码（CPU/GPU）和健康检查（CPU/GPU）两种类型的 Worker，可根据需求灵活调度
• 插件系统：通过自定义或社区插件（https://github.com/HaveAGitGat/Tdarr_Plugins%EF%BC%89%E5%AE%9E%E7%8E%B0%E5%AF%B9%E6%96%87%E4%BB%B6%E5%A4%84%E7%90%86%E7%9A%84%E6%97%A0%E9%99%90%E6%8E%A7%E5%88%B6
• 音视频库管理：支持搜索基于数百种属性的文件、查看库统计数据、监控文件健康状态
• 灵活调度：7 天 24 小时调度器，可根据需求启动或关闭 Worker
• 实时监控：文件夹监控、Worker 停滞检测、库/驱动器间负载均衡
• 多工具支持：兼容 HandBrake 和 FFmpeg 进行转码/重封装
• 高扩展性：已在百万级虚拟文件库中测试，支持大规模媒体库管理
• 硬件转码：提供硬件转码容器（需在 unRAID 上安装 Nvidia 插件或在 Ubuntu 上使用 Nvidia 运行时容器）

使用场景和适用范围

• 家庭媒体服务器管理员：需标准化大量媒体文件格式，以节省存储空间、提高播放兼容性（如优化 Plex/Emby 播放体验）
• 媒体内容创作者：需要批量处理音视频文件，统一编码格式、移除冗余流（如多语言字幕/音轨）
• 与媒体管理工具配合：与 Sonarr/Radarr 等工具协同，自动化处理新下载的媒体文件，确保入库即符合标准
• 多平台硬件利用：通过分布式节点，充分利用闲置的 Windows/macOS/Linux 设备资源进行并行转码

详细使用方法和配置说明

基本工作流程

1. 部署 Tdarr 服务器：作为控制中心，管理媒体库、转码规则和节点
2. 配置 Tdarr 节点：在不同设备上部署节点，连接至服务器提供计算资源（CPU/GPU）
3. 创建插件栈：通过组合过滤器和动作插件，定义文件处理规则（如转码编码、移除字幕、添加音轨等）
4. 设置调度计划：配置 7 天 24 小时任务调度，或启用文件夹监控实时处理新增文件
5. 监控与调整：通过 Web 界面查看转码进度、库统计数据，根据负载调整 Worker 数量

插件栈示例

典型的插件栈组合可实现标准化媒体文件，例如：

1. 将非 HEVC 编码文件转码为 HEVC
2. 移除字幕流
3. 移除标题元数据
4. 添加 AAC 立体声音轨（优先英语）
5. 移除隐藏字幕

核心过滤器与动作

过滤器类型

• 按编解码器过滤
• 按媒体类型过滤
• 按文件年龄过滤
• 按分辨率过滤
• 按文件大小过滤

动作类型

• 转码：HandBrake 基础选项 / HandBrake/FFmpeg 自定义参数
• 音频标准化：统一音频流编码
• 添加音频流：按需求添加指定编码/语言的音轨
• 保留单个音频流：根据编码、语言和声道数筛选最优音轨
• 重封装容器：转换文件容器格式（如 MP4、MKV）

最佳实践建议

为提高直接播放兼容性，推荐插件栈配置：

1. 若文件非 H.264 编码，转码为 H.264（通用视频编码）
2. 若容器非 MP4，重封装为 MP4（通用容器格式）
3. 移除字幕流
4. 移除隐藏字幕
5. 添加 AAC 立体声音轨（优先英语，通用音频编码）
6. 移除标题元数据（避免 Plex 等播放器显示冗余标题）

注意事项

• Tdarr V2 为闭源软件，需通过官方渠道获取授权
• 硬件转码需配置相应驱动（如 Nvidia 显卡需安装 Nvidia 运行时）
• 大规模库处理建议先进行测试，优化插件栈以避免不必要的转码

更多详细配置和安装指南，请参考 官方文档。