Linux Swagger怎么升级

在 Linux 上升级 Swagger，需要先明确你指的是 哪一种 Swagger 工具，因为“Swagger”现在通常指 OpenAPI + Swagger 工具链，常见有下面几种情况。下面我按最常见场景给你说明。

一、先确认你用的是哪种 Swagger

1️⃣ Swagger UI（最常见）

用于展示 API 文档的前端页面
路径通常是：

/swagger-ui
/swagger-ui.html

2️⃣ Swagger Editor

用于编写 OpenAPI 的在线编辑器

3️⃣ Swagger Codegen / OpenAPI Generator

用于生成客户端 / 服务端代码

4️⃣ Spring Boot 中的 Swagger（springfox / springdoc）

Java 项目常用

二、最常见情况：升级 Swagger UI（Linux）

✅ 方式一：直接替换 Swagger UI（推荐）

1. 下载最新 Swagger UI

wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.17.14.zip

（版本号可到：https://github.com/swagger-api/swagger-ui/releases 查看）

2. 解压

unzip v5.17.14.zip

3. 拷贝到你的服务目录

例如 Nginx / Spring Boot 静态目录：

cp -r swagger-ui-5.17.14/dist/* /var/www/html/swagger/

4. 修改 swagger-initializer.js

url: "https://petstore.swagger.io/v2/swagger.json"

改成你自己的 API 地址。

三、Spring Boot 项目升级 Swagger（非常常见）

❗ 注意：Springfox Swagger 已停止维护

✅ 推荐升级到 springdoc-openapi

1️⃣ 移除旧依赖

<!-- 删除 -->
<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-boot-starter</artifactId>
</dependency>

2️⃣ 添加 springdoc

<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
  <version>2.5.0</version>
</dependency>

3️⃣ 访问地址

http://localhost:8080/swagger-ui.html

四、Swagger Editor 升级

wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v4.22.0.zip
unzip v4.22.0.zip

然后部署到 Nginx 或 Docker。

五、使用 Docker 升级（最简单 ✅）

docker pull swaggerapi/swagger-ui:v5.17.14
docker pull swaggerapi/swagger-editor:v4.22.0

运行：

docker run -p 8080:8080 swaggerapi/swagger-ui

六、检查当前 Swagger 版本

Swagger UI

打开浏览器控制台，或查看：

dist/swagger-ui-bundle.js

搜索 SwaggerUIBundle 或版本号。

七、该选哪种升级方式？

八、如果你愿意，我可以更精确帮你

你可以直接告诉我：

1. ✅ 是 前端 Swagger UI 还是 Spring Boot
2. ✅ 当前版本
3. ✅ 是否使用 Docker / Nginx
4. ✅ Linux 发行版（CentOS / Ubuntu）

我可以给你 一步一步精确升级命令 ✅