ubuntu

Ubuntu Swagger如何安装与配置

小樊
53
2025-04-17 09:40:07
栏目: 智能运维

在Ubuntu上安装和配置Swagger,通常是指安装Swagger UI和Swagger Editor。以下是详细的步骤:

安装Node.js和npm

首先,你需要在Ubuntu上安装Node.js和npm。你可以通过以下命令来安装:

sudo apt update
sudo apt install -y nodejs npm

安装Swagger Editor

  1. 下载Swagger Editor

    访问Swagger Editor的GitHub发布页面,下载最新版本的Swagger Editor。

  2. 解压并启动Swagger Editor

    wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.16.1.tar.gz
    tar -xvf v3.16.1.tar.gz
    cd swagger-editor-3.16.1
    npm install
    npm install -g http-server
    
  3. 启动Swagger Editor

    http-server -p 8080
    

    现在,你可以在浏览器中访问 http://localhost:8080 来使用Swagger Editor。

安装Swagger UI

  1. 下载Swagger UI

    访问Swagger UI的GitHub发布页面,下载最新版本的Swagger UI。

  2. 解压并启动Swagger UI

    wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.48.0.tar.gz
    tar -xvf v3.48.0.tar.gz
    cd swagger-ui-3.48.0
    npm install
    npm install -g http-server
    
  3. 启动Swagger UI

    http-server -p 8081
    

    现在,你可以在浏览器中访问 http://localhost:8081 来使用Swagger UI。

配置Swagger Editor和Swagger UI

使用Swagger进行接口测试

  1. 在Swagger Editor中导入Swagger规范文件

    打开Swagger Editor后,点击“File” - “Import” - “Open File”,然后选择你的 swagger.yamlswagger.json 文件。

  2. 测试API接口:在Swagger Editor中,你可以为每个API接口生成测试用例,也可以直接调用这些接口进行测试。

  3. 在Swagger UI中测试API接口:在Swagger UI中,选择你要测试的API接口,点击“Try it out!”按钮,然后在弹出的对话框中输入必要的参数,最后点击“Execute”按钮来测试接口。

以上步骤应该可以帮助你在Ubuntu上成功安装和配置Swagger,并进行接口测试。如果在安装过程中遇到问题,可以参考相关的官方文档或社区论坛寻求帮助。

0
看了该问题的人还看了