linux swagger怎么更新

linux

小樊

2026-09-03 13:12:05

栏目: 智能运维

在 Linux 上“更新 Swagger”通常分为几种不同场景，我先帮你理清，再给你对应做法。

一、你指的是哪种 Swagger？

1️⃣ Swagger UI（网页界面）

一般是静态文件（HTML/JS），通过 Nginx / Docker 部署。

2️⃣ Swagger Editor

本地或服务器上的 Swagger 编辑器。

3️⃣ Spring Boot 中的 Swagger（springdoc / springfox）

Java 项目依赖更新。

4️⃣ Swagger CLI / 代码生成器（openapi-generator）

命令行工具更新。

二、常见更新方式

✅ 场景 1：Swagger UI（最常见）

方式 A：直接替换文件（推荐）

cd /var/www/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/* .

版本号去 GitHub 查最新： https://github.com/swagger-api/swagger-ui/releases

方式 B：Docker 更新

docker pull swaggerapi/swagger-ui
docker restart swagger-ui

✅ 场景 2：Swagger Editor

docker pull swaggerapi/swagger-editor
docker restart swagger-editor

或下载最新：

wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v5.17.14.zip

✅ 场景 3：Spring Boot 项目

springdoc-openapi（推荐）

修改 pom.xml：

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

更新：

mvn clean package

springfox（已淘汰）

不建议再用，建议迁移到 springdoc。

✅ 场景 4：OpenAPI / Swagger CLI

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

或

brew install openapi-generator

三、更新后常见问题

❌ 页面空白

检查 index.html 中 url 指向的 JSON 是否正确
Nginx 是否有权限

❌ 版本不兼容

Swagger UI 5.x 不兼容老 swagger.json
用 OpenAPI 3.0+

四、我可以更精准帮你

你可以告诉我：

用的是 Swagger UI / Editor / Spring Boot / CLI
是 Docker 还是原生部署
Linux 发行版（CentOS / Ubuntu）

我可以直接给你一条可复制执行的命令。