温馨提示×

debian怎样更新swagger

小樊
47
2026-10-19 08:42:33
栏目: 智能运维

在 Debian 上“更新 Swagger”具体要看你指的是哪一种 Swagger / OpenAPI 相关组件,因为不同场景更新方式差别很大。下面按常见情况分类说明。


一、如果你指的是「Swagger UI / Swagger Editor」(前端静态页面)

1. 通过 npm 安装(开发环境)

如果你是用 Node.js 管理的:

npm install swagger-ui-dist@latest
# 或
npm install swagger-ui@latest

更新后重启前端服务即可。

2. 手动替换静态文件(常见生产做法)

Swagger UI 本质是一堆静态文件:

cd /var/www/html/swagger
rm -rf *
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/* .

然后刷新浏览器(注意清缓存)。


二、如果你指的是「Springfox / springdoc-openapi」(Java 后端)

这不是 Debian 系统包,而是 Maven / Gradle 依赖:

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

更新方式:

  • 修改 pom.xml 或 build.gradle
  • 重新 mvn clean package
  • 重启 Java 服务

三、如果你指的是「Swagger Codegen / OpenAPI Generator」

1. 如果是 jar 包

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

2. 如果是 npm 版本

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

四、如果你是用 Docker 跑的 Swagger

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

五、Debian 系统本身并不提供“swagger”包

你可以确认一下:

apt list --installed | grep -i swagger

通常不会有结果,因为 Swagger 一般是:

  • 前端静态文件
  • 编程语言依赖
  • Docker 容器

六、建议告诉我以下信息,我可以给你精确命令

  1. Swagger 是怎么部署的?(Docker / Nginx / Java / Node)
  2. 当前版本是多少?
  3. 你想更新到哪个版本?

这样我可以一步到位给你命令。

0 踩