温馨提示×

Swagger Linux版怎么下

小樊
37
2026-08-05 21:23:59
栏目: 智能运维

Swagger 本身是一个 API 文档规范,不是单一软件,所以“Swagger Linux 版怎么下”要看你具体指哪一个工具。下面把 最常见几种情况都给你说明,基本都能在 Linux 上用。


一、最常用:Swagger Editor(写 OpenAPI 文档)

✅ 方式 1:Docker(最推荐,最简单

适合 Linux 服务器 / 桌面

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

浏览器访问:

http://localhost:8080

✅ 优点:

  • 官方支持
  • Linux / Windows / macOS 通用
  • 不用装 Node

✅ 方式 2:Node.js 安装(不推荐新手)

npm install -g swagger-editor
swagger-editor

⚠️ 需要:

  • Linux 已装 Node.js(≥14)

二、Swagger UI(展示 API 文档)

✅ Docker 方式(最常用)

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

访问:

http://localhost:8081

三、Swagger Codegen(生成代码)

✅ 下载 jar(Linux 通用)

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

运行:

java -jar swagger-codegen-cli-3.0.46.jar

四、OpenAPI Generator(比 Swagger Codegen 更新

wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.0.1/openapi-generator-cli-7.0.1.jar
java -jar openapi-generator-cli-7.0.1.jar

五、总结(直接选)

你想干嘛 推荐方式
写 API 文档 ✅ Swagger Editor(Docker)
看 API 文档 ✅ Swagger UI(Docker)
生成代码 ✅ OpenAPI Generator
Linux 服务器 ✅ Docker 方式

如果你愿意,可以告诉我:

  • ✅ 是 Ubuntu / CentOS / 服务器 / 桌面
  • ✅ 是 写文档、看文档、还是生成代码

我可以直接给你 一步一步的命令

0