在云服务器上部署 WeKnora 后无法在本地查看 Swagger 文档-已解决

在云服务器上部署 WeKnora 后无法在本地查看 Swagger 文档

1. 检查服务运行模式

WeKnora 的 Swagger UI 默认只在开发模式 (debug) 下开启，而在生产模式 (release) 下会出于安全考虑被关闭。

• 检查当前模式：登录到你的云服务器，在 WeKnora 项目目录下查看 .env 文件。

  cat .env | grep GIN_MODE

• 如果显示 GIN_MODE=release：这就是问题所在。

• 解决方案：

  1. 编辑 .env 文件，将 GIN_MODE 的值改为 debug。

      

     # 使用编辑器打开 .env 文件，例如：
     vi .env
     # 找到 GIN_MODE=release 并修改为：
     GIN_MODE=debug

  2. 保存文件后，重启 WeKnora 服务使配置生效。

      

     docker compose restart
     # 或者完全重新创建容器
     docker compose down && docker compose up -d

本地访问Swagger 地址，格式为：

http://<你的服务器公网IP>:<后端API端口>/swagger/index.html

特别注意这两点，很容易搞错：

• 端口：一定是后端 API 端口（默认为 8080），不是前端 Web UI 端口（通常是 80 或 3000）。

• IP：用云服务器的公网 IP，不要用 localhost。