Tdarr节点连接超时与性能下降问题分析与解决方案

问题现象

近期部分Tdarr用户在使用Docker容器部署时报告了两个典型问题：

1. 节点与服务器间频繁出现连接超时（30秒阈值）
2. 流程步骤执行时间从秒级骤增至分钟级

日志分析显示关键报错包含：

• ECONNREFUSED（连接拒绝）
• TransportError（传输层错误）
• 轮询超时（Polling timeout）

根本原因

经过技术分析，发现主要由两个配置问题导致：

1. 无效缓存路径配置

• 当库缓存路径被设置为"."时
• 系统尝试检测缓存空间时产生路径解析异常
• 引发服务器进程阻塞

2. 自动暂停机制缺陷

• 未处理的无效路径异常
• 导致节点状态检测循环失败

解决方案

配置修正方案

1. 缓存路径规范

• 确保所有库的缓存路径为绝对路径
• 有效格式示例：/mnt/user/media/transcode_cache
• 禁用未使用库的"Process Library"选项

2. 服务优化方案

• 升级至最新版本（已修复无效路径处理逻辑）
• 关闭非必要的"Auto pause nodes if cache full"功能
• 检查节点配置中的serverURL参数（推荐使用完整URL替代IP+Port组合）

技术建议

对于大规模媒体库（如4.2万+转码记录）用户：

1. 定期清理转码历史记录
2. 考虑分离数据库到高性能存储
3. 监控容器资源限制（CPU/MEM）

版本更新说明

最新版本已包含以下改进：

• 跳过禁用库的缓存检查
• 增强路径验证机制
• 优化节点通信重试逻辑

建议所有受影响用户升级到v2.42.01及以上版本，并按照上述方案检查配置。对于持续出现ECONNREFUSED错误的案例，建议检查Docker网络配置和访问控制规则。