在Linux中使用Swagger UI可以通過以下幾種方法實現:
安裝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來查看。
安裝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的界面。
下載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文件,內容如下:
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" type="text/css" href="swagger-ui.css">
</head>
<body>
<div id="swagger-ui"></div>
<script src="swagger-ui.js"></script>
<script>
window.onload = function() {
// Begin Swagger UI call region
const ui = SwaggerUIBundle({
url: "http://petstore.swagger.io/v2/swagger.json",
dom_id: '#swagger-ui',
deepLinking: true,
presets: [
SwaggerUIBundle.presets.apis,
SwaggerUIStandalonePreset
],
plugins: [
SwaggerUIBundle.plugins.DownloadUrl
],
layout: "StandaloneLayout"
});
// End Swagger UI call region
window.ui = ui;
}
</script>
</body>
</html>
啟動HTTP服務器:
node public/index.html
訪問Swagger UI:
打開瀏覽器,訪問http://localhost:8080,你應該能看到Swagger UI的界面。
通過以上步驟,你可以在Linux系統中成功部署和使用Swagger UI。選擇適合你的方法進行操作即可。