在Linux中使用Swagger UI可以通过以下几种方法实现:
使用Docker容器部署
-
安装Docker: 如果你还没有安装Docker,请先安装它。在Ubuntu上,可以使用以下命令安装Docker:
sudo apt update sudo apt install -y docker.io sudo systemctl start docker sudo systemctl enable docker
-
拉取并运行Swagger UI容器:
docker pull swaggerapi/swagger-ui:v4.6.0 docker run -d -p 38080:8080 swaggerapi/swagger-ui:v4.6.0
这将启动Swagger UI容器,默认情况下可以通过访问
http://localhost:38080
来查看。
使用npm在Node.js项目中安装和部署
-
安装Node.js和npm: 如果你还没有安装Node.js和npm,可以使用以下命令安装:
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - sudo apt-get install -y nodejs
-
创建并启动一个简单的Express应用:
mkdir my-swagger-app cd my-swagger-app npm init -y npm install express
-
创建
index.js
文件:var express = require('express'); var app = express(); app.use('/swagger', express.static('node_modules/swagger-ui/dist')); app.listen(3000, function () { console.log('App is running on port 3000'); });
-
启动应用:
node index.js
-
访问Swagger UI: 打开浏览器,访问
http://localhost:3000/swagger
,你应该能看到Swagger UI的界面。
使用HTTP服务器部署
-
下载Swagger UI: 你可以从Swagger的GitHub仓库下载最新版本的Swagger UI:https://github.com/swagger-api/swagger-ui
-
解压文件:
unzip v2.4.27.zip
-
创建一个简单的HTTP服务器:
mkdir public cp -r swagger-ui/dist/* public/
-
创建
index.html
文件: 在public
目录下创建一个index.html
文件,内容如下: -
启动HTTP服务器:
node public/index.html
-
访问Swagger UI: 打开浏览器,访问
http://localhost:8080
,你应该能看到Swagger UI的界面。
通过以上步骤,你可以在Linux系统中成功部署和使用Swagger UI。选择适合你的方法进行操作即可。