Swagger如何在Linux服務器上部署

在Linux服務器上部署Swagger可以通過多種方式實現，以下是使用Docker容器化部署的步驟，這種方式簡化了安裝過程并提供了靈活的遠程訪問能力。

使用Docker部署Swagger Editor和Swagger UI

1. 安裝Docker： 如果你還沒有安裝Docker，首先需要在你的Linux服務器上安裝它?？梢詤⒖糄ocker官方文檔進行安裝Docker安裝指南。

2. 部署Swagger Editor：

   • 拉取Swagger Editor鏡像：

     docker pull swaggerapi/swagger-editor:v4.6.0
     

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

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

   • 現在，你可以在本地瀏覽器中訪問http://<你的服務器IP>:8088來查看Swagger Editor界面。

3. 部署Swagger UI：

   • 拉取Swagger UI鏡像：

     docker pull swaggerapi/swagger-ui:v4.15.5
     

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

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

   • 在瀏覽器中訪問http://<你的服務器IP>:8080來查看Swagger UI界面。

使用Cpolar實現遠程訪問

1. 安裝Cpolar：

   • 安裝Cpolar工具，它可以幫助我們將本地端口映射到公網地址，實現遠程訪問?？梢詤⒖?a >Cpolar官網獲取安裝命令。

2. 配置Swagger Editor公網地址：

   • 在Swagger Editor中，點擊左側儀表盤的隧道管理，創建一個公網地址隧道。
   • 配置隧道后，你將獲得一個公網地址，可以通過該地址遠程訪問Swagger Editor。

3. 固定公網地址（可選）：

   • 如果你需要一個固定且永久不變的公網地址，可以在Cpolar中配置二級子域名，這樣地址就不會隨機變化。Cpolar固定公網地址教程

使用Apache或Nginx作為Web服務器

如果你更喜歡使用傳統的Web服務器，可以配置Apache或Nginx來托管Swagger UI和Swagger Editor。

1. 配置Apache：

   • 安裝Apache并啟用默認站點配置：

     sudo a2ensite default.conf
     sudo systemctl restart apache2
     

   • 編輯/etc/apache2/sites-available/default文件，確保DocumentRoot指向Swagger UI和Swagger Editor的文件位置。

2. 配置Nginx：

   • 安裝Nginx并配置站點：

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

   • 修改server塊中的root和index指令，然后重啟Nginx：

     sudo systemctl restart nginx
     

通過以上步驟，你可以在Linux服務器上成功部署Swagger，并實現本地或遠程訪問。選擇適合你的方式，并根據需要進行調整。