在Debian環境下搭建Swagger，通常是指使用Swagger UI來展示和測試RESTful API。以下是搭建Swagger UI的步驟：
安裝Node.js和npm： Swagger UI可以通過Node.js來運行。首先，你需要安裝Node.js和npm（Node.js的包管理器）。
sudo apt update
sudo apt install nodejs npm
安裝完成后，你可以通過運行以下命令來檢查它們的版本，確保它們已經正確安裝：
node -v
npm -v
安裝Swagger UI Express： Swagger UI Express是一個可以讓Swagger UI與Express應用程序集成的Node.js中間件。
npm install swagger-ui-express
創建一個簡單的Express應用程序：
創建一個新的目錄來存放你的項目，并在該目錄中創建一個名為app.js的文件。
mkdir swagger-demo
cd swagger-demo
touch app.js
編輯app.js文件，添加以下代碼來創建一個簡單的Express服務器，并集成Swagger UI：
const express = require('express');
const swaggerUi = require('swagger-ui-express');
const YAML = require('yamljs');
// 讀取Swagger文檔
const swaggerDocument = YAML.load('./swagger.yaml');
const app = express();
// 使用swagger-ui-express中間件
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`);
});
在這個例子中，我們使用了yamljs庫來加載Swagger文檔。你需要創建一個名為swagger.yaml的文件，并填入你的API定義。
創建Swagger文檔：
創建一個swagger.yaml文件，并填入你的API定義。這是一個簡單的示例：
swagger: '2.0'
info:
title: Sample API
description: A sample API to demonstrate Swagger UI on Debian.
version: '1.0.0'
host: localhost:3000
basePath: /api-docs
schemes:
- http
paths:
/users:
get:
summary: List all users
responses:
'200':
description: An array of users
schema:
type: array
items:
$ref: '#/definitions/User'
definitions:
User:
type: object
properties:
id:
type: integer
format: int64
name:
type: string
required:
- id
- name
運行你的應用程序： 在項目目錄中運行以下命令來啟動你的Express服務器：
node app.js
打開瀏覽器并訪問http://localhost:3000/api-docs，你應該能夠看到Swagger UI界面，其中展示了你的API文檔。
以上步驟是在Debian環境下搭建Swagger UI的基本流程。根據你的具體需求，你可能需要對Swagger文檔進行更詳細的配置，或者對你的Express應用程序進行更多的定制。
