温馨提示×

linux swagger怎样升级

小樊
46
2026-08-31 16:15:51
栏目: 智能运维

在 Linux 上升级 Swagger,要先明确你指的是哪一种 Swagger 工具,因为不同工具升级方式不一样。下面按常见情况说明。


一、如果你是升级 Swagger Editor / Swagger UI(Docker 方式)

1️⃣ Swagger Editor

docker pull swaggerapi/swagger-editor:v4
docker stop swagger-editor
docker rm swagger-editor
docker run -d -p 8080:8080 --name swagger-editor swaggerapi/swagger-editor:v4

查看最新版本:

docker inspect swaggerapi/swagger-editor:latest

2️⃣ Swagger UI

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

二、如果你是升级 Swagger Codegen

1️⃣ 官方 Swagger Codegen(Java)

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

运行:

java -jar swagger-codegen-cli-3.0.46.jar --help

2️⃣ OpenAPI Generator(推荐,Codegen 替代品)

docker pull openapitools/openapi-generator-cli:v7

或下载 jar:

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

三、如果你是升级 Java 项目中的 Swagger(springfox / springdoc)

✅ Spring Boot 2.x(springfox swagger)

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

⚠️ springfox 已停止维护,不推荐新项目使用


✅ Spring Boot 3.x(springdoc-openapi,推荐)

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

访问:

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

四、如果你是升级 Node.js 中的 swagger-jsdoc / swagger-ui-express

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

yarn upgrade swagger-jsdoc swagger-ui-express

五、判断你当前用的是哪种 Swagger

你可以执行以下命令辅助判断:

ps -ef | grep swagger
docker ps | grep swagger
npm list swagger-jsdoc

六、总结推荐方案 ✅

场景 推荐
REST API 文档 OpenAPI 3 + springdoc / Swagger UI
代码生成 OpenAPI Generator
新项目 ❌ 不用 springfox
可视化编辑 Swagger Editor Docker

如果你愿意,可以告诉我:

  • ✅ 你是 前端 / 后端 / 运维
  • ✅ 用的是 Spring Boot / Node / Docker / 裸机
  • ✅ 当前 Swagger 版本

我可以给你精确的升级命令和兼容方案

0