Swagger在Linux环境下如何部署与配置 - 问答

在Linux环境下部署和配置Swagger主要有以下几种方法：

通过Docker容器部署

安装Docker：

如果你还没有安装Docker，请先安装它。可以参考Docker官方文档进行安装。

拉取Swagger镜像：

使用以下命令拉取Swagger Editor和Swagger UI的Docker镜像：

docker pull swaggerapi/swagger-editor:v4.6.0
docker pull swaggerapi/swagger-ui:v4.15.5

运行Swagger容器：

使用以下命令运行Swagger Editor和Swagger UI容器：

docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0
docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5

这样，你就可以通过访问 http://your-server-ip:38080 来使用Swagger Editor，通过访问 http://your-server-ip:38081 来使用Swagger UI。

手动安装

安装Node.js和npm：

如果还没有安装Node.js和npm，请先安装它们。可以参考Node.js官方文档进行安装。

下载并解压Swagger Editor和Swagger UI：

从Swagger的GitHub仓库下载最新版本的Swagger Editor和Swagger UI。

使用以下命令下载并解压Swagger Editor：

wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.50.0.tar.gz
tar -xvf swagger-editor-3.50.0.tar.gz

使用以下命令下载并解压Swagger UI：

wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.50.0.tar.gz
tar -xvf swagger-ui-3.50.0.tar.gz

配置环境变量：

将Swagger Editor和Swagger UI的bin目录添加到PATH环境变量中。
```
export PATH=$PATH:/path/to/swagger-editor/bin:/path/to/swagger-ui/bin
```

启动Swagger Editor和Swagger UI：

使用以下命令启动Swagger Editor：
```
swagger-editor http-server -p 8080
```
使用以下命令启动Swagger UI：
```
http-server -p 8081
```
这样，你就可以通过访问 http://your-server-ip:8080 来使用Swagger Editor，通过访问 http://your-server-ip:8081 来使用Swagger UI。

通过Nginx反向代理（可选）

安装Nginx：

使用以下命令安装Nginx：
```
sudo apt update
sudo apt install nginx
```

配置Nginx：

创建一个新的Nginx配置文件：

sudo nano /etc/nginx/sites-available/swagger-ui

在文件中添加以下内容：

server {
    listen 80;
    server_name your_server_ip_or_domain;
    location / {
        root /var/www/swagger-ui;
        try_files $uri $uri/ /swagger-ui/index.html;
    }
}

启用配置并重启Nginx：

sudo ln -s /etc/nginx/sites-available/swagger-ui /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

访问Swagger UI：

打开浏览器并访问你的服务器IP地址或域名，你应该能够看到Swagger UI界面。

通过以上步骤，你可以在Linux服务器上成功部署和配置Swagger Editor和Swagger UI。根据你的需求选择适合的方法进行操作即可。

0 赞

0 踩