Tdarr项目跨主机转码配置指南

概述

在媒体服务器管理中，Tdarr是一个强大的分布式转码工具，它允许用户在多台机器上分配转码任务。本文将详细介绍如何配置Tdarr实现主服务器与Windows节点之间的协同工作，特别是解决路径映射这一常见难题。

核心问题分析

当尝试在不同操作系统的主机间配置Tdarr转码集群时，最常见的障碍是文件路径的映射问题。由于Linux和Windows使用完全不同的文件系统路径表示方法，必须正确配置路径转换器才能使节点识别服务器指定的文件位置。

详细配置步骤

1. 基础环境准备

首先确保：

• 主服务器运行Tdarr服务端（本例为Proxmox LXC容器）
• Windows节点安装Tdarr节点客户端
• 共享存储通过Samba/CIFS挂载到所有参与主机

2. 路径映射原理

Tdarr通过pathTranslators配置项实现跨平台路径转换。该配置需要明确：

• server: 服务端看到的绝对路径
• node: 节点端对应的访问路径

3. 典型配置示例

假设实际场景：

• 服务端路径：/media/shared/Movies/example.mkv
• Windows节点路径：Y:/MOVIES/example.mkv

对应配置应为：

"pathTranslators": [
    {
        "server": "/media/shared",
        "node": "Y:/MOVIES"
    }
]

4. 验证步骤

1. 在两台主机上确认能访问同一文件
2. 检查路径是否完全匹配（包括大小写）
3. 测试文件读写权限
4. 查看Tdarr日志验证路径转换是否生效

高级技巧

1. 多层路径映射：支持多个路径转换规则
2. 缓存配置：合理设置unmappedNodeCache提高性能
3. 权限管理：确保Docker容器有足够权限访问挂载点

排错指南

若遇到路径问题，建议：

1. 在两台主机上手动访问目标文件
2. 检查路径分隔符（Linux用/，Windows用\）
3. 验证Samba挂载参数（特别是跨平台文件名编码）
4. 检查Tdarr服务端和节点的日志输出

通过以上配置，用户可以充分利用高性能Windows工作站的转码能力，同时保持媒体库在Linux服务器上的集中管理。这种混合环境配置特别适合家庭媒体中心等场景。