温馨提示×

Swagger如何在Linux下部署

小樊
39
2025-05-01 07:43:35
栏目: 智能运维

在Linux环境下部署Swagger主要有两种方式:通过Docker容器部署和手动安装。以下是详细的步骤:

通过Docker容器部署

  1. 安装Docker
  • 如果你还没有安装Docker,请先安装它。可以参考Docker官方文档进行安装。
  1. 拉取Swagger镜像
  • 使用以下命令拉取Swagger Editor和Swagger UI的Docker镜像。
    docker pull swaggerapi/swagger-editor:v4.6.0 docker pull swaggerapi/swagger-ui:v4.15.5 
  1. 运行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,请先安装它们。
    sudo apt update sudo apt install -y openjdk-11-jre-headless sudo apt install -y maven 
  1. 下载并解压Swagger Editor和Swagger UI
  • 可以从Swagger的GitHub仓库下载最新版本的Swagger Editor和Swagger UI。
    wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.50.0.tar.gz wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.50.0.tar.gz tar -xvf swagger-editor-3.50.0.tar.gz tar -xvf swagger-ui-3.50.0.tar.gz 
  1. 配置环境变量
  • 将Swagger Editor和Swagger UI的bin目录添加到PATH环境变量中。
    export PATH=$PATH:/path/to/swagger-editor/bin:/path/to/swagger-ui/bin 
  1. 启动Swagger Editor和Swagger UI
  • 使用以下命令启动Swagger Editor和Swagger UI。
    swagger-editor http-server -p 8080 
  • 这样,你就可以通过访问 http://your-server-ip:8080 来使用Swagger Editor,通过访问 http://your-server-ip:8080 来使用Swagger UI。

请注意,以上步骤可能会因Linux发行版和具体需求有所不同。建议根据实际情况进行调整。

0