在 Linux 上升级 Swagger,要先明确你指的是哪一种 Swagger 工具,因为不同工具升级方式不一样。下面按常见情况说明。
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
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
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
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
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
⚠️ springfox 已停止维护,不推荐新项目使用
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>2.3.0</version>
</dependency>
访问:
http://localhost:8080/swagger-ui.html
npm install swagger-jsdoc@latest swagger-ui-express@latest
或
yarn upgrade swagger-jsdoc swagger-ui-express
你可以执行以下命令辅助判断:
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 |
如果你愿意,可以告诉我:
我可以给你精确的升级命令和兼容方案。