Ubuntu Swagger如何进行部署

在Ubuntu上部署Swagger可以通过以下几种方法实现：

方法一：使用Swagger UI和Node.js

1. 安装Node.js和npm：

• 访问nodejs官网，下载适合Ubuntu的安装包（例如node-v16.15.1-linux-x64.tar.xz）。
• 解压安装包并将bin目录添加到系统的PATH环境变量中。

tar -xvf node-v16.15.1-linux-x64.tar.xz
export PATH=$PATH:/path/to/node-v16.15.1-linux-x64/bin

2. 安装Express和其他必要的模块：

npm install -g express body-parser cookie-parser multer

3. 创建并配置Express应用：

• 创建一个项目目录并初始化package.json。
• 编辑index.js文件，设置Express应用以提供Swagger UI文件。

var express = require('express');
var app = express();
app.use('/swagger', express.static('public'));
app.listen(3000, function () {
  console.log("Swagger UI started at http://localhost:3000/swagger");
});

4. 下载并部署Swagger UI：

• 从GitHub克隆Swagger UI仓库。
• 将dist目录中的文件复制到Express应用的public目录中。

5. 启动Express应用：

node index.js

6. 访问Swagger UI：

• 在浏览器中访问http://localhost:3000/swagger。

方法二：使用Swagger Editor

1. 安装Node.js和npm（与方法一相同）。

2. 安装http-server：

npm install -g http-server

3. 下载并部署Swagger Editor：

• 从GitHub克隆Swagger Editor仓库。
• 在Swagger Editor目录下运行http-server。

cd swagger-editor
http-server -p 8080

4. 访问Swagger Editor：

• 在浏览器中访问http://localhost:8080。

方法三：使用Nginx

1. 安装Nginx：

sudo apt-get install nginx

2. 下载Swagger Editor和Swagger UI：

• 从GitHub和GitHub分别下载Swagger Editor和Swagger UI的源码。

3. 配置Nginx：

• 将Swagger Editor的index.html文件和Swagger UI的dist目录复制到Nginx的默认HTML目录（/usr/share/nginx/html）。
• 编辑Nginx配置文件（通常位于/etc/nginx/sites-available/default），确保正确配置了静态文件路径。

server {
    listen 80;
    server_name localhost;

    location /swagger-editor {
        root /usr/share/nginx/html;
    }

    location /swagger-ui {
        root /usr/share/nginx/html;
    }
}

4. 重启Nginx：

sudo systemctl restart nginx

5. 访问Swagger Editor和Swagger UI：

• 在浏览器中分别访问http://localhost/swagger-editor和http://localhost/swagger-ui。