如何在Linux系统中使用Swagger进行API调试

在 Linux 系统中使用 Swagger 进行 API 调试，可以通过以下步骤实现：

方法 1：使用 Docker 快速启动 Swagger UI

安装 Docker（如未安装）

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install docker.io
# CentOS
sudo yum install docker && sudo systemctl start docker

拉取并运行 Swagger UI 容器

# 运行容器并将本地 OpenAPI 文件挂载到容器中
docker run -d -p 8080:8080 -v /path/to/your/openapi.yaml:/usr/share/nginx/html/openapi.yaml swaggerapi/swagger-ui

将 /path/to/your/openapi.yaml 替换为你的 OpenAPI 规范文件路径。
访问 http://localhost:8080 即可看到 Swagger UI 界面。

方法 2：通过 Node.js 安装 Swagger UI

安装 Node.js 和 npm

# Ubuntu/Debian
sudo apt-get install nodejs npm
# CentOS
sudo yum install nodejs npm

全局安装 http-server 和 Swagger UI

npm install -g http-server
git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui/dist

配置 OpenAPI 文件
- 将你的 openapi.yaml 或 openapi.json 文件复制到 dist 目录。
- 修改 dist/index.html，指定你的 OpenAPI 文件路径：
```
const ui = SwaggerUIBundle({
  url: "openapi.yaml", // 修改为你的文件名
  // ...其他配置
});
```
启动本地服务
```
http-server -p 8080
```
- 访问 http://localhost:8080 即可调试 API。

方法 3：使用 Swagger Editor 编写并调试

在线使用（无需安装）
- 访问 Swagger Editor，直接在浏览器中编写 YAML/JSON 文件并测试 API。

本地运行 Swagger Editor

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

访问 http://localhost:8081 本地编辑和调试。

调试步骤

编写 OpenAPI 规范文件

示例 openapi.yaml：

openapi: 3.0.0
info:
  title: Sample API
  version: 1.0.0
paths:
  /test:
    get:
      summary: 测试接口
      responses:
        200:
          description: 成功响应