如何在Ubuntu上自定义Swagger UI

在Ubuntu上自定义Swagger UI，您需要遵循以下步骤：

1. 安装Swagger UI： 首先，确保您已经安装了Node.js和npm。然后，通过运行以下命令来全局安装Swagger UI：

   npm install -g swagger-ui-express
   

2. 创建一个简单的Express应用： 在您的Ubuntu系统上创建一个新的文件夹，例如swagger-ui-customization，然后进入该文件夹。接下来，创建一个名为app.js的文件，并添加以下内容：

   const express = require('express');
   const swaggerUi = require('swagger-ui-express');
   const YAML = require('yamljs');
   
   const app = express();
   const port = process.env.PORT || 3000;
   
   // 读取Swagger JSON文件
   const swaggerDocument = YAML.load('./swagger.json');
   
   // 自定义Swagger UI选项
   const customUiOptions = {
     deepLinking: true,
     presets: [
       swaggerUi.presets.apis,
       swaggerUi.presets.promises,
     ],
     plugins: [
       swaggerUi.plugins.DownloadUrl,
     ],
     layout: "StandaloneLayout",
   };
   
   // 使用自定义选项启动Swagger UI
   app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, customUiOptions));
   
   app.listen(port, () => {
     console.log(`Server is running at http://localhost:${port}`);
   });
   

   在这个例子中，我们使用了一个名为swagger.json的Swagger JSON文件。您需要将其替换为您自己的Swagger JSON文件。

3. 安装依赖项： 在项目文件夹中运行以下命令来安装所需的依赖项：

   npm install express yamljs
   

4. 运行应用： 在项目文件夹中运行以下命令来启动应用：

   node app.js
   

   现在，您可以在浏览器中访问http://localhost:3000/api-docs来查看自定义的Swagger UI。

5. 自定义Swagger UI： 您可以通过修改customUiOptions对象来自定义Swagger UI。例如，您可以更改布局、添加插件或更改主题。有关可用选项的详细信息，请参阅swagger-ui-express文档。

6. 部署应用： 当您对自定义的Swagger UI满意时，可以将其部署到Ubuntu服务器上。您可以使用PM2、Docker或其他任何适合您需求的工具来部署应用。