Swagger在CentOS上怎么配置

在CentOS上配置Swagger可以通過以下步驟完成：

安裝Node.js和npm

首先，你需要在CentOS系統上安裝Node.js和npm?？梢酝ㄟ^以下命令來完成安裝：

yum install gcc-c make -y
curl -sL https://rpm.nodesource.com/setup_12.x | bash -
yum install nodejs -y

驗證Node.js和npm是否安裝成功：

node -v
npm -v

安裝Swagger Editor和Swagger UI

使用npm安裝

1. 安裝Swagger Editor：

   • 創建一個新的目錄來存放Swagger-Editor，并下載對應版本的Swagger-Editor源碼包：

     mkdir /opt/swagger
     cd /opt/swagger
     wget https://github.com/swagger-api/swagger-editor/archive/v3.14.0.tar.gz
     tar -xzf v3.14.0.tar.gz
     cd swagger-editor-3.14.0
     npm install -g http-server
     

   • 啟動Swagger Editor服務：

     http-server -p 8080
     

   • 訪問 http://<your-server-ip>:8080 確認可以訪問。

2. 安裝Swagger UI：

   • 在Swagger目錄中，下載并解壓Swagger-UI的最新版：

     cd /opt/swagger
     wget https://github.com/swagger-api/swagger-ui/archive/v3.34.0.tar.gz
     tar -xzf v3.34.0.tar.gz
     cd swagger-ui-3.34.0
     npm init -y
     npm install express --save
     mkdir public
     cp -r swagger-ui-3.34.0/dist/* public/
     

   • 創建 index.js 文件并監聽端口3000：

     cat > index.js <<EOF
     var express = require('express');
     var app = express();
     var http = require('http');
     app.use('/static', express.static('public'));
     app.get('/', function (req, res) { res.send('Hello World!'); });
     app.listen(3000, function () { console.log('Example app listening on port 3000!'); });
     EOF
     

   • 啟動 index.js 服務：

     node index.js
     

   • 訪問 http://<your-server-ip>:3000/static/index.html 確認可以訪問。

使用Docker安裝

如果你更喜歡使用Docker，可以按照以下步驟進行：

1. 安裝Docker：

   sudo yum install docker
   sudo systemctl start docker
   sudo systemctl enable docker
   

2. 拉取Swagger UI鏡像：

   docker pull swaggerapi/swagger-ui-express
   

3. 運行容器：

   docker run -p 80:80 -d swaggerapi/swagger-ui-express
   

   這樣，Swagger UI將會在 http://<your-server-ip> 上可用。

配置Swagger UI以顯示自定義接口文檔

1. 在Swagger Editor中編寫你的接口文檔，并將生成的JSON文件保存到本地。
2. 將JSON文件上傳至 /opt/swagger/public 目錄。
3. 修改 /opt/swagger/public/index.html 文件中的URL，將其指向你的JSON文件：

   url: "/static/你的JSON文件名"
   

4. 刷新頁面即可查看自定義的接口文檔。

通過以上步驟，你應該能夠在CentOS系統上成功安裝并運行Swagger。如果在配置過程中遇到任何問題，請參考相關的官方文檔或尋求社區幫助。