Linux安装Swagger要几步

linux

小樊

2026-08-21 04:27:48

栏目: 智能运维

在 Linux 上安装 Swagger 通常不是指“安装 Swagger 本身”，而是看你具体要用哪一套工具（Swagger UI、Swagger Editor、还是 Swagger Codegen / OpenAPI Generator）。常见使用场景和步骤如下：

一、确认目标

先明确你要干什么：

需求	推荐
查看 / 调试接口文档	Swagger UI
编写 OpenAPI 文档	Swagger Editor
自动生成代码	OpenAPI Generator（替代 Swagger Codegen）

二、最常用：安装 Swagger UI（最简单）

✅ 方式一：直接用 Docker（推荐）

只需 2 步

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

访问：

http://服务器IP:8080

✅ 适合 90% 的 Linux 场景

✅ 方式二：手动部署（Nginx）

1️⃣ 下载 Swagger UI

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

2️⃣ 部署到 Nginx

cp -r swagger-ui-5.17.14/dist /usr/share/nginx/html/swagger

3️⃣ 访问

http://服务器IP/swagger

三、安装 Swagger Editor（写接口文档）

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

访问：

http://服务器IP:8081

四、安装 Swagger Codegen / OpenAPI Generator

✅ 推荐：OpenAPI Generator（更活跃）

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

生成代码示例：

java -jar openapi-generator-cli.jar generate \
  -i swagger.yaml \
  -g java \
  -o ./out

五、总结：到底要几步？

✅ 最短路径（Docker）

1. docker pull
2. docker run

✅ 非 Docker

1. 下载
2. 解压
3. 部署

六、我可以帮你更精确

你可以直接告诉我：

✅ 是否用 Docker？
✅ 是 Java / Spring Boot / Node / Python？
✅ 只想看文档，还是自动生成代码？

我可以给你 一步不差的命令。