Pangolin项目中的Bad Gateway问题排查与解决

问题背景

在使用Pangolin项目搭建内网穿透服务时，用户遇到了Bad Gateway错误。具体场景是将Homelab作为站点接入Pangolin，并在其中部署了Newt作为Docker容器，试图通过该服务访问Jellyfin媒体服务器。

错误现象

当尝试建立连接时，Newt容器日志显示以下关键错误信息：

Error connecting to target: dial tcp 192.168.178.93:8086: connect: connection refused

尽管在本地网络中可以通过192.168.178.93:8086成功访问Jellyfin服务，但通过Pangolin-Newt组合访问时却出现连接拒绝的错误。

排查过程

1. 初步检查：确认本地网络环境中Jellyfin服务确实运行在192.168.178.93:8086地址，且可正常访问。

2. 网络模式调整：尝试将Newt容器改为使用host网络模式，理论上可以消除Docker网络隔离带来的影响，但问题依旧存在。

3. 端口验证：通过curl命令测试Jellyfin服务的连通性，发现一个关键细节差异：

   • 成功连接使用的是8096端口（Jellyfin默认端口）
   • 失败连接配置的是8086端口

问题根源

经过仔细比对，发现问题源于配置中的端口号不一致：

• 在Pangolin Dashboard中配置的目标端口为8086
• 实际Jellyfin服务运行在默认的8096端口

这种端口不匹配导致Newt代理尝试连接错误的端口，自然会被目标服务拒绝。

解决方案

将Pangolin Dashboard中的目标端口配置从8086修正为8096，与Jellyfin实际服务端口保持一致。修改后，通过Pangolin-Newt组合访问Jellyfin服务恢复正常。

经验总结

1. 端口一致性检查：在配置网络服务时，务必确保源配置与目标服务的实际端口完全一致。即使是相近的端口号（如8086和8096）也会导致连接失败。

2. 日志分析技巧：当出现"connection refused"错误时，首先应该检查：

   • 目标服务是否正常运行
   • 网络路径是否通畅
   • 端口配置是否正确

3. 测试方法：在配置复杂网络服务时，建议先使用简单工具（如curl、telnet等）直接测试目标服务的连通性，排除基础网络问题后再排查上层应用问题。

通过这次问题排查，我们再次验证了网络服务配置中"细节决定成败"的道理。特别是在涉及多层网络转发的场景下，每一层的配置都必须精确匹配，才能确保服务的正常访问。