溫馨提示×

如何在Linux中使用Swagger UI

小樊
62
2025-02-25 07:20:47
欄目: 智能運維

在Linux中使用Swagger UI可以通過以下幾種方法實現:

使用Docker容器部署

  1. 安裝Docker: 如果你還沒有安裝Docker,請先安裝它。在Ubuntu上,可以使用以下命令安裝Docker:

    sudo apt update
    sudo apt install -y docker.io
    sudo systemctl start docker
    sudo systemctl enable docker
    
  2. 拉取并運行Swagger UI容器

    docker pull swaggerapi/swagger-ui:v4.6.0
    docker run -d -p 38080:8080 swaggerapi/swagger-ui:v4.6.0
    

    這將啟動Swagger UI容器,默認情況下可以通過訪問http://localhost:38080來查看。

使用npm在Node.js項目中安裝和部署

  1. 安裝Node.js和npm: 如果你還沒有安裝Node.js和npm,可以使用以下命令安裝:

    curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
    sudo apt-get install -y nodejs
    
  2. 創建并啟動一個簡單的Express應用

    mkdir my-swagger-app
    cd my-swagger-app
    npm init -y
    npm install express
    
  3. 創建index.js文件

    var express = require('express');
    var app = express();
    app.use('/swagger', express.static('node_modules/swagger-ui/dist'));
    app.listen(3000, function () {
        console.log('App is running on port 3000');
    });
    
  4. 啟動應用

    node index.js
    
  5. 訪問Swagger UI: 打開瀏覽器,訪問http://localhost:3000/swagger,你應該能看到Swagger UI的界面。

使用HTTP服務器部署

  1. 下載Swagger UI: 你可以從Swagger的GitHub倉庫下載最新版本的Swagger UI:https://github.com/swagger-api/swagger-ui

  2. 解壓文件

    unzip v2.4.27.zip
    
  3. 創建一個簡單的HTTP服務器

    mkdir public
    cp -r swagger-ui/dist/* public/
    
  4. 創建index.html文件: 在public目錄下創建一個index.html文件,內容如下:

    <!DOCTYPE html>
    <html>
    <head>
        <link rel="stylesheet" type="text/css" href="swagger-ui.css">
    </head>
    <body>
        <div id="swagger-ui"></div>
        <script src="swagger-ui.js"></script>
        <script>
            window.onload = function() {
                // Begin Swagger UI call region
                const ui = SwaggerUIBundle({
                    url: "http://petstore.swagger.io/v2/swagger.json",
                    dom_id: '#swagger-ui',
                    deepLinking: true,
                    presets: [
                        SwaggerUIBundle.presets.apis,
                        SwaggerUIStandalonePreset
                    ],
                    plugins: [
                        SwaggerUIBundle.plugins.DownloadUrl
                    ],
                    layout: "StandaloneLayout"
                });
                // End Swagger UI call region
                window.ui = ui;
            }
        </script>
    </body>
    </html>
    
  5. 啟動HTTP服務器

    node public/index.html
    
  6. 訪問Swagger UI: 打開瀏覽器,訪問http://localhost:8080,你應該能看到Swagger UI的界面。

通過以上步驟,你可以在Linux系統中成功部署和使用Swagger UI。選擇適合你的方法進行操作即可。

0
亚洲午夜精品一区二区_中文无码日韩欧免_久久香蕉精品视频_欧美主播一区二区三区美女