Sun-Panel项目域名访问下分组快捷方式异常问题排查

问题背景

在使用Sun-Panel项目时，发现当通过Nginx配置的域名访问系统时，分组下的快捷方式无法正常展示。经过初步排查，发现是getListByGroupId接口出现了异常，而直接通过内网IP访问则功能正常。

环境配置

出现问题的环境配置如下：

• 操作系统：Ubuntu 24.04
• 项目版本：最新版(latest)
• Nginx配置了HTTPS反向代理到本地的3002端口

详细现象

通过域名访问时，前端界面无法显示分组下的快捷方式，开发者工具中可以看到getListByGroupId接口请求失败。而直接通过内网IP地址访问时，所有功能均正常。

技术分析

Nginx配置检查

从提供的Nginx配置来看，基本配置是正确的，包括：

1. HTTP到HTTPS的重定向
2. SSL证书配置
3. 反向代理到本地3002端口

配置中使用了标准的HTTPS设置，包括SSL协议版本、加密套件等参数，这些通常不会导致API接口异常。

可能的原因

1. 跨域问题：虽然Nginx配置了反向代理，但可能存在某些头部信息未正确传递
2. HTTPS混合内容：如果前端页面通过HTTPS加载，但API请求仍使用HTTP，可能会被浏览器拦截
3. Cookie/Session问题：HTTPS和HTTP之间的会话可能不一致
4. 内网穿透工具问题：最终发现是内网穿透工具导致的异常

解决方案

经过多次验证，最终确定问题出在内网穿透工具上。这类工具在转发请求时可能会：

1. 修改HTTP头部信息
2. 干扰WebSocket连接
3. 改变请求的协议或端口
4. 过滤某些特定的API请求

经验总结

1. 网络环境排查：当出现域名访问异常而内网访问正常的情况时，应该首先检查网络中间件（如Nginx、内网穿透工具等）的配置
2. 分层测试：可以从底层开始逐步测试，先确认后端服务是否正常，再测试Nginx转发，最后测试穿透工具
3. 开发者工具使用：利用浏览器开发者工具查看网络请求的详细情况，包括请求头、响应头、状态码等信息
4. 环境一致性：确保开发、测试和生产环境的一致性，特别是网络配置方面

最佳实践建议

1. 对于类似Sun-Panel这样的Web应用，建议：

   • 保持前后端协议一致（全HTTPS或全HTTP）
   • 检查所有中间件的配置是否完整传递了必要的头部信息
   • 在Nginx配置中添加必要的代理设置，如Host头部

2. 对于内网穿透工具的使用：

   • 选择成熟稳定的穿透工具
   • 检查工具的日志输出
   • 考虑直接使用云服务器部署，避免穿透工具带来的复杂性

3. 监控与日志：

   • 配置完善的日志记录，包括Nginx访问日志、错误日志
   • 监控关键API的可用性

通过这次问题排查，我们再次认识到在网络架构中，每一个中间环节都可能成为问题的来源，需要系统性地进行排查和验证。