Debian中Swagger如何更新

在 Debian 系统中，“Swagger”通常指 Swagger UI / Swagger Editor / OpenAPI 相关工具 或 Java / Node.js 项目里集成的 Swagger 依赖，因此更新方式取决于你具体是怎么部署的。下面按常见场景分别说明。

一、如果是 Swagger UI（静态部署）

1️⃣ 查看当前版本

ls /var/www/html/swagger-ui
# 或你部署的目录

2️⃣ 下载最新 Swagger UI

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

⚠️ 版本号请替换为 GitHub 最新 release： https://github.com/swagger-api/swagger-ui/releases

3️⃣ 替换旧版本

sudo rm -rf /var/www/html/swagger-ui
sudo mv swagger-ui-5.17.14/dist /var/www/html/swagger-ui

4️⃣ 验证

浏览器访问：

http://服务器IP/swagger-ui/

二、如果是 Swagger Editor

cd /tmp
wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v4.6.0.tar.gz
tar -xzf v4.6.0.tar.gz
sudo mv swagger-editor-4.6.0 /var/www/html/swagger-editor

三、如果是 Java / Spring Boot 项目中的 Swagger

1️⃣ Maven 项目

更新 pom.xml：

Swagger 2（旧）

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

✅ 推荐：SpringDoc OpenAPI（Swagger 3）

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

然后：

mvn clean package

2️⃣ Gradle 项目

implementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0"

四、如果是 Node.js 项目（express / nestjs）

更新 swagger 包

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

或（NestJS）：

npm install @nestjs/swagger@latest

五、如果是 Docker 部署的 Swagger

docker pull swaggerapi/swagger-ui:v5.17.14
docker stop swagger-ui
docker rm swagger-ui
docker run -d \
  --name swagger-ui \
  -p 8080:8080 \
  -e SWAGGER_JSON=/app/swagger.json \
  -v $(pwd)/swagger.json:/app/swagger.json \
  swaggerapi/swagger-ui:v5.17.14

六、Debian 系统级更新（无关 Swagger 本身）

sudo apt update
sudo apt upgrade

⚠️ 这不会更新 Swagger，只更新系统库。

七、如何确认你该用哪种方式？

请告诉我：

✅ Swagger UI / Editor / Spring Boot / Node.js？
✅ 是否使用 Docker？
✅ 当前访问地址（如 http://ip/swagger-ui.html）

我可以直接给你精确的一步到位更新方案。