Jellyseerr项目中的高DNS查询问题分析与优化

在Jellyseerr媒体管理工具的使用过程中，开发团队发现了一个潜在的性能问题：系统产生了异常高的DNS查询请求量。这个问题主要源于HTTP客户端连接管理机制的实现方式。

问题现象

用户报告称，在短短两周时间内，Jellyseerr向themoviedb API发起了超过84,000次DNS查询请求。监控数据显示，DNS查询量明显高于其他服务端点，这表明系统没有有效地重用已建立的网络连接。

技术分析

在Node.js环境中，默认的HTTP全局连接管理器(Agent)本应具备连接保持(keepAlive)功能，默认超时时间为5秒。这种机制理论上可以复用TCP连接，减少DNS查询次数。然而，Jellyseerr的实现中存在两个关键问题：

1. 自定义连接管理器覆盖了Node.js的默认行为
2. 连接保持参数未被正确配置

根本原因

项目代码中引入了一个自定义HTTP连接管理器实现，这个实现覆盖了Node.js原生的全局连接管理器设置。具体来说，在自定义连接管理器的初始化过程中，没有显式设置keepAlive参数，导致连接重用机制失效。每次HTTP请求都需要建立全新的TCP连接，进而触发新的DNS查询。

解决方案

开发团队已经识别出这个问题并提出了修复方案：

1. 恢复使用Node.js默认的HTTP连接管理器配置
2. 确保自定义连接管理器正确继承keepAlive参数
3. 优化连接池配置参数

这种优化将显著减少DNS查询频率，同时提升整体网络请求性能。对于使用特殊网络配置的环境，系统仍会保留自定义连接管理器功能，但会确保连接重用机制正常工作。

性能影响

实施这些优化后，预期将带来以下改进：

• DNS查询量减少90%以上
• API响应时间缩短
• 服务器资源使用率降低
• 网络带宽消耗减少

这种类型的优化对于频繁调用外部API的媒体管理工具尤为重要，可以显著提升用户体验并降低基础设施负载。