debian怎么生成swagger

debian

小樊

2026-10-13 13:18:55

栏目: 智能运维

在 Debian 上“生成 Swagger”通常有两种常见场景：

为后端代码（如 Java / Go / Python）自动生成 Swagger 文档
在 Debian 上搭建 Swagger UI 来查看/测试 API

下面按常见情况给你说明。

一、常见方式：代码里生成 Swagger（推荐）

1️⃣ Java（Spring Boot）

sudo apt update
sudo apt install openjdk-17-jdk maven -y

在 pom.xml 中加入：

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

启动后访问：

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

2️⃣ Go（swaggo）

sudo apt install golang-go -y
go install github.com/swaggo/swag/cmd/swag@latest

在代码里写注释后生成：

swag init

生成：

docs/docs.go

访问：

http://localhost:8080/swagger/index.html

3️⃣ Python（FastAPI / Flask）

pip install fastapi uvicorn

FastAPI 自带 Swagger：

http://localhost:8000/docs

二、Debian 上部署 Swagger UI（看已有 JSON）

如果你已经有 swagger.json：

sudo apt install nginx -y
sudo mkdir -p /var/www/swagger
cd /var/www/swagger
git clone https://github.com/swagger-api/swagger-ui.git

配置 Nginx：

server {
    listen 80;
    root /var/www/swagger/swagger-ui/dist;
    index index.html;
}

把你的 swagger.json 放进去即可访问。

三、用 Docker（最简单）

docker run -p 8080:8080 \
  -e SWAGGER_JSON=/swagger.json \
  -v $PWD/swagger.json:/swagger.json \
  swaggerapi/swagger-ui

四、你具体是哪种情况？

你可以告诉我：

用什么语言（Java / Go / Python / Node）
是想自动生成还是展示已有接口
是否用 Docker

我可以直接给你可复制的命令。