linux swagger如何安装

在 Linux 上安装 Swagger，常见有几种方式，取决于你指的是 Swagger UI、Swagger Editor，还是 Swagger Codegen / OpenAPI Generator。下面按使用场景给你最常用、最实用的安装方法。

一、安装 Swagger UI（最常用）

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

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

访问：

http://localhost:8080

（可挂载本地 swagger.json 文件）

✅ 方式 2：用 Node.js 安装（适合开发）

1. 安装 Node.js（以 Ubuntu 为例）：

sudo apt update
sudo apt install -y nodejs npm

2. 安装 Swagger UI：

npm install -g swagger-ui-dist

3. 启动（使用 http-server）：

npx http-server node_modules/swagger-ui-dist

访问：

http://localhost:8080

✅ 方式 3：Nginx / 静态部署

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

用 Nginx 指向 dist 目录即可。

二、安装 Swagger Editor（在线编辑 OpenAPI）

✅ Docker 方式（推荐）

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

访问：

http://localhost:8081

✅ 本地静态方式

git clone https://github.com/swagger-api/swagger-editor.git
cd swagger-editor
npm install
npm run build
npx http-server dist

三、安装 Swagger Codegen（生成代码）

✅ 方式 1：下载 jar 包（最简单）

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

示例生成 Java 客户端：

java -jar swagger-codegen-cli-3.0.46.jar generate \
  -i swagger.json \
  -l java \
  -o ./java-client

✅ 方式 2：使用 OpenAPI Generator（推荐替代）

docker run -it --rm \
  -v $(pwd):/local \
  openapitools/openapi-generator-cli generate \
  -i /local/swagger.json \
  -g go \
  -o /local/out

四、如果你是 Java / Spring Boot 项目

Maven 依赖（Swagger 2）

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-boot-starter</artifactId>
  <version>3.0.0</version>
</dependency>

或 SpringDoc OpenAPI（推荐）：

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

访问：

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

五、常见 Linux 发行版快速安装总结

六、你可以告诉我：

1. ✅ 用的是 哪个 Linux 发行版？
2. ✅ 是 前端 / 后端 / 微服务？
3. ✅ Swagger 是 查看接口 / 写接口 / 生成代码？

我可以直接给你 一条命令就能跑起来 的方案 ✅