在 Debian 上“升级 Swagger 版本”需要先明确你指的是 哪一种 Swagger / OpenAPI 相关组件,因为不同场景升级方式完全不同:
通常是:
swagger-ui✅ 升级方式(最常用):
cd /var/www/html/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/* .
或直接使用 CDN(不升级服务器文件):
<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
例如 Java 项目:
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>2.6.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>3.0.0</version>
</dependency>
⚠️ Debian 本身不管理这些依赖,由 Maven / Gradle 控制
如果是命令行工具:
pip install --upgrade openapi-generator-cli
wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.x.x/openapi-generator-cli-7.x.x.jar
先检查是否存在:
dpkg -l | grep -i swagger
⚠️ 官方 Debian 仓库 几乎没有 swagger 相关包
如果有,通常是第三方或旧版本,建议直接删掉:
apt remove swagger-ui
确认你现在用的是什么 Swagger
find / -iname "*swagger*"
不要依赖 apt 升级 Swagger
前端 → 替换 dist
后端 → 升级依赖版本
CLI → 下载新 jar / pip upgrade
你可以告诉我:
我可以直接给你 一条可执行的升级命令。