如何配置Kong Manager使其请求指向/kong-manager路径（Helm部署）

问题原因 #

Kong Manager默认部署在域名根路径下，当通过Ingress挂载到/kong-manager子路径时，它的静态资源加载、API请求仍会指向根路径（/），导致访问出错。需要通过Helm配置调整Manager的路径前缀，同时同步配置Admin API的路径，确保Manager能正确调用Admin API。

解决方案 #

通过Helm升级现有Kong实例，添加路径相关的配置参数：

1. 执行Helm升级命令 #

helm upgrade kong kong/kong \
  --set admin.useTLS=false,admin.enabled=true,admin.http.enabled=true \
  --set admin.uriPrefix=/kong-admin \
  --set manager.enabled=true,manager.http.enabled=true \
  --set manager.env.uri_prefix=/kong-manager \
  --set manager.env.server_name=localhost \
  --set manager.env.admin_api_uri=http://localhost/kong-admin

参数说明 #

• admin.uriPrefix=/kong-admin：配置Kong Admin API的根路径前缀，使其能处理/kong-admin下的请求，匹配你的Ingress路径。
• manager.enabled=true：启用Kong Manager组件（默认可能未开启）。
• manager.http.enabled=true：启用Manager的HTTP访问端口（8002）。
• manager.env.uri_prefix=/kong-manager：设置Manager的根路径前缀，让其所有静态资源和内部API请求都基于/kong-manager路径。
• manager.env.server_name=localhost：指定Manager的服务器名称，匹配Ingress配置中的host。
• manager.env.admin_api_uri=http://localhost/kong-admin：告知Manager Admin API的访问地址，确保Manager能正常调用Admin接口。

2. 验证配置 #

升级完成后，等待Kong Pod重启完成，再次访问http://localhost/kong-manager即可正常加载管理界面。此时Manager的静态资源路径会变为/kong-manager/assets/xxx，内部API请求也会自动带上/kong-manager前缀，不再指向根路径。

注意事项 #

• 确保你的Ingress配置无需修改，保持原有的路径规则即可。
• 若升级后仍有问题，可检查Kong Pod的日志，确认配置是否生效，或验证Admin API是否能通过http://localhost/kong-admin正常访问。

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