怎么在Linux运行Swagger

在 Linux 上“运行 Swagger”通常有几种常见含义，下面按使用场景给你最实用的做法。你可以对照看看你属于哪一种。

一、最常见：运行 Swagger Editor（在线编辑 OpenAPI）

✅ 方式 1：用 Docker（最推荐）

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

然后浏览器访问：

http://localhost:8080

✅ 适合：写 / 测试 OpenAPI（Swagger）文档

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

git clone https://github.com/swagger-api/swagger-editor.git
cd swagger-editor
npm install
npm run dev

访问：

http://localhost:3001

二、运行 Swagger UI（展示已有 API 文档）

✅ 方式 1：Docker（最简单）

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

访问：

http://localhost:8081

如果你想加载自己的 swagger.yaml：

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

✅ 方式 2：直接 Nginx / 静态方式

wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.17.14.zip
unzip v5.17.14.zip

把 dist/ 目录放到 Nginx 或任何 Web 服务即可。

三、在 Java / Spring Boot 项目中使用 Swagger（非常常见）

1️⃣ 添加依赖（Springfox 已过时，推荐 springdoc）

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

2️⃣ 启动 Spring Boot 项目

访问：

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

或（新版本）：

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

✅ 适合：后端接口自动生成文档

四、用 Swagger Codegen（生成代码）

docker run --rm \
  -v $(pwd):/local \
  swaggerapi/swagger-codegen-cli \
  generate \
  -i /local/swagger.yaml \
  -l java \
  -o /local/out

五、快速判断你该用哪个

你的需求	推荐方案
写 / 测试 API 文档	Swagger Editor
展示已有 API	Swagger UI
Spring Boot 项目	springdoc-openapi
生成客户端/服务端代码	Swagger Codegen
不想装环境	✅ Docker

六、常见问题

❓ Linux 没有 GUI 能跑吗？

✅ 可以，Swagger 是 Web 服务，用浏览器访问即可。

❓ 和 OpenAPI 是什么关系？

Swagger = 老名字
OpenAPI = 新标准
Swagger 工具支持 OpenAPI 3.x

如果你愿意，可以告诉我：

✅ 你是 Java / Python / Node
✅ 是 写文档 还是 接接口
✅ 是否已有一个 swagger.yaml

我可以直接给你一条最适合你环境的命令。