Bazarr连接Sonarr/Radarr常见问题排查指南

问题现象分析

在使用Bazarr媒体管理工具时，许多用户遇到了无法成功连接Sonarr或Radarr的问题。典型表现为测试连接时出现"AssertionError(b'')"错误，或者在配置界面出现各种连接异常。

主要错误原因

经过分析，这些问题主要源于以下几个配置不当的情况：

1. 地址格式错误：用户在地址栏中包含了协议前缀（如http://或https://），而Bazarr只需要主机名或IP地址
2. 空格问题：地址前后存在不可见空格字符，导致连接失败
3. 代理配置问题：虽然设置了代理排除规则，但格式不正确导致代理仍然生效

正确配置方法

地址栏配置规范

1. 只填写主机名或IP地址，不要包含协议前缀
2. 确保没有前导或尾随空格
3. 示例：
   • 正确：sonarr-service 或 192.168.1.100
   • 错误：http://sonarr-service 或 sonarr-service

SSL配置说明

当启用SSL选项时：

• Bazarr会自动添加https://前缀
• 不需要也不应该在地址栏手动添加协议
• 错误的协议前缀会导致连接失败

代理排除规则配置

1. 不支持通配符(*)匹配
2. 必须明确列出每个需要排除的域名或IP
3. 多个排除项用逗号分隔
4. 示例正确配置：localhost,127.0.0.1,sonarr-service,radarr-service

问题排查步骤

1. 检查地址栏是否包含多余字符
2. 测试不使用代理的情况
3. 验证网络连通性（ping/telnet测试）
4. 检查API密钥是否正确
5. 查看Bazarr日志获取详细错误信息

最佳实践建议

1. 在Kubernetes环境中使用服务名称而非IP地址
2. 配置前先复制API密钥到文本编辑器去除隐藏字符
3. 分步测试：先不使用SSL，成功后再启用
4. 对于集群内部通信，考虑关闭代理或正确配置排除规则

通过遵循这些配置规范，大多数连接问题都可以得到解决。Bazarr作为强大的媒体管理工具，正确的配置是确保其与Sonarr/Radarr协同工作的关键。