1panel反向代理跳转异常排查指南
常见原因与解决方案
1. 代理目标地址配置错误
反向代理时,目标地址需填写正确的协议(http或https)和端口。若目标服务使用HTTPS而误填为HTTP,或端口错误,会导致请求无法转发,出现连接超时或跳转异常。建议检查目标地址是否可达,例如使用 curl 测试。
2. 路径转发规则不匹配
1panel中反向代理支持路径前缀匹配。若请求路径与规则不匹配(例如配置为 /api 但实际请求 /api/v1 未匹配),可能返回404或跳转到默认页面。确保路径匹配模式正确,使用通配符或正则表达式时需谨慎。
3. SSL证书与重定向循环
若源站强制HTTPS但反代未正确配置SSL证书,浏览器可能触发重定向循环(301/302)。常见情形:反代监听80端口,上游服务返回302到HTTPS地址,浏览器再次请求80端口形成死循环。解决方案:在1panel中为反代配置SSL证书,或将上游重定向规则改写为相对路径。
4. Cookie与Session丢失
反向代理可能导致Cookie的Domain或Path属性不匹配,造成登录跳转异常。例如上游服务设置Cookie Domain为 .example.com,但反代域名不同,客户端不会携带Cookie。可在1panel的反向代理设置中启用“传递原始Host头”或修改Cookie域名。
5. 反向代理缓存过期策略
1panel默认开启缓存可能导致旧配置未及时更新。若修改反代规则后仍出现异常跳转,请清除缓存(面板首页 -> 系统管理 -> 缓存清理)并重启Nginx服务。
操作建议
- 检查1panel“网站” -> “反向代理”中每个规则的“目标URL”和“路径”是否准确。
- 查看Nginx错误日志(
/var/log/nginx/error.log)查找具体错误码。 - 使用浏览器开发者工具(F12)观察网络请求的响应状态码与跳转链路。
- 临时关闭SSL强制跳转,排除重定向循环问题。
大多数跳转异常源于配置细节误差,按以上步骤逐一排查即可解决。