Swagger在Linux里怎樣部署

Swagger在Linux下主要有兩種部署方式：

一、Docker容器部署（推薦）

1. 安裝Docker

   sudo apt update && sudo apt install docker.io  
   sudo systemctl start docker && sudo systemctl enable docker  
   

2. 拉取并運行Swagger鏡像
   • Swagger Editor（在線編輯API文檔）

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

   • Swagger UI（查看API文檔）

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

3. 訪問服務
   • Swagger Editor：http://服務器IP:38080
   • Swagger UI：http://服務器IP:38081

二、手動部署（需配置環境）

1. 安裝Node.js和npm

   sudo apt update && sudo apt install nodejs npm  
   

2. 部署Swagger UI
   • 下載并解壓：

     git clone https://github.com/swagger-api/swagger-ui.git  
     cd swagger-ui && npm install  
     

   • 配置Web服務器（以Nginx為例）：

     sudo cp -r swagger-ui/dist/* /var/www/html/  
     sudo nano /etc/nginx/sites-available/default  
     # 修改root指向/var/www/html，并添加try_files規則  
     sudo systemctl restart nginx  
     

3. 訪問Swagger UI
   http://服務器IP/swagger-ui（需將解壓后的文件放在Web根目錄）

三、注意事項

• 若需自定義API文檔，需在項目目錄中添加swagger.json或swagger.yaml文件，并在部署時指定路徑。
• 確保服務器防火墻開放對應端口（如80、8080）。

以上步驟參考自，可根據實際需求選擇部署方式。