如何将Swagger UI的URL从0.0.0.0改为localhost？配置咨询

一、检查SWAGGER_JSON的路径配置 #

Docker Compose里必须同时完成本地文件挂载和容器内路径指向，只设置环境变量没用：

• 正确的docker-compose.yml示例：

version: '3.8'
services:
  swagger-ui:
    image: swaggerapi/swagger-ui
    ports:
      - "8080:8080"
    volumes:
      # 把本地的swagger.json挂载到容器内的默认静态文件目录
      - ./swagger.json:/usr/share/nginx/html/swagger.json
    environment:
      # 环境变量必须指向容器内的文件路径，不是本地路径
      - SWAGGER_JSON=/usr/share/nginx/html/swagger.json

• 注意：如果你的swagger.json不在docker-compose.yml所在目录，要调整本地挂载路径，比如./config/swagger.json:/usr/share/nginx/html/swagger.json，确保本地文件确实存在。

二、检查swagger.json的内容合规性 #

文件必须符合OpenAPI规范，且明确指定localhost作为服务器地址：

OpenAPI 3.x版本示例 #

{
  "openapi": "3.0.3",
  "info": {
    "title": "你的API文档",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "http://localhost:8080/api",
      "description": "本地开发服务器"
    }
  ],
  "paths": {
    "/users": {
      "get": {
        "summary": "获取用户列表",
        "responses": {
          "200": {
            "description": "成功返回"
          }
        }
      }
    }
  }
}

OpenAPI 2.0（Swagger 2.0）版本示例 #

{
  "swagger": "2.0",
  "info": {
    "title": "你的API文档",
    "version": "1.0.0"
  },
  "host": "localhost:8080",
  "basePath": "/api",
  "paths": {
    "/users": {
      "get": {
        "summary": "获取用户列表",
        "responses": {
          "200": {
            "description": "成功返回"
          }
        }
      }
    }
  }
}

• 常见错误：遗漏servers（3.x）或host（2.0）字段，或者字段里写了0.0.0.0，这会导致Swagger UI显示默认的0.0.0.0地址。

三、额外排查步骤 #

1. 重启容器：修改配置后执行docker-compose down && docker-compose up -d，确保新配置生效。
2. 验证挂载文件：进入容器执行docker exec -it <容器名> cat /usr/share/nginx/html/swagger.json，确认文件内容和本地一致。
3. 清空浏览器缓存：按Ctrl+F5强制刷新页面，避免旧缓存影响显示。

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