通过Kong暴露Konga后无法连接Kong Admin API的问题咨询

首先，咱们先拆解核心矛盾：你直接访问Konga（host:1337）时能连Kong Admin，但通过Kong代理访问（host/konga）却失败，核心原因大概率出在Konga的Admin API请求发起端差异，以及代理场景下的网络/配置适配问题。下面是一步步的排查和解决思路：

一、先搞懂两种访问方式的请求逻辑差异 #

你可能没注意到：Konga的Admin API连接有两种模式——浏览器直接发起请求和Konga服务器代理请求，这两种模式在不同访问场景下会触发不同的行为：

• 当你直接访问host:1337时，Konga默认处于development模式，所有Admin API请求都是由Konga容器内部（服务器端）转发到http://kong:8001，而Docker Swarm内部网络能正常解析kong这个服务名，所以连接成功。
• 当你通过Kong代理访问host/konga时，Konga的前端JS可能会尝试从你的浏览器直接发起请求到http://kong:8001——但这个地址是Docker内部的服务域名，你的浏览器既无法解析，也无法访问未暴露的8001端口，自然就报错了。

快速验证这个逻辑： #

1. 直接访问host:1337，打开浏览器F12开发者工具→Network标签，看Admin API的请求地址：如果是http://host:1337/api/admin/xxx，说明是Konga服务器代理；
2. 切换到host/konga访问，同样看Network标签：如果请求地址是http://kong:8001/xxx，那就是浏览器直接发起的，必然失败。

二、排查Kong代理Konga的路由配置 #

既然你能通过host/konga打开页面，说明你已经添加了Konga的路由，但可能配置不完整，导致Konga无法正确处理代理请求：

1. 检查路由的关键参数 #

先确认Konga的路由是否配置了strip_uri=true和preserve_host=true：

# 进入任意能访问Kong Admin的容器（比如kong-addapis-konga）
docker exec -it $(docker ps -q -f name=webservices_kong-addapis-konga) sh
# 查看已配置的API
curl http://kong:8001/apis/

• strip_uri=true：Kong会把请求路径中的/konga前缀去掉后转发给Konga容器，否则Konga会收到/konga/xxx的请求，而它的默认路由是根路径，会导致API请求路径错误；
• preserve_host=true：让Kong转发原始的Host头给Konga，确保Konga能正确识别自己的访问地址，生成正确的API请求路径。

如果路由缺少这些参数，重新添加：

curl -i -X POST \
--url http://kong:8001/apis/ \
--data 'name=konga' \
--data 'uris=/konga' \
--data 'upstream_url=http://konga:1337' \
--data 'strip_uri=true' \
--data 'preserve_host=true' \
--data 'https_only=false'

三、调整Konga的Admin API配置，适配代理场景 #

针对代理访问的问题，有两种可行的调整方案：

方案1：让Konga始终通过服务器端代理请求Admin API #

确保Konga运行在development模式（默认就是），或者显式设置环境变量：
在你的Docker Compose的konga服务中添加：

environment:
  - NODE_ENV=development

这种模式下，所有Admin API请求都会由Konga容器内部转发到http://kong:8001，浏览器只需要和Konga通信，不会直接访问Kong Admin，自然就不会有域名解析问题。

方案2：通过Kong暴露Admin API，让浏览器能访问 #

如果需要让浏览器直接访问Kong Admin（比如生产模式），可以在Kong上添加一个安全的Admin API路由：

# 添加Admin API路由
curl -i -X POST \
--url http://kong:8001/apis/ \
--data 'name=kong-admin' \
--data 'uris=/admin' \
--data 'upstream_url=http://kong:8001' \
--data 'strip_uri=true'

# 添加Key Auth插件做认证（避免公开暴露Admin API）
curl -i -X POST \
--url http://kong:8001/apis/kong-admin/plugins/ \
--data 'name=key-auth'

然后登录Konga（直接访问host:1337），进入Settings页面，把Kong Admin URL修改为https://host/admin（或http://host/admin，根据你的协议），这样浏览器就能通过Kong代理访问Admin API了。

四、验证Docker内部网络连通性 #

万一前面的配置都没问题，就排查容器间的网络：

# 进入Konga容器
docker exec -it $(docker ps -q -f name=webservices_konga) sh
# 测试连接Kong Admin
curl http://kong:8001

如果能正常返回Kong的Admin API响应，说明容器内部网络没问题；如果不行，检查Docker Swarm的网络配置，确保所有服务都在同一个默认网络（webservices_default）里。

五、临时排查CORS问题（仅调试用） #

如果浏览器直接访问Kong Admin时出现跨域错误，可以临时给Kong Admin添加CORS插件：

curl -i -X POST \
--url http://kong:8001/plugins/ \
--data 'name=cors' \
--data 'config.origins=*' \
--data 'config.methods=GET,POST,PUT,PATCH,DELETE' \
--data 'config.headers=Accept,Authorization,Content-Type'

注意：生产环境一定要限制origins为你的域名，不能用*。

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