在Debian系統上搭建Swagger文檔，通常需要以下幾個步驟：
安裝必要的軟件包：
確保你的Debian系統是最新的，并且安裝了必要的軟件包，比如nodejs、npm（Node.js的包管理器）和swagger-ui-express（一個用于展示Swagger文檔的Express中間件）。
sudo apt update
sudo apt upgrade
sudo apt install nodejs npm
你可以通過運行node -v和npm -v來檢查Node.js和npm是否安裝成功。
創建項目目錄： 創建一個新的目錄來存放你的Swagger文檔和相關文件。
mkdir swagger-project
cd swagger-project
初始化Node.js項目： 使用npm初始化一個新的Node.js項目。
npm init -y
安裝swagger-ui-express：
安裝swagger-ui-express包，它將幫助你在Express應用中集成Swagger UI。
npm install swagger-ui-express
創建Swagger文檔：
創建一個名為swagger.json的文件，或者使用Swagger Editor在線創建你的API文檔，然后將其保存到項目目錄中。
你可以手動編寫swagger.json文件，或者使用Swagger Editor（https://editor.swagger.io/）來編寫和測試你的API文檔。編輯完成后，將生成的swagger.json文件下載到你的項目目錄中。
設置Express服務器：
創建一個名為server.js的文件，并設置一個基本的Express服務器，集成Swagger UI。
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));
// Start the server
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
console.log(`Server is running on port ${PORT}`);
});
在這個文件中，我們使用swagger-ui-express來設置Swagger UI，并將我們的swagger.json文件作為API文檔源。
運行服務器： 使用以下命令啟動你的Express服務器。
node server.js
服務器啟動后，你可以在瀏覽器中訪問http://localhost:3000/api-docs來查看你的Swagger文檔。
請注意，這些步驟假設你已經有了一個Swagger定義文件（swagger.json）。如果你還沒有這個文件，你需要根據你的API規范來創建它。Swagger規范是一個詳細的描述，定義了你的API的端點、參數、請求和響應格式等。你可以手動編寫這個文件，或者使用Swagger Editor來幫助你生成。
