Swagger在Linux上如何部署

在Linux上部署Swagger主要有兩種方式：使用Docker容器部署和使用傳統的安裝步驟。以下是詳細的步驟：

使用Docker容器部署

1. 安裝Docker： 如果你還沒有安裝Docker，首先需要在你的Linux服務器上安裝它?？梢允褂靡韵旅顏戆惭bDocker：

   sudo apt-get update
   sudo apt-get install -y docker.io
   sudo systemctl start docker
   sudo systemctl enable docker
   

2. 部署Swagger Editor：

   • 拉取Swagger Editor的Docker鏡像：

     docker pull swaggerapi/swagger-editor:v4.6.0
     

   • 運行Swagger Editor容器，并將容器的8080端口映射到宿主機的8080端口：

     docker run -d -p 8080:8080 swaggerapi/swagger-editor:v4.6.0
     

   • 現在，你可以在瀏覽器中訪問 http://your-server-ip:8080 來使用Swagger Editor。

3. 部署Swagger UI：

   • 拉取Swagger UI的Docker鏡像：

     docker pull swaggerapi/swagger-ui:v4.15.5
     

   • 運行Swagger UI容器，并將容器的8080端口映射到宿主機的8081端口：

     docker run -d -p 8081:8080 swaggerapi/swagger-ui:v4.15.5
     

   • 在瀏覽器中訪問 http://your-server-ip:8081 來使用Swagger UI。

使用傳統的安裝步驟

1. 安裝Node.js和npm：

   sudo apt-get update
   sudo apt-get install -y nodejs npm
   

2. 下載并解壓Swagger Editor：

   mkdir -p /opt/swagger
   cd /opt/swagger
   wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.16.1.tar.gz
   tar -xvf v3.16.1.tar.gz
   rm v3.16.1.tar.gz
   

3. 安裝Express：

   cd /opt/swagger
   npm install express --save
   

4. 配置并啟動Swagger Editor：

   • 創建一個 index.js 文件：

     vi index.js
     

   • 添加以下內容：

     var express = require('express');
     var app = express();
     app.use('/swagger', express.static('public'));
     app.get('/', function (req, res) {
       res.send('Hello World');
     });
     var server = app.listen(3000, function () {
       var host = server.address().address;
       var port = server.address().port;
       console.log("應用實例,訪問地址為 http://%s:%s", host, port);
     });
     

   • 啟動服務器：

     node index.js
     

   • 在瀏覽器中訪問 http://your-server-ip:3000 來使用Swagger Editor。

5. 部署Swagger UI：

   • 下載Swagger UI：

     wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.48.0.tar.gz
     

   • 解壓Swagger UI：

     tar -xvf v3.48.0.tar.gz
     rm v3.48.0.tar.gz
     

   • 將解壓后的文件復制到Web服務目錄（例如 /var/www/html）：

     sudo cp -r swagger-ui-3.48.0/* /var/www/html/
     

6. 配置并啟動Web服務器（例如Apache或Nginx）：

   • Apache：

     sudo a2ensite default.conf
     sudo systemctl restart apache2
     

   • Nginx：

     sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.baks
     sudo nano /etc/nginx/sites-available/default
     

     修改 server 塊中的 root 和 index 指令：

     server {
       listen 80;
       server_name localhost;
       root /var/www/html;
       index index.html index.htm;
       location / {
         try_files uri uri / /index.html;
       }
     }
     

     保存并退出編輯器，然后重啟Nginx：

     sudo systemctl restart nginx
     

   • 現在，你應該能夠通過瀏覽器訪問 http://your-server-ip/swagger-ui 來使用Swagger UI。

以上就是在Linux上部署Swagger的詳細步驟。根據你的實際需求選擇最合適的方式即可。