linux swagger如何升级

linux

小樊

2026-10-24 04:42:41

栏目: 智能运维

在 Linux 上升级 Swagger（通常指 Swagger UI / Swagger Editor / Swagger Codegen / OpenAPI 工具）要看你具体用的是哪一种。下面按常见情况说明：

一、如果你用的是 Swagger UI（Web 静态文件）

1. 查看当前版本

cat swagger-ui/package.json | grep version

2. 升级方式（推荐）

直接下载最新 release：

cd /opt
rm -rf swagger-ui
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.17.14.tar.gz
tar -zxvf v5.17.14.tar.gz
mv swagger-ui-5.17.14 swagger-ui

或如果是 npm 项目：

npm install swagger-ui-dist@latest

二、如果你用的是 Swagger Editor

方式 1：Docker（最推荐）

docker pull swaggerapi/swagger-editor:latest
docker run -d -p 8080:8080 swaggerapi/swagger-editor

方式 2：静态文件

wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v5.11.5.tar.gz
tar -zxvf v5.11.5.tar.gz

三、如果你用的是 Swagger Codegen

1. 查看版本

java -jar swagger-codegen-cli.jar version

2. 升级（下载新版 jar）

wget https://repo1.maven.org/maven2/io/swagger/codegen/v3/swagger-codegen-cli/3.0.54/swagger-codegen-cli-3.0.54.jar
mv swagger-codegen-cli-3.0.54.jar swagger-codegen-cli.jar

四、如果你用的是 OpenAPI Generator（Swagger 的继任者）

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

五、如果你是用 apt / yum 安装的（较少见）

sudo apt update
sudo apt upgrade swagger*

六、升级前建议

备份旧配置（swagger-config.yaml、index.html）
检查 API 文档是否兼容新版本
如果是生产环境，先在测试机验证

如果你能告诉我：

用的是 Swagger UI / Editor / Codegen / Springfox / springdoc
是 Docker / 源码 / npm / jar

我可以给你精确升级命令。