如何在Debian上使用Swagger UI

在Debian上使用Swagger UI，通常是為了與后端API進行交互和測試。以下是一個基本的步驟指南，假設你使用的是Node.js和Nest.js框架：

安裝Node.js和npm

首先，確保你的系統上已經安裝了Node.js和npm。如果沒有安裝，可以通過以下命令安裝：

sudo apt update
sudo apt install -y nodejs npm

安裝Nest.js CLI

使用npm安裝Nest.js CLI：

sudo npm install -g @nestjs/cli

創建一個新的Nest.js項目

創建一個新的Nest.js項目：

nest new my-project
cd my-project

安裝Swagger UI依賴

在項目目錄中，安裝swagger-ui-express：

npm install @nestjs/swagger swagger-ui-express

配置Swagger

打開src/main.ts文件，并進行以下配置：

import { NestFactory } from '@nestjs/core';
import { ExpressAdapter } from '@nestjs/platform-express';
import { AppModule } from './app.module';
import * as express from 'express';
import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';

async function bootstrap() {
  const app = await NestFactory.create(AppModule, new ExpressAdapter());
  app.use(express.json()); // for parsing application/json
  app.use(express.urlencoded({ extended: true })); // for parsing application/x-www-form-urlencoded

  // 配置 Swagger
  const options = new DocumentBuilder()
    .setTitle('My Project')
    .setDescription('The My Project API description')
    .setVersion('1.0')
    .addTag('test')
    .build();

  const document = SwaggerModule.createDocument(app, options);
  SwaggerModule.setup('api-doc', app, document);

  await app.listen(3000);
}

bootstrap();

運行項目

在項目目錄中，運行以下命令啟動項目：

npm run start:dev

訪問Swagger UI

項目啟動后，你可以通過訪問以下URL來查看Swagger UI：

http://localhost:3000/api-doc/#/

注意事項

1. 安全性：確保你的Swagger UI端點是安全的，避免未授權的訪問?？梢詤⒖贾械氖纠?，使用Nest.js的安全機制來保護Swagger UI。
2. 依賴管理：確保所有依賴項都是最新的，以避免安全漏洞。

通過以上步驟，你應該能夠在Debian上成功運行并使用Swagger UI來與你的后端API進行交互和測試。