Apache APISIX代理HDFS WebUI的302重定向问题解决方案

问题背景

在使用Apache APISIX代理Hadoop HDFS的WebUI时，经常会遇到302重定向问题。当用户通过APISIX访问HDFS的Web界面时，后端服务会返回302重定向响应，导致代理无法正常工作。

问题分析

HDFS的NameNode WebUI默认运行在9870端口，当直接访问根路径时，它会返回302重定向到/index.html。在使用APISIX进行代理时，这个重定向会导致客户端直接跳转到未代理的原始地址，而不是通过代理路径访问。

解决方案

方案一：使用ApisixRoute和proxy-rewrite插件

通过配置ApisixRoute和proxy-rewrite插件，可以实现路径重写：

apiVersion: apisix.apache.org/v2
kind: ApisixRoute
metadata:
  name: hadoop-route
spec:
  http:
    - name: namenode
      match:
        hosts:
          - example.com
        paths:
          - /hdfs/*
      backends:
        - serviceName: namenode-service
          servicePort: 9870
      plugins:
        - name: proxy-rewrite
          enable: true
          config:
            regex_uri: ["^/hdfs/(.*)", "/$1"]

方案二：处理重定向响应

对于HDFS返回的302重定向，可以通过以下两种方式处理：

1. 添加额外路由规则：为根路径添加一条特殊的路由规则，将其代理到/index.html

2. 使用response-rewrite插件：修改302重定向的Location头，保持代理路径

plugins:
  - name: response-rewrite
    enable: true
    config:
      headers:
        set:
          Location: example.com/hdfs/index.html

方案三：健康检查配置

对于HDFS HA环境，建议配置主动健康检查，确保只将流量路由到活跃的NameNode：

apiVersion: apisix.apache.org/v2
kind: ApisixUpstream
metadata:
  name: namenode-upstream
spec:
  healthCheck:
    active:
      type: http
      httpPath: /isActive
      healthy:
        interval: 5s
        successes: 1
      unhealthy:
        interval: 1s
        httpFailures: 2

最佳实践建议

1. 路径处理：确保所有路径重写规则正确配置，包括静态资源和API请求

2. 会话保持：如果WebUI需要会话保持，考虑配置相应的会话保持策略

3. 性能优化：对于大型HDFS集群，适当调整APISIX的连接池大小和超时设置

4. 安全配置：添加适当的访问控制和安全头，保护WebUI访问

通过以上配置，可以有效地解决APISIX代理HDFS WebUI时的302重定向问题，为用户提供无缝的访问体验。