Jellyseerr连接Emby失败问题分析与解决方案

问题背景

在使用Jellyseerr 1.8.1版本时，部分用户报告了无法连接Emby服务器的问题。具体表现为升级到1.8.1版本后，所有需要连接Emby的功能都停止工作，而回退到1.7.0版本则恢复正常。经过深入分析，发现这与Node.js版本升级导致的DNS解析行为变化以及系统配置有关。

根本原因分析

1. Node.js版本升级影响：Jellyseerr从1.7.0升级到1.8.1时，Node.js运行环境从16版本升级到18版本。Node.js 17+版本改变了DNS解析的默认行为，会优先使用IPv6而非IPv4进行解析。

2. 系统hosts文件配置问题：在OpenMediaVault系统中，/etc/hosts文件自动生成时会将FQDN(完全限定域名)错误地解析到IPv6的环回地址(::1)，而非实际的IPv4地址。这是OpenMediaVault为修复SaltStack名称解析行为而做的特殊处理。

3. 连接失败现象：当Jellyseerr尝试通过FQDN连接Emby时，由于上述两个因素的共同作用，实际连接到了本地的IPv6环回地址而非目标服务器，导致ECONNREFUSED错误。

解决方案

方案一：修改Jellyseerr容器配置

为Jellyseerr容器添加环境变量，强制优先使用IPv4进行DNS解析：

environment:
  - NODE_OPTIONS='--dns-result-order=ipv4first'

方案二：修正系统hosts文件配置

1. 静态配置IPv6：在OpenMediaVault GUI中将IPv6配置为静态地址，这将生成正确的hosts文件。

2. 完全禁用IPv6：如果不需要IPv6，可以在OpenMediaVault网络接口设置中将IPv6设为"none"。

方案三：直接使用IP地址

在Jellyseerr的Emby设置中，将"Internal URL"从FQDN改为Emby服务器的实际IP地址。

技术细节补充

1. Node.js DNS解析行为变化：Node.js 17+版本遵循了RFC 3484标准，默认优先使用IPv6地址。这一变化影响了所有依赖DNS解析的网络连接。

2. IPv6环回地址：::1是IPv6的环回地址，等同于IPv4中的127.0.0.1。错误的解析会导致连接指向本地而非目标服务器。

3. OpenMediaVault的特殊处理：OpenMediaVault在/etc/hosts中添加FQDN到::1的映射是为了解决SaltStack的状态部署性能问题，但这在某些场景下会产生副作用。

最佳实践建议

1. 对于运行在OpenMediaVault上的服务，建议定期检查/etc/hosts文件内容，确保域名解析符合预期。

2. 在容器化环境中，明确指定网络连接偏好可以避免因运行环境变化导致的问题。

3. 对于内部服务通信，考虑使用服务发现机制或直接使用IP地址，减少对DNS解析的依赖。

通过以上分析和解决方案，用户可以根据自身环境选择最适合的方法恢复Jellyseerr与Emby的正常连接。