怎么用Debian测Swagger

在 Debian 上“测 Swagger”通常有两种理解：

1. 测你自己的 Swagger / OpenAPI 接口（本地起服务 + 访问 Swagger UI）
2. 在 Debian 上安装并使用 Swagger 工具（如 swagger-cli、swagger-codegen、Postman、curl 等）

下面按最常见场景给你一个完整可操作的 Debian 示例。

一、在 Debian 上准备环境

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装基础工具

sudo apt install -y curl wget openjdk-17-jre unzip nodejs npm

二、方式一：本地起一个 Swagger 服务测试（最推荐）

示例：用 Node + Express + Swagger UI

1. 新建项目

mkdir swagger-test
cd swagger-test
npm init -y

2. 安装依赖

npm install express swagger-ui-express yamljs

3. 创建 swagger.yaml

swagger: "2.0"
info:
  title: Demo API
  version: "1.0.0"
paths:
  /hello:
    get:
      summary: Say hello
      responses:
        200:
          description: OK

4. 创建 app.js

const express = require("express");
const swaggerUi = require("swagger-ui-express");
const yaml = require("yamljs");

const swaggerDocument = yaml.load("./swagger.yaml");
const app = express();

app.use("/api-docs", swaggerUi.serve, swaggerUi.setup(swaggerDocument));

app.listen(3000, () => {
  console.log("Swagger UI: http://localhost:3000/api-docs");
});

5. 启动

node app.js

浏览器访问：

http://localhost:3000/api-docs

✅ 这就是在 Debian 上“测 Swagger UI”

三、方式二：用 curl 测 Swagger 接口

如果 Swagger 已存在：

curl http://localhost:3000/hello

如果 Swagger 是 OpenAPI JSON：

curl http://localhost:8080/v3/api-docs

四、方式三：用 Swagger CLI 校验 OpenAPI 文件（Debian 常用）

安装

npm install -g swagger-cli

校验

swagger-cli validate swagger.yaml

输出：

swagger.yaml is valid

五、方式四：用 Docker（最干净）

docker run -p 8080:8080 \
  -e SWAGGER_JSON=/swagger.yaml \
  -v $(pwd):/usr/src/app \
  swaggerapi/swagger-ui

访问：

http://localhost:8080

六、常见测试组合（推荐）

如果你愿意，可以告诉我：

• 你是 测自己写的 API 还是 测别人的 Swagger
• 用 Java / Python / Go / Node
• 想 看文档 / 自动化测试 / 生成代码

我可以直接给你对应 Debian 实操方案。