debian如何备份swagger

在 Debian 系统上，“备份 Swagger”通常有以下几种理解，下面分别说明常见场景和操作方法。

一、备份 Swagger UI / Swagger 静态文件

如果你是在 Debian 上手动部署了 Swagger UI（比如通过 nginx 或静态目录）：

1. 找到 Swagger 目录

常见位置：

/var/www/swagger
/usr/share/nginx/html/swagger

2. 打包备份

tar -czvf swagger-backup-$(date +%F).tar.gz /var/www/swagger

3. 恢复到新机器

tar -xzvf swagger-backup-2026-01-21.tar.gz -C /

二、备份 Swagger API 文档（OpenAPI 描述文件）

如果你使用的是：

• swagger.json
• swagger.yaml
• openapi.yaml

备份文件

cp /path/to/swagger.json /backup/swagger.json.bak

或批量备份：

find /var/www -name "swagger*.json" -o -name "openapi*.yaml" | tar -czvf swagger-docs.tar.gz -T -

三、从运行中的服务导出 Swagger（常见）

Spring Boot / Java 服务

curl http://localhost:8080/v3/api-docs > swagger.json

或旧版本：

curl http://localhost:8080/v2/api-docs > swagger.json

Node.js (NestJS / Express)

curl http://localhost:3000/api-json > swagger.json

四、备份 Swagger Editor 数据（浏览器版）

如果你用 Swagger Editor（网页）：

• 直接导出 YAML / JSON
• 或备份本地存储（浏览器 → 开发者工具 → Application → Local Storage）

五、用脚本自动备份（推荐）

#!/bin/bash
BACKUP_DIR=/backup/swagger
mkdir -p $BACKUP_DIR
curl -s http://localhost:8080/v3/api-docs > $BACKUP_DIR/swagger-$(date +%F).json
tar -czvf $BACKUP_DIR/swagger-ui-$(date +%F).tar.gz /var/www/swagger

加入 cron：

crontab -e
0 2 * * * /root/backup-swagger.sh

六、如果你用的是 Docker

docker cp swagger-container:/usr/share/nginx/html /backup/swagger

如果你能补充说明：

• Swagger 是怎么部署的（nginx / docker / spring boot）
• 想备份的是 UI 还是 API 文档

我可以给你更精确的 Debian 备份方案。