在Debian系統上搭建Swagger服務，通常是指使用Swagger UI來展示和測試RESTful API。Swagger UI是一個可視化工具，它允許用戶查看API的描述，并與API進行交互。以下是搭建Swagger服務的步驟：
安裝Node.js和npm： Swagger UI可以通過Node.js來運行。首先，你需要在Debian系統上安裝Node.js和npm（Node.js的包管理器）。
sudo apt update
sudo apt install nodejs npm
你可以通過運行node -v和npm -v來檢查Node.js和npm是否安裝成功。
安裝Swagger UI Express： Swagger UI Express是一個基于Express的Swagger UI中間件。在你的項目目錄中，使用npm來安裝它。
npm init -y
npm install swagger-ui-express
創建一個簡單的Express應用：
創建一個名為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文檔提供給Swagger UI
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}`);
});
編寫Swagger文檔：
創建一個名為swagger.yaml的文件，并按照OpenAPI Specification編寫你的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
運行你的應用：
在終端中，導航到包含app.js的目錄，并運行以下命令來啟動你的應用。
node app.js
訪問Swagger UI：
打開瀏覽器并訪問http://localhost:3000/api-docs，你應該能夠看到Swagger UI界面，它將展示你的API文檔，并允許你進行交互式測試。
請注意，這些步驟假設你已經有了一個RESTful API，并且你想要使用Swagger UI來展示它。如果你的API還沒有實現，你需要先創建API的端點，并確保它們按照Swagger文檔中描述的那樣工作。
