在Ubuntu上配置Swagger的步骤如下:
首先,需要安装Node.js和npm。可以通过以下命令进行安装:
sudo apt update
sudo apt install nodejs npm
验证安装:
node -v
npm -v
接下来,安装Express框架以及相关的依赖模块:
sudo npm install express body-parser cookie-parser multer --save
创建一个index.js
文件并进行如下配置:
var express = require('express');
var app = express();
app.use('/swagger', express.static('public'));
app.get('/', function (req, res) { res.send('Hello World'); });
app.listen(3000, function () {
var host = server.address().address;
var port = server.address().port;
console.log("Example app listening at http://%s:%s", host, port);
});
从Swagger的GitHub仓库克隆Swagger UI项目:
git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui
npm install
构建项目:
npm run build
将构建好的文件复制到Web服务器的目录中,例如/var/www/html
:
sudo cp -r target/swagger-ui-dist/* /var/www/html/
如果使用Apache,创建并启用虚拟主机配置文件:
sudo cp /path/to/swagger.conf /etc/apache2/sites-available/
sudo a2ensite swagger.conf
sudo systemctl reload apache2
如果使用Nginx,创建并启用服务器块配置文件:
sudo cp /path/to/swagger /etc/nginx/sites-available/
sudo ln -s /etc/nginx/sites-available/swagger /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
使用http-server
在本地启动Swagger Editor:
npm install -g http-server
http-server -p 8080
访问http://localhost:8080/#/
即可看到Swagger Editor。
通过以上步骤,你就可以在Ubuntu上成功配置并运行Swagger了。