在Linux系统中部署Swagger UI可以通过多种方式实现,以下是几种常见的方法:
安装Docker: 如果你还没有安装Docker,请先安装它。可以参考Docker官方文档进行安装。
拉取Swagger UI镜像:
docker pull swaggerapi/swagger-ui:v4.15.5
运行Swagger UI容器:
docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
这将启动Swagger UI容器,默认情况下可以通过访问http://localhost:38081
来查看Swagger UI界面。
安装Node.js和npm: 如果你还没有安装Node.js和npm,可以参考Node.js官方文档进行安装。
下载并解压Swagger UI:
git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui
npm install
安装http-server:
npm install -g http-server
启动http-server:
http-server -p 8080
这将在端口8080上启动http-server,你可以通过访问http://localhost:8080
来查看Swagger UI界面。
安装Apache或Nginx: 如果你使用的是Ubuntu系统,可以参考以下命令安装:
sudo apt update
sudo apt install -y apache2
# 或者
sudo apt install -y nginx
下载并解压Swagger UI:
wget https://repo1.maven.org/maven2/io/springfox/springfox-swagger-ui/2.9.2/springfox-swagger-ui-2.9.2.html
unzip springfox-swagger-ui-2.9.2.html
sudo mv springfox-swagger-ui-2.9.2 /var/www/html/swagger-ui
配置Web服务器:
sudo a2ensite default.conf
sudo systemctl restart apache2
sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backup
sudo nano /etc/nginx/sites-available/default
修改server
块中的root
和index
指令:server {
listen 80 default_server;
listen [::]:80 default_server;
root /var/www/html;
index index.html index.htm;
server_name _;
location / {
try_files $uri $uri/ =404;
}
}
保存并退出编辑器,然后重启Nginx:sudo systemctl restart nginx
访问Swagger UI:
现在,你应该能够通过浏览器访问http://your_server_ip/swagger-ui
来查看和使用Swagger UI。