如何更新Linux Swagger

在 Linux 上“更新 Swagger”可能指 不同对象，常见有下面几种情况。你可以对照看看你属于哪一种，我也可以按你的具体环境一步步来操作。

一、更新 Swagger UI（最常见）

1️⃣ 确认当前部署方式

Swagger UI 常见部署方式：

• 静态文件方式（Nginx / Apache）
• Docker 容器
• Node.js / npm 安装
• Spring Boot 集成

2️⃣ 静态部署方式（Nginx / Apache）

查看当前版本

ls /path/to/swagger
# 或
grep version /path/to/swagger/swagger-initializer.js

下载最新 Swagger UI

cd /tmp
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.17.14.zip
unzip v5.17.14.zip

⚠️ 版本号可在 https://github.com/swagger-api/swagger-ui/releases 查看

替换旧版本

cp -r swagger-ui-5.17.14/dist/* /var/www/html/swagger/

重启 Web 服务

sudo systemctl restart nginx
# 或
sudo systemctl restart apache2

3️⃣ Docker 方式

查看当前版本

docker ps
docker inspect <container_id> | grep Image

更新 Swagger UI

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=/swagger.json \
  swaggerapi/swagger-ui:v5.17.14

4️⃣ npm 方式（前端项目）

cd your-project
npm list swagger-ui
npm install swagger-ui@latest

或指定版本：

npm install swagger-ui@5.17.14

二、更新 Swagger Editor

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

三、更新 Spring Boot 中的 Swagger（springdoc / springfox）

✅ 推荐：springdoc-openapi（Spring Boot 2.6+）

Maven

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

Gradle

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

然后：

mvn clean package

⚠️ 不推荐：springfox-swagger2（已停止维护）

建议迁移到 springdoc-openapi

四、更新 Swagger 依赖（后端 API）

如果你指的是 OpenAPI / Swagger 规范版本：

• OpenAPI 2.0 → Swagger
• OpenAPI 3.x → 当前主流

✅ 建议统一升级到 OpenAPI 3.1

五、快速判断你该更新哪一部分

你可以直接告诉我：

1. ✅ Swagger UI / Editor / 后端？
2. ✅ 是否使用 Docker？
3. ✅ Linux 发行版（Ubuntu / CentOS / Debian）
4. ✅ 当前访问地址（如 http://ip:8080/swagger-ui.html）

我可以给你 精确到命令级别的更新方案。