swagger在debian如何运行

在 Debian 上运行 Swagger，常见有几种方式，取决于你指的是 Swagger UI（查看/调试 API） 还是 Swagger Editor（编写 OpenAPI 文档）。下面按最常见场景说明。

一、运行 Swagger UI（最常用）

方式 1：用 Docker 运行（最简单，推荐）

sudo apt update
sudo apt install docker.io -y
sudo systemctl enable --now docker

docker run -p 8080:8080 swaggerapi/swagger-ui

浏览器访问：

http://localhost:8080

如果你有自己的 openapi.yaml：

docker run -p 8080:8080 \
  -e SWAGGER_JSON=/api/openapi.yaml \
  -v $(pwd)/openapi.yaml:/api/openapi.yaml \
  swaggerapi/swagger-ui

方式 2：用 Node.js 本地运行

sudo apt install nodejs npm -y

npx swagger-ui-serve

或

npm install -g swagger-ui-serve
swagger-ui-serve ./openapi.yaml

方式 3：Nginx + 静态文件（生产常用）

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

配置 Nginx 指向 swagger-ui/dist。

二、运行 Swagger Editor

Docker 方式

docker run -p 8081:8080 swaggerapi/swagger-editor

访问：

http://localhost:8081

三、在 Spring Boot 项目中（Java 项目）

如果是 Spring Boot：

• 引入 springdoc-openapi
• 访问：

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

四、常见问题

• 端口被占用：换 -p 8090:8080
• Debian 无 GUI：用 Docker / 命令行即可
• 远程访问：开放防火墙端口

如果你能补充说明：

• 是 Swagger UI / Editor / Codegen
• 是否 Docker / Java / Node
• Debian 版本

我可以给你更精确的命令。