Kubernetes环境下HAProxy暴露Prefect服务UI失败求助

问题根源 #

Prefect UI默认基于根路径/生成静态资源、API请求的链接，当你通过/SERVER前缀访问时，UI不知道这个外部前缀，所以输出的资源链接都是绝对路径（如/static/js/main.js），浏览器会直接向集群公网地址的根路径发起请求，而非/SERVER/static/js/main.js，导致路由失效。

解决方案 #

需要从Prefect服务配置和HAProxy配置两方面调整：

1. 配置Prefect服务识别子路径 #

修改Prefect Server的Kubernetes Deployment，添加环境变量让它知道自己运行在/SERVER子路径下：

env:
  # 指定外部可访问的API完整地址
  - name: PREFECT_API_URL
    value: "https://<集群公网地址>/SERVER/api"
  # 设置UI的基础路径前缀
  - name: PREFECT_UI_BASE_URL
    value: "/SERVER"

注：不同Prefect版本变量名可能有差异，比如旧版本可能用PREFECT_SERVER_UI_ROOT_PATH替代PREFECT_UI_BASE_URL，请对应调整。

2. 优化HAProxy配置 #

保留请求路径替换逻辑，同时添加响应内容的路径替换作为兜底（防止Prefect配置后仍有遗漏的链接）：

acl SERVER path_reg -i ^/SERVER(/.*)?$
use_backend SERVER if SERVER

backend SERVER
        # 将/SERVER/xxx格式的请求路径转换为xxx，转发给Prefect服务
        http-request replace-path ^/SERVER(/.*)?$ \1
        # 替换响应中根路径开头的资源链接，自动添加/SERVER前缀
        http-response replace-body /"\/static/" "\"/SERVER/static/" gi
        http-response replace-body /"\/api/" "\"/SERVER/api/" gi
        server-template web 50 prefect-server.default.svc.cluster.local:4200 check resolvers mydns init-addr none 

验证步骤 #

1. 重启Prefect Server Deployment和HAProxy服务
2. 访问https://<集群公网地址>/SERVER/dashboard
3. 打开浏览器开发者工具（F12），查看「网络」标签，确认所有资源请求的路径都包含/SERVER前缀

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