在Debian系統上搭建Swagger，通常是指使用Swagger UI來展示和測試你的API。Swagger UI是一個流行的工具，它允許用戶查看RESTful API的交互式文檔。以下是在Debian上安裝和配置Swagger UI的基本步驟：
安裝Node.js和npm： Swagger UI可以通過Node.js來運行。首先，你需要安裝Node.js和npm（Node.js的包管理器）。
sudo apt update
sudo apt install nodejs npm
你可以通過運行以下命令來檢查Node.js和npm是否安裝成功：
node -v
npm -v
安裝Swagger UI Express： Swagger UI Express是一個Node.js模塊，它可以將Swagger UI集成到你的Express應用中。
創建一個新的目錄來存放你的項目，并在該目錄中初始化一個新的Node.js項目：
mkdir swagger-ui-express
cd swagger-ui-express
npm init -y
然后，安裝Swagger UI Express：
npm install swagger-ui-express
下載Swagger JSON文件： 你需要一個Swagger JSON文件來描述你的API。這個文件通常是由你的后端開發人員提供的，或者是你自己根據OpenAPI規范編寫的。你可以從你的后端項目中獲取這個文件，或者從一個公開的API文檔中下載。
假設你已經有了一個名為swagger.json的文件，并將其放在了項目目錄中。
設置Swagger UI Express服務器：
創建一個名為app.js的文件，并添加以下代碼來設置Swagger UI Express服務器：
const express = require('express');
const swaggerUi = require('swagger-ui-express');
const YAML = require('yamljs');
// Load Swagger document
const swaggerDocument = YAML.load('./swagger.json');
const app = express();
// Serve Swagger docs
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
console.log(`Server is running at http://localhost:${PORT}/api-docs`);
});
在這段代碼中，我們首先引入了必要的模塊，然后加載了Swagger JSON文件，并設置了一個Express服務器來托管Swagger UI。
運行服務器： 在項目目錄中運行以下命令來啟動服務器：
node app.js
現在，你可以在瀏覽器中訪問http://localhost:3000/api-docs來查看你的API文檔。
請注意，這些步驟假設你已經有了一個Swagger JSON文件。如果你的后端API還沒有Swagger支持，你可能需要使用Swagger工具（如Swagger Editor或SwaggerHub）來創建和維護你的API文檔。此外，如果你想要將Swagger UI集成到現有的Express應用中，你可能需要對你的應用進行一些額外的配置。
