如何在Linux启动Swagger

在 Linux 上“启动 Swagger”通常有几种常见含义，下面按最常见场景给你一个清晰、可操作的说明。如果你指的是其他情况（如 Swagger Editor、Swagger UI、Spring Boot、Node.js 等），可以再告诉我。

一、最常见：启动 Swagger Editor（本地）

Swagger Editor 用于编写和测试 OpenAPI（Swagger）文档。

✅ 方式一：使用 Docker（推荐）

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

然后浏览器访问：

http://localhost:8080

✅ 方式二：直接下载运行（不推荐，较旧）

wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v4.6.0.zip
unzip v4.6.0.zip
cd swagger-editor-4.6.0
npx http-server -p 8080

二、启动 Swagger UI（查看接口文档）

✅ 使用 Docker

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

访问：

http://localhost:8081

三、在 Spring Boot 项目中启用 Swagger

1️⃣ 添加依赖（Swagger 3 / OpenAPI）

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

2️⃣ 启动项目

mvn spring-boot:run

3️⃣ 访问 Swagger UI

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

或（新版本）：

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

四、在 Node.js / Express 中启动 Swagger

npm install swagger-ui-express swagger-jsdoc

const express = require('express');
const swaggerJsdoc = require('swagger-jsdoc');
const swaggerUi = require('swagger-ui-express');

const app = express();

const spec = swaggerJsdoc({
  definition: {
    openapi: '3.0.0',
    info: { title: 'API', version: '1.0.0' }
  },
  apis: ['./index.js']
});

app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(spec));

app.listen(3000);

访问：

http://localhost:3000/api-docs

五、常见问题

❓ Linux 没有 GUI 能启动吗？

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

❓ 端口被占用怎么办？

lsof -i :8080
kill -9 PID

总结（快速选择）

如果你能告诉我：

• ✅ 是 Java / Node / Python？
• ✅ 想 写文档 还是 展示接口？
• ✅ 是否使用 Docker？

我可以给你精确到命令级别的启动方案。