如何在Ubuntu上使用Swagger UI

988
2025/3/26 9:32:05
栏目: 智能运维
开发者测试专用服务器限时活动,0元免费领,库存有限,领完即止! 点击查看>>

在Ubuntu上使用Swagger UI可以通过以下步骤完成:

方法一:从GitHub下载并安装

  1. 安装Node.js和npm
  • 首先,确保你的系统上已经安装了Node.js和npm。如果没有安装,可以参考Node.js官方文档进行安装。
  1. 下载并解压Swagger UI
  • 打开终端,使用git clone命令克隆Swagger UI的GitHub仓库:

    git clone https://github.com/swagger-api/swagger-ui.git
    
  • 进入克隆下来的目录:

    cd swagger-ui
    
  1. 安装Express(如果需要):
  • Swagger UI可以使用Express来提供静态文件服务。安装Express:

    npm install express --save
    
  1. 启动Swagger UI
  • 在Swagger UI目录下,创建一个index.js文件,并添加以下内容:

    var express = require('express');
    var app = express();
    app.use('/swagger', express.static('dist'));
    app.get('/', function (req, res) {
      res.send('Hello World!');
    });
    app.listen(3000, function () {
      var host = server.address().address;
      var port = server.address().port;
      console.log("Example app listening on port " + port + "!");
    });
    
  • 启动服务器:

    node index.js
    
  1. 访问Swagger UI
  • 打开浏览器,访问http://localhost:3000/swagger,你应该能看到Swagger UI的界面。

方法二:使用npm全局安装

  1. 安装Swagger UI
  • 使用npm全局安装Swagger UI:

    npm install -g swagger-ui
    
  1. 启动Swagger UI
  • 安装完成后,可以通过以下命令启动Swagger UI:

    swagger-ui
    
  1. 访问Swagger UI
  • 默认情况下,Swagger UI会在http://localhost:8080/上运行。打开浏览器,访问该地址即可。

方法三:使用在线版Swagger UI

  • 如果你不想在本地安装Swagger UI,可以直接访问Swagger UI的在线版,点击页面上的Live Demo按钮即可在线使用Swagger UI。

请注意,以上方法可能会随着Swagger UI版本的更新而发生变化,建议参考最新的官方文档进行操作。

辰迅云「云服务器」,即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘,价格低至29元/月。点击查看>>

推荐阅读: Apache2配置中如何使用环境变量