NGINX-UI反向代理配置问题分析与解决方案

问题现象

在使用NGINX-UI进行反向代理配置时，发现无论配置什么应用，访问都会重定向到NGINX-UI的登录界面。这种情况通常表明反向代理配置未能正确将请求转发到目标服务。

环境配置分析

用户使用的是Debian 12系统，通过Docker安装了NGINX-UI的最新版镜像(uozi/nginx-ui:latest)。docker-compose.yml配置中采用了host网络模式，并将NGINX配置文件挂载到了宿主机。

可能原因分析

1. Host头传递问题：反向代理配置中虽然设置了proxy_set_header Host $host，但实际请求中Host头可能未被正确传递。

2. FRP配置影响：从配置中可以看到使用了FRP进行内网穿透，FRP可能会修改或丢失某些HTTP头信息。

3. SSL重定向循环：配置中存在return 308 https://$host$request_uri，可能导致重定向循环。

4. 路径匹配问题：location块中的路径匹配可能不够精确，导致所有请求都被NGINX-UI捕获。

解决方案

1. 检查基础连通性

首先确认目标服务(FRPS)在本地网络(127.0.0.1:7500)是否可访问。可以通过curl命令测试：

curl -v http://127.0.0.1:7500

2. 修改反向代理配置

调整server配置，移除不必要的重定向并简化配置：

server {
    listen 443 ssl;
    server_name frps.xxx.com;
    
    ssl_certificate /etc/nginx/ssl/*.xxx.com_2048/fullchain.cer;
    ssl_certificate_key /etc/nginx/ssl/*.xxx.com_2048/private.key;
    
    location / {
        proxy_pass http://127.0.0.1:7500;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

3. 检查FRP配置

确保FRP配置中没有设置会修改HTTP头的选项，特别是host_header_rewrite等参数。

4. 检查NGINX主配置

查看nginx.conf中是否有默认server块捕获了所有请求。常见问题包括：

• 默认server监听443端口
• 默认server的server_name设置为_或空

5. 日志分析

检查NGINX访问日志和错误日志，确认请求实际被转发到了哪个后端：

tail -f /var/log/nginx/frps.xxx.com.log
tail -f /var/log/nginx/frps.xxx.com.error.log

最佳实践建议

1. 简化初始配置：先使用最简单的反向代理配置测试，确认基础功能正常后再添加复杂功能。

2. 分步验证：

   • 先验证HTTP服务
   • 再添加SSL配置
   • 最后添加高级功能如WebSocket支持

3. 使用变量调试：可以在配置中添加响应头来调试：

add_header X-Proxied-To $proxy_host;
add_header X-Upstream $upstream_addr;

4. 容器网络检查：虽然使用了host网络模式，但仍需确认端口没有冲突，特别是当多个容器都使用host模式时。

通过以上步骤，大多数反向代理配置问题都能得到解决。如果问题仍然存在，可以考虑临时关闭NGINX-UI的认证功能进行进一步排查。