在Linux环境中部署Swagger主要有两种方式:通过Docker容器部署和手动安装。以下是详细的步骤:
通过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://
来使用Swagger Editor,通过访问:38080 http://
来使用Swagger UI。:38081
手动安装
-
安装Node.js和npm: 如果还没有安装Node.js和npm,请先安装它们。
sudo apt update sudo apt install -y openjdk-11-jre-headless sudo apt install -y maven
-
下载并解压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
-
配置环境变量: 将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 UI。
swagger-editor http-server -p 8080
这样,你就可以通过访问
http://
来使用Swagger Editor,通过访问:8080 http://
来使用Swagger UI。:8080
请注意,以上步骤可能会因Linux发行版和具体需求有所不同。建议根据实际情况进行调整。