温馨提示×

如何更新linux swagger版本

小樊
44
2026-10-15 09:11:51
栏目: 智能运维

在 Linux 上“更新 Swagger 版本”要看你指的是哪一种 Swagger / OpenAPI 工具,常见有下面几类。我先按最常见情况说明,你可对号入座。


一、如果你用的是 Swagger UI(网页静态版)

1. 通过下载最新 release 更新

cd /opt
sudo rm -rf swagger-ui
sudo git clone https://github.com/swagger-api/swagger-ui.git

或下载发行包:

wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.tar.gz
tar -xzf v5.x.x.tar.gz

然后重新配置 index.html 中的 url 指向你的 API 文档。


二、如果你用的是 Swagger Editor

Docker 方式(推荐)

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

本地更新

cd swagger-editor
git pull
npm install
npm run build

三、如果你是 Java 项目(Spring Boot + springdoc / swagger)

1. 旧 Swagger(Springfox)

不推荐继续使用,建议迁移到 springdoc-openapi。

2. 更新 springdoc-openapi(推荐)

修改 pom.xml:

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

然后:

mvn clean package

访问:

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

四、如果你是 Node.js 项目(swagger-jsdoc / express)

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

五、如果你是 CLI 工具(如 swagger-codegen / openapi-generator)

swagger-codegen

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

openapi-generator(更活跃)

npm install @openapitools/openapi-generator-cli -g
openapi-generator-cli version

六、快速确认你当前用的是什么

你可以先执行:

which swagger
which swagger-ui
ps aux | grep swagger

或检查项目依赖:

cat package.json | grep swagger
cat pom.xml | grep swagger

如果你能告诉我:

  • 是 前端 / 后端 / Docker / 源码
  • 具体是 Swagger UI / Editor / Codegen / Spring

我可以直接给你精确的更新命令。

0 踩