在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,请先安装它们。
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://<your-server-ip>:8080
来使用Swagger Editor,通过访问http://<your-server-ip>:8080
来使用Swagger UI。
请注意,以上步骤可能会因Linux发行版和具体需求有所不同。建议根据实际情况进行调整。