Linux如何升级Swagger版本

在 Linux 上升级 Swagger（通常指 Swagger UI / Swagger Editor / Swagger Codegen / OpenAPI 工具）取决于你具体使用的是哪一种 Swagger 相关组件。下面我按常见场景分别说明。

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

常见情况：

场景	升级方式
Swagger UI（前端页面）	下载新版静态文件
Swagger Editor	下载新版或使用 Docker
Swagger Codegen	升级 JAR 或换 OpenAPI Generator
Spring Boot 集成 Swagger	升级 Maven / Gradle 依赖
Node.js 项目	`npm upgrade`
Docker 部署	拉取新镜像

二、升级 Swagger UI（最常见）

✅ 方式 1：手动升级（推荐）

查看当前版本
打开页面，通常底部会显示版本号，例如：
```
Swagger UI 3.52.5
```

下载最新版

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

替换旧版本
假设原路径是 /var/www/html/swagger：

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

重启 Web 服务（如 Nginx / Apache）
```
systemctl restart nginx
```

✅ 方式 2：Docker 方式升级

docker pull swaggerapi/swagger-ui:v5.17.14
docker stop swagger-ui
docker rm swagger-ui
docker run -d -p 8080:8080 --name swagger-ui swaggerapi/swagger-ui:v5.17.14

三、升级 Swagger Editor

docker pull swaggerapi/swagger-editor
docker run -d -p 8081:8080 swaggerapi/swagger-editor

或手动下载：

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

四、升级 Swagger Codegen（⚠️ 已过时）

Swagger Codegen 已停止维护，强烈建议迁移到 OpenAPI Generator。

旧方式（不推荐）

wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.32/swagger-codegen-cli-2.4.32.jar

✅ 新方式（推荐）

wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.6.0/openapi-generator-cli-7.6.0.jar

使用：

java -jar openapi-generator-cli-7.6.0.jar version

五、Spring Boot 项目升级 Swagger

旧版（Swagger 2）

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-boot-starter</artifactId>
  <version>3.0.0</version>
</dependency>

⚠️ SpringFox 已停止维护

✅ 推荐：SpringDoc OpenAPI（Swagger 3 / OpenAPI 3）

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

访问地址：

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

六、Node.js 项目升级 Swagger

npm list swagger-ui-express
npm install swagger-ui-express@latest

或：

npm update swagger-ui-express

七、快速判断你该升级哪种

你可以直接告诉我：

✅ 是 Swagger UI / Editor / Codegen？
✅ 部署方式（Docker / 原生 / Spring Boot / Node）？
✅ 当前版本号？
✅ Linux 发行版（Ubuntu / CentOS / Rocky）？

我可以给你精确到命令级别的升级方案 ✅