Docker环境下HAProxy路径重定向异常问题求助

问题场景 #

• 涉及三个Docker容器：
  • Main App容器：主Web应用
  • Express容器：提供/和/about端点的附加Web应用
  • HAProxy容器：路径匹配/portal/app时转发至Express，其余请求转发至Main App
• 访问/portal/app/时页面有两个链接：
  • <a href="/about">About</a>
  • <a href="/">News</a>
• 异常表现：
  • 点击About跳转至server.com/about，点击News跳转至server.com/
  • 跳转后请求仍由Express处理，但刷新页面会回到Main App容器

当前HAProxy配置 #

frontend myfrontend
  bind :80
  bind :443 ssl crt /etc/ssl/certs/haproxy.pem
  http-request redirect scheme https unless { ssl_fc }  
  default_backend main_container


  acl express_app_path path_beg /portal/app 
  use_backend express_app if express_app_path

backend express_app
  log stdout format raw local0
  http-request replace-path /portal/app(/)?(.*) /\2
  server s2 express:3000 check 

backend main_container
  log stdout format raw local0
  server s1 main:3000 check

解决方法 #

方案一：调整HAProxy配置（无需修改应用） #

核心是通过HAProxy修正响应中的链接和跳转路径，确保浏览器始终访问带/portal/app前缀的路径。更新后的配置如下：

frontend myfrontend
  bind :80
  bind :443 ssl crt /etc/ssl/certs/haproxy.pem
  http-request redirect scheme https unless { ssl_fc }  
  default_backend main_container

  # 匹配所有以/portal/app开头的路径（含子路径）
  acl express_app_path path_beg /portal/app
  use_backend express_app if express_app_path

backend express_app
  log stdout format raw local0
  # 转发请求时去掉/portal/app前缀，适配Express的端点
  http-request replace-path /portal/app(/)?(.*) /\2
  # 修正应用返回的重定向头，给根路径加上前缀
  http-response replace-header Location ^/(.*) /portal/app/\1
  # 替换HTML中的绝对路径链接，让跳转路径带前缀
  http-response replace-body "</?a[^>]+href=\"/(.*?)\"" "<a href=\"/portal/app/\1\""
  server s2 express:3000 check

backend main_container
  log stdout format raw local0
  server s1 main:3000 check

配置说明：

• http-response replace-header：处理Express返回的3xx重定向，把根路径跳转修正为带/portal/app前缀的路径
• http-response replace-body：批量修改页面中<a>标签的绝对路径，让点击后跳转到正确的带前缀地址
• 原ACL已覆盖所有/portal/app开头的路径，确保刷新/portal/app/about时仍转发至Express

方案二：修改Express应用链接（更高效） #

如果有权限修改Express应用代码，直接把链接改为相对路径：

• 将About链接改为 <a href="./about">About</a>
• 将News链接改为 <a href="./">News</a>
  这样浏览器会基于当前页面的URL自动生成正确的跳转路径，无需HAProxy处理响应内容，性能更优。

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