Swagger在Linux下如何配置

在Linux下配置Swagger主要分為兩個部分：安裝Swagger Editor和Swagger UI。以下是詳細的步驟：

安裝Swagger Editor

1. 安裝Node.js和npm：

• 首先，確保你的系統上已經安裝了Node.js和npm。如果沒有安裝，可以參考Node.js的官方文檔進行安裝。

2. 下載并解壓Swagger Editor：

• 創建一個新的目錄來存放Swagger Editor，例如/opt/swagger-editor。
• 使用wget下載Swagger Editor的最新版本，并解壓到該目錄。

3. 配置全局路徑：

• 編輯~/.bashrc文件，添加以下行以將Swagger Editor的可執行文件路徑添加到全局路徑中：

  export PATH=$PATH:/opt/swagger-editor/bin
  

• 使更改立即生效：

  source ~/.bashrc
  

4. 啟動Swagger Editor：

• 在Swagger Editor目錄中，執行以下命令啟動服務：

  http-server -p 8080
  

• 打開瀏覽器，訪問http://your_server_ip:8080，即可使用Swagger Editor。

安裝Swagger UI

1. 下載Swagger UI：

• 從Swagger的官方GitHub倉庫克隆Swagger UI項目：

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

2. 構建Swagger UI：

• 進入Swagger UI目錄，使用Maven構建項目：

  cd swagger-ui
  mvn clean install
  

3. 部署Swagger UI：

• 將構建好的Swagger UI文件復制到你的Web服務器目錄中，例如/var/www/html：

  sudo cp -r target/swagger-ui-dist/* /var/www/html/
  

4. 配置Web服務器：

• 如果你使用的是Apache：

  • 創建一個虛擬主機配置文件，例如/etc/apache2/sites-available/swagger.conf：

    <VirtualHost *:80>
        ServerName localhost
        DocumentRoot /var/www/html
        <Directory /var/www/html>
            Options Indexes FollowSymLinks AllowOverride All
            Require all granted
        </Directory>
    </VirtualHost>
    

  • 啟用該虛擬主機并重啟Apache：

    sudo a2ensite swagger.conf
    sudo systemctl reload apache2
    

• 如果你使用的是Nginx：

  • 創建一個服務器塊配置文件，例如/etc/nginx/sites-available/swagger：

    server {
        listen 80;
        server_name localhost;
        root /var/www/html;
        index index.html;
        location / {
            try_files $uri $uri/ /index.html;
        }
    }
    

  • 啟用該服務器塊并重啟Nginx：

    sudo ln -s /etc/nginx/sites-available/swagger /etc/nginx/sites-enabled/
    sudo nginx -t
    sudo systemctl reload nginx
    

5. 訪問Swagger UI：

• 打開瀏覽器，訪問http://your_server_ip，即可看到Swagger UI的歡迎頁面。

以上步驟應該可以幫助你在Linux系統上成功配置Swagger Editor和Swagger UI。如果在配置過程中遇到任何問題，請參考相關的官方文檔或尋求社區幫助。