在Debian上部署Swagger可以通过多种方式实现,以下是使用Docker和Nginx两种常见方法的步骤:
使用Docker部署Swagger UI
- 安装Docker:
如果你还没有安装Docker,请先安装它。可以使用以下命令:
sudo apt update sudo apt install docker.io
- 拉取Swagger UI镜像:
使用Docker Hub上的Swagger UI镜像:
docker pull swaggerapi/swagger-ui
- 运行Swagger UI容器:
运行一个容器并映射端口(例如8080):
docker run -p 8080:8080 -d swaggerapi/swagger-ui
- 访问Swagger UI:
打开浏览器并访问 http://your-debian-ip:8080
,你应该能看到Swagger UI界面。
使用Nginx和Swagger UI静态文件部署
- 安装Nginx:
如果你还没有安装Nginx,请先安装它:
sudo apt update sudo apt install nginx
- 下载Swagger UI静态文件:
你可以从Swagger UI的GitHub仓库下载静态文件,或者使用以下命令直接下载:
wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-bundle.js wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-standalone-preset.js wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui.css wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-extensions.css
- 创建一个目录来存放Swagger UI文件:
sudo mkdir -p /var/www/swagger-ui sudo cp swagger-ui-bundle.js swagger-ui-standalone-preset.js swagger-ui.css swagger-ui-extensions.css /var/www/swagger-ui/
- 配置Nginx:
编辑Nginx配置文件 /etc/nginx/sites-available/default
,添加以下内容:
server { listen 80; server_name your-debian-ip; location /swagger-ui/ { root /var/www/swagger-ui; try_files $uri $uri/ /swagger-ui/index.html; } }
- 重启Nginx:
sudo systemctl restart nginx
- 访问Swagger UI:
打开浏览器并访问 http://your-debian-ip/swagger-ui/
,你应该能看到Swagger UI界面。