如何在Debian上部署Swagger UI

在Debian上部署Swagger UI可以通過多種方式實現，以下是使用Docker和Nginx兩種常見方法的步驟：

方法一：使用Docker部署Swagger UI

1. 安裝Docker： 如果你還沒有安裝Docker，請先安裝它?？梢允褂靡韵旅睿?/p>

   sudo apt update
   sudo apt install docker.io
   

2. 拉取Swagger UI鏡像： 使用Docker Hub上的Swagger UI鏡像：

   docker pull swaggerapi/swagger-ui
   

3. 運行Swagger UI容器： 運行一個容器并映射端口（例如8080）：

   docker run -p 8080:8080 -d swaggerapi/swagger-ui
   

4. 訪問Swagger UI： 打開瀏覽器并訪問 http://<your-debian-ip>:8080，你應該能看到Swagger UI界面。

方法二：使用Nginx和Swagger UI靜態文件部署

1. 安裝Nginx： 如果你還沒有安裝Nginx，請先安裝它：

   sudo apt update
   sudo apt install nginx
   

2. 下載Swagger UI靜態文件： 你可以從Swagger UI的GitHub倉庫下載靜態文件，或者使用以下命令直接下載：

   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-bundle.js
   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-standalone-preset.js
   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui.css
   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-extensions.css
   

3. 創建一個目錄來存放Swagger UI文件：

   sudo mkdir -p /var/www/swagger-ui
   sudo cp swagger-ui-bundle.js swagger-ui-standalone-preset.js swagger-ui.css swagger-ui-extensions.css /var/www/swagger-ui/
   

4. 配置Nginx： 編輯Nginx配置文件 /etc/nginx/sites-available/default，添加以下內容：

   server {
       listen 80;
       server_name <your-debian-ip>;
   
       location /swagger-ui/ {
           root /var/www/swagger-ui;
           try_files $uri $uri/ /swagger-ui/index.html;
       }
   }
   

5. 重啟Nginx：

   sudo systemctl restart nginx
   

6. 訪問Swagger UI： 打開瀏覽器并訪問 http://<your-debian-ip>/swagger-ui/，你應該能看到Swagger UI界面。

方法三：使用Swagger Codegen生成靜態文件

1. 安裝Swagger Codegen： 你可以使用以下命令安裝Swagger Codegen：

   wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.21/swagger-codegen-cli-2.4.21.jar
   sudo mv swagger-codegen-cli-2.4.21.jar /usr/local/bin/swagger-codegen
   sudo chmod +x /usr/local/bin/swagger-codegen
   

2. 生成Swagger UI靜態文件： 使用Swagger Codegen生成靜態文件：

   swagger-codegen generate -i <path-to-your-swagger-spec> -l static -o /var/www/swagger-ui
   

3. 配置Nginx： 參考方法二中的Nginx配置步驟。

4. 重啟Nginx：

   sudo systemctl restart nginx
   

5. 訪問Swagger UI： 打開瀏覽器并訪問 http://<your-debian-ip>/swagger-ui/，你應該能看到Swagger UI界面。

選擇適合你的方法進行部署即可。