debian swagger怎么升级

debian

小樊

2026-10-16 09:35:34

栏目: 智能运维

在 Debian 上“升级 Swagger”具体取决于你指的是哪一种 Swagger / OpenAPI 工具，常见情况有几种。下面分别说明。

一、如果你指的是 Swagger UI（网页版）

1. 通过 npm 安装（推荐）

如果你是用 Node.js 部署的 Swagger UI：

cd /path/to/swagger-ui
npm install swagger-ui-dist@latest

或全局升级：

npm install -g swagger-ui-dist

然后重新拷贝静态文件到 Web 目录（如 /var/www/html/swagger）。

2. 直接下载最新发行版

wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.zip
unzip v5.x.x.zip
cp -r swagger-ui-*/dist/* /var/www/html/swagger/

二、如果你指的是 swagger-cli / swagger-codegen

1. swagger-cli（Node 工具）

npm install -g swagger-cli@latest
swagger-cli --version

2. swagger-codegen（Java）

Debian 仓库中的通常很旧：

apt remove swagger-codegen

推荐用官方 jar：

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

三、如果你指的是 Springfox / Springdoc（Java 项目）

Springfox（已停更，不推荐）

升级 pom.xml 或 build.gradle 中的版本即可。

Springdoc（推荐）

implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.x.x'

或 Maven：

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

四、如果你是通过 apt 安装的（不常见）

Debian 官方仓库一般没有“swagger”这个包：

apt list --installed | grep -i swagger

如果有，可以：

sudo apt update
sudo apt upgrade

五、建议

✅ 优先使用 OpenAPI 3 + Springdoc / Swagger UI 5
❌ 不建议继续使用 Swagger 2（已废弃）

如果你能告诉我：

是 UI / CLI / Codegen / Java 项目
当前版本
安装方式（apt / npm / jar / docker）

我可以给你精确的升级命令。