温馨提示×

debian下swagger如何更新

小樊
44
2026-09-01 18:37:36
栏目: 智能运维

在 Debian 系统下,“更新 Swagger”具体要看你指的是哪一种 Swagger / OpenAPI 使用方式,常见有下面几类。我分别说明。


一、如果你说的是「Swagger UI(网页版)」

1. 通过 apt 安装的(较少见)

一般 Debian 官方源里没有 swagger 相关包,如果你是自己打的 deb 包:

sudo apt update
sudo apt upgrade swagger-ui

2. 通过 npm 安装的(最常见)

如果你是用 Node.js 安装的:

npm update swagger-ui-express
# 或
npm install swagger-ui-express@latest

如果是纯前端 Swagger UI:

npm install swagger-ui-dist@latest

更新后重启服务:

systemctl restart your-node-service
# 或
pm2 restart your-app

3. 使用 Docker 运行的 Swagger UI

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

二、如果你说的是「Swagger Codegen / OpenAPI Generator」

Swagger Codegen

sudo apt remove swagger-codegen

然后下载最新 jar:

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

使用:

java -jar swagger-codegen-cli-3.x.jar

OpenAPI Generator(推荐)

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

三、如果你说的是「Spring Boot / Java 项目里的 Swagger」

更新 Maven 依赖(示例):

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

或 SpringDoc(新标准):

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

然后:

mvn clean package

四、如果你只是更新 API 文档(yaml / json)

nano swagger.yaml

改完重启服务即可,不需要更新软件。


建议

  • ✅ 新项目:放弃 Swagger,用 OpenAPI 3 + SpringDoc
  • ✅ Docker 方式最干净、最易升级
  • ❌ 不建议用系统 apt 管理 Swagger

如果你能告诉我:

  • 用的什么语言(Java / Node / Python)
  • Swagger 是怎么部署的(Docker / npm / 源码)

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

0 踩