K8s部署Nexus经nginx-ingress访问无法显示Admin面板问题

这是Nexus部署在反向代理后的典型配置缺失问题：Nexus对反向代理透传的请求头校验规则严格，当前配置缺少Nexus识别代理访问场景必需的请求头，同时未匹配Nexus要求的转发规则，导致前端静态资源加载异常、权限上下文判断失效，最终出现admin账号登录后管理面板缺失的现象；port-forward方式直连服务不经过反向代理，因此功能完全正常。

• 修正代理请求头配置
  你当前配置的自定义请求头缺少Nexus强制依赖的X-Forwarded-Proto、X-Forwarded-Host字段，其中X-Forwarded-Proto用于告知Nexus用户访问时使用的协议类型，缺失时会触发跨协议资源拦截、接口权限校验失败问题。
  修改custom-headers ConfigMap配置如下：

  apiVersion: v1
  kind: ConfigMap
  metadata:
    name: custom-headers
    namespace: ingress-nginx
  data:
    Host: $host
    X-Real-IP: $remote_addr
    X-Forwarded-For: $proxy_add_x_forwarded_for
    X-Forwarded-Proto: $scheme
    X-Forwarded-Host: $host
  

• 为Nexus Ingress补充独立注解
  不要仅依赖Ingress Nginx全局配置，针对Nexus的Ingress资源单独添加注解做规则覆盖，避免全局配置被其他规则干扰。在Ingress的metadata.annotations字段下补充如下配置：

  nginx.ingress.kubernetes.io/proxy-buffering: "off"
  nginx.ingress.kubernetes.io/proxy-request-buffering: "off"
  nginx.ingress.kubernetes.io/proxy-send-timeout: "120"
  nginx.ingress.kubernetes.io/proxy-read-timeout: "300"
  nginx.ingress.kubernetes.io/configuration-snippet: |
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  # 若你使用HTTPS访问则保留下面两行，HTTP访问直接删除
  nginx.ingress.kubernetes.io/proxy-redirect-from: "http://$host/"
  nginx.ingress.kubernetes.io/proxy-redirect-to: "https://$host/"
  

• 配置Nexus侧基础访问地址
  1. 通过port-forward方式直连访问Nexus，登录admin账号
  2. 进入系统设置-Server配置页面
  3. 找到Base URL配置项，填入你通过Ingress对外暴露的完整访问地址（例如https://nexus.example.com），保存配置
• 生效验证
  重启Ingress Nginx控制器Pod加载新配置，清空浏览器缓存后重新通过Ingress域名访问Nexus，登录admin账号即可看到完整的管理面板。

如果完成上述配置后问题仍存在，按以下顺序核查：

• 打开浏览器开发者工具的Network面板，检查访问过程中是否有静态资源、接口返回403/404/混合内容错误，根据报错对应调整请求头规则
• 核查Nexus Pod的环境变量，若开启了NEXUS_SECURITY_CSRF_ENABLED=true配置，必须保证所有X-Forwarded-*请求头透传正确，否则CSRF校验会拦截管理接口请求，导致前端功能缺失
• 核查同Ingress控制器下的域名规则，确认没有其他同域名的路径规则优先级高于/路径，导致部分Nexus请求被错误转发到其他服务

内容的提问来源于stack exchange，提问作者yvr