
本文介绍如何在Linux服务器上部署Swagger,重点讲解使用Docker容器化部署,这是一种便捷且灵活的方案,支持远程访问。
Docker容器化部署Swagger Editor和Swagger UI
-
安装Docker: 首先,确保你的Linux服务器已安装Docker。 参考Docker官方文档Docker安装指南进行安装。
-
部署Swagger Editor:
- 拉取镜像:
docker pull swaggerapi/swagger-editor:v4.6.0 - 运行容器,将容器的8080端口映射到宿主机的8088端口:
docker run -d -p 8088:8080 swaggerapi/swagger-editor:v4.6.0 - 通过浏览器访问
http://你的服务器IP:8088访问Swagger Editor。
- 拉取镜像:
-
部署Swagger UI:
- 拉取镜像:
docker pull swaggerapi/swagger-ui:v4.15.5 - 运行容器,将容器的8080端口映射到宿主机的8080端口:
docker run -d -p 8080:8080 swaggerapi/swagger-ui:v4.15.5 - 通过浏览器访问
http://你的服务器IP:8080访问Swagger UI。
- 拉取镜像:
使用Cpolar实现远程访问
为了远程访问部署好的Swagger,可以使用Cpolar工具将本地端口映射到公网。
-
安装Cpolar: 访问Cpolar官网获取安装命令并安装Cpolar。
-
创建Cpolar隧道: 在Cpolar中,创建隧道将Swagger Editor和Swagger UI的端口映射到公网。 你将获得一个公网地址,用于远程访问。
通吃客零食网整站 for Shopex下载第一步】:将安装包中所有的文件夹和文件用ftp工具以二进制方式上传至服务器空间;(如果您不知如何设置ftp工具的二进制方式,可以查看:(http://www.shopex.cn/support/qa/setup.help.717.html)【第二步】:在浏览器中输入 http://您的商店域名/install 进行安装界面进行安装即可。【第二步】:登录后台,工具箱里恢复数据管理后台是url/sho
-
固定公网地址 (可选): 为了获得稳定的公网地址,建议在Cpolar中配置二级子域名,避免地址随机变化。 参考Cpolar固定公网地址教程。
使用Apache或Nginx作为Web服务器 (传统方法)
如果你更倾向于使用传统Web服务器,Apache或Nginx也是不错的选择。
-
配置Apache:
- 安装Apache并启用默认站点:
sudo a2ensite default.conf && sudo systemctl restart apache2 - 修改
/etc/apache2/sites-available/default文件,将DocumentRoot指向Swagger UI和Swagger Editor的文件位置。
- 安装Apache并启用默认站点:
-
配置Nginx:
- 安装Nginx并创建配置文件 (例如,备份默认配置文件并创建一个新的):
sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backup && sudo nano /etc/nginx/sites-available/my-swagger - 在配置文件中,修改
server块的root和index指令,指向Swagger UI和Swagger Editor。 - 重启Nginx:
sudo systemctl restart nginx
- 安装Nginx并创建配置文件 (例如,备份默认配置文件并创建一个新的):
选择以上任一方法,即可在Linux服务器上成功部署Swagger并实现本地或远程访问。 根据实际需求选择最合适的方式。









