debian如何更新swagger

debian

小樊

2026-09-13 20:55:49

栏目: 智能运维

在 Debian 上“更新 Swagger”通常分几种情况，先确认你说的是哪一种，我再给对应做法。

一、如果你说的是 Swagger UI / Swagger Editor（前端静态工具）

这类通常是：

下载官方 release
放到 /var/www 或 Nginx 目录下

更新 Swagger UI

cd /opt/swagger-ui
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.tar.gz
tar -xzf v5.x.x.tar.gz
cp -r swagger-ui-5.x.x/dist/* /var/www/swagger/

或者通过 Nginx + Docker：

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

二、如果你是 Spring Boot 项目里用的 Swagger（springdoc / springfox）

1️⃣ springdoc-openapi（推荐）

更新 Maven 依赖：

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

然后：

mvn clean package
systemctl restart your-app

访问：

http://your-server/swagger-ui.html

2️⃣ springfox（已不推荐）

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

三、如果你是 Node.js 项目（swagger-jsdoc / swagger-ui-express）

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

或：

yarn upgrade swagger-ui-express

四、如果你是 Docker 部署的 Swagger

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

五、如果你是 APT 安装的某个 swagger 包

Debian 官方仓库一般 没有 swagger：

apt list --installed | grep -i swagger

如果没有输出，说明不是 apt 安装的，不能用 apt upgrade。

✅ 快速确认方式

你可以告诉我：

Swagger 是网页还是代码依赖？
怎么部署的（Nginx / Docker / Spring Boot / Node）？
当前版本是多少？

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