swagger在ubuntu上如何恢复

按你的安装方式选择对应恢复方案

一 使用 Docker 运行的恢复步骤

• 确认 Docker 已安装并运行：sudo systemctl start docker && sudo systemctl enable docker
• 拉取镜像：docker pull swaggerapi/swagger-ui
• 运行容器（示例映射 8080 端口）：docker run -d --name swagger-ui -p 8080:8080 swaggerapi/swagger-ui
• 验证：浏览器访问 http://localhost:8080
• 说明：若此前使用自定义配置或持久化卷，可在 run 命令中增加 -v 宿主机路径:/usr/share/nginx/html 挂载你的 index.html/swagger.json 等文件，实现配置与文档的快速恢复。

二 使用 npm 全局安装或源码运行的恢复步骤

• 安装 Node.js 与 npm：sudo apt update && sudo apt install -y nodejs npm
• 全局安装并启动 Swagger UI：sudo npm install -g swagger-ui && swagger-ui
• 或源码方式：
  • git clone https://github.com/swagger-api/swagger-ui.git
  • cd swagger-ui && npm install && npm start
• 验证：访问 http://localhost:8080
• 说明：若之前有自定义静态文件（如 dist/index.html 或项目中的 swagger.json），将其放回相应目录后重启服务即可生效。

三 使用系统服务或 Nginx 托管的恢复步骤

• 若通过 systemd 托管（示例服务名为 swagger-ui）：
  • 恢复配置后重启：sudo systemctl restart swagger-ui
  • 查看状态与日志：sudo systemctl status swagger-ui、sudo journalctl -u swagger-ui -xe
• 若通过 Nginx 反向代理：
  • 检查站点配置与静态文件路径是否正确，确保运行用户（如 www-data）对文档目录有读取权限
  • 重载 Nginx：sudo systemctl reload nginx
• 验证：访问配置的域名或端口，确认页面与接口文档加载正常。

四 从备份归档恢复配置与文档

• 常见配置与文档路径（按你的实际安装为准）：
  • Swagger UI 配置：/etc/swagger-ui/ 或 /opt/swagger-ui/
  • Swagger Editor 配置：~/.swagger-editor/
  • 项目或 Nginx 静态文件目录：如 /var/www/html/swagger/（示例）
• 恢复命令示例：
  • 备份：tar -czvf swagger-ui-backup.tar.gz /etc/swagger-ui/
  • 恢复：tar -xzvf swagger-ui-backup.tar.gz -C /etc/
  • 如有权限问题，先确保目标目录属主与权限正确，再重启服务（如 systemd 或 Nginx）。

五 恢复后常见问题快速排查

• 访问被拒绝（如 403 Forbidden）：检查 Nginx/服务运行用户对目录的读取权限与配置是否正确。
• 页面空白或依赖异常：确认前端静态资源完整、路径引用正确，必要时重新安装依赖或重启服务。
• 本机可访问但局域网不可达：检查服务器防火墙与云安全组，放行对应端口（如 8080）。
• 查看日志定位：使用 journalctl -u 服务名 或查看 /var/log/ 下的相关日志文件。