debian如何升级swagger

在 Debian 系统上，“升级 Swagger”具体要看你指的是哪一种 Swagger：

Swagger UI / Swagger Editor（前端静态页面）
Springfox / springdoc-openapi（Java 后端库）
Swagger Codegen / OpenAPI Generator（代码生成工具）
通过 Docker 运行的 Swagger

下面分别说明常见情况。

一、如果是 Swagger UI（前端静态文件）

1. 通过 apt 安装的情况（较少见）

Debian 官方源通常没有 swagger 包，如果你是自己放的：

ls /var/www/html/swagger*

2. 手动升级（最常见）

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

或修改 Nginx 指向新目录。

二、如果是 Spring Boot 项目（后端 Swagger）

1. Springfox（旧，不推荐）

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

⚠️ Springfox 已停止维护，建议迁移。

2. springdoc-openapi（推荐）

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

访问：

/swagger-ui.html

升级只需改版本号并重新构建。

三、如果是 Swagger Codegen / OpenAPI Generator

使用 jar 包

wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.6.0/openapi-generator-cli-7.6.0.jar
java -jar openapi-generator-cli-7.6.0.jar --version

使用 npm

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

四、如果是 Docker 运行的 Swagger

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

五、确认当前版本

浏览器打开 Swagger UI
页面底部通常会显示：

Swagger UI v5.x.x

六、建议

✅ 新项目使用 OpenAPI 3 + springdoc
❌ 避免继续使用 Springfox

如果你能告诉我：

是 前端 / 后端 / Docker
当前版本
Debian 版本（cat /etc/debian_version）

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