Linux下Swagger如何實現API文檔的離線查看

在Linux下，要實現Swagger API文檔的離線查看，你可以按照以下步驟操作：

1. 首先，確保你已經安裝了Java和Maven。如果沒有，請訪問以下鏈接進行安裝：

   • Java: https://www.oracle.com/java/technologies/javase-jdk14-downloads.html
   • Maven: https://maven.apache.org/download.cgi

2. 克隆Swagger UI的GitHub倉庫：

   git clone https://github.com/swagger-api/swagger-ui.git
   

3. 進入swagger-ui目錄：

   cd swagger-ui
   

4. 安裝依賴：

   mvn clean install
   

5. 構建項目：

   mvn -DskipTests package
   

6. 構建完成后，你會在swagger-ui/target目錄下找到一個名為swagger-ui-standalone-preset.zip的文件。這個文件包含了Swagger UI的所有資源，包括CSS、JavaScript和API文檔。

7. 解壓swagger-ui-standalone-preset.zip文件到一個合適的目錄，例如/opt/swagger-ui：

   sudo unzip swagger-ui-standalone-preset.zip -d /opt/swagger-ui
   

8. 現在，你可以使用一個簡單的HTTP服務器來運行Swagger UI。進入/opt/swagger-ui/swagger-ui-dist目錄，然后使用Python 3啟動HTTP服務器：

   cd /opt/swagger-ui/swagger-ui-dist
   python3 -m http.server 8080
   

9. 打開瀏覽器，訪問http://localhost:8080，你應該可以看到Swagger UI界面。在這里，你可以瀏覽和查看API文檔。

10. 若要查看特定API文檔，你可以將API文檔（通常是YAML或JSON格式）放到/opt/swagger-ui/swagger-ui-dist/swagger.json文件的位置，并在Swagger UI界面中選擇該文件。

現在你已經成功實現了在Linux下Swagger API文檔的離線查看。