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

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

通过Docker容器部署

1. 安装Docker：

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

2. 拉取Swagger镜像：

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

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

3. 运行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。

手动安装

1. 安装Node.js和npm：

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

2. 下载并解压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 

3. 配置环境变量：

• 将Swagger Editor和Swagger UI的bin目录添加到PATH环境变量中。

  export PATH=$PATH:/path/to/swagger-editor/bin:/path/to/swagger-ui/bin 

4. 启动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反向代理（可选）

1. 安装Nginx：

• 使用以下命令安装Nginx：

  sudo apt update sudo apt install nginx 

2. 配置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 

3. 访问Swagger UI：

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

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