温馨提示×

Debian下Swagger怎更新

小樊
38
2026-09-28 20:46:15
栏目: 智能运维

在 Debian 下“更新 Swagger”通常分几种情况,我先按最常见场景说明,你可对号入座。


一、如果你用的是 Swagger UI(前端静态页面)

1️⃣ 通过 apt 安装的(较少见)

sudo apt update
sudo apt upgrade swagger-ui

注意:Debian 官方仓库里 通常没有 swagger-ui 包,多半是你手动放的。


2️⃣ 手动部署的 Swagger UI(最常见)

一般目录在:

/var/www/html/swagger-ui

更新步骤:

cd /var/www/html
sudo rm -rf swagger-ui
sudo wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.tar.gz
sudo tar -xzf v5.x.x.tar.gz
sudo mv swagger-ui-5.x.x swagger-ui

或修改 swagger-ui/dist/index.html 里的:

url: "https://your-api/swagger.json"

二、如果你用的是 Springdoc / Swagger(Java 后端)

Springdoc OpenAPI

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

更新方式:

mvn clean package
systemctl restart your-app

访问:

http://localhost:8080/swagger-ui.html

三、如果你装的是 swagger-cli / editor(Node 环境)

更新 swagger-cli

sudo npm install -g swagger-cli@latest
swagger-cli --version

更新 swagger-editor

docker pull swaggerapi/swagger-editor

或重新下载:

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

四、如果你用的是 Docker 版 Swagger

docker pull swaggerapi/swagger-ui
docker stop swagger-ui
docker rm swagger-ui
docker run -d -p 8080:8080 \
  -e SWAGGER_JSON=/foo/swagger.json \
  swaggerapi/swagger-ui

五、快速确认你当前是哪种

你可以发我以下信息之一:

  • which swagger
  • dpkg -l | grep swagger
  • 你是 前后端分离 还是 Spring Boot
  • 访问地址(如 /swagger-ui.html)

我可以给你精确的一步到位更新命令。

0 踩