BWH 重裝前 Docker 遷移清單

適用場景

在 BandwagonHost（搬瓦工 BWH）VPS 上使用 Docker 部署了服務（例如 Nginx Proxy Manager、Vaultwarden、Uptime Kuma、Sub-Store 等）後，如果準備通過 KiwiVM 重裝系統，建議在重裝前按本文步驟完成備份。

本文目標： 避免重裝後 Docker 配置、數據目錄或 Volume 丟失，導致服務無法快速恢復。

重裝前：先確認有哪些容器在運行 docker ps -a

建議把輸出截圖/複製保存，方便重裝後對照恢復。

第一步：找到 docker-compose.yml（最關鍵）

重裝後要恢復服務，本質上就是：

找回 compose 文件 → 啟動容器 → 數據還原（如有）

如果你忘了 compose 放哪了，可以全盤搜索：

find / -name "docker-compose.yml" 2>/dev/null find / -name "compose.yml" 2>/dev/null 第二步：備份項目目錄（推薦統一放 /opt）

第二步：備份項目目錄（推薦統一放 /opt）

如果你的 Docker 項目都放在 /opt 或 /opt/apps（常見習慣），可以直接打包備份：

tar -czvf docker-apps-backup.tar.gz /opt

備份包生成後，建議下載到本地保存（或上傳到網盤）。

第三步：確認是否使用了 Docker Volume（很多數據都在這裏）

列出 Volume：

docker volume ls

查看某個 Volume 是否真的有用（可選）：

docker volume inspect VOLUME_NAME 第四步：備份 Docker Volume（通用方法）

第四步：備份 Docker Volume（通用方法）

如果你的服務數據使用的是 Docker Volume（而不是掛載在項目目錄），需要額外備份 Volume 數據。

備份命令（通用模板）：

docker run --rm \

 -v VOLUME_NAME:/data \
 -v $(pwd):/backup \
 alpine sh -c "cd /data && tar -czf /backup/VOLUME_NAME.tar.gz ."

說明：

VOLUME_NAME.tar.gz 會出現在你當前目錄（pwd）下

可以對關鍵服務的 volume 逐個備份

重裝後恢復（簡要流程）

1）安裝 Docker + Compose確保 Compose 命令可用：

docker compose version

2）上傳並解壓項目目錄備份 tar -xzvf docker-apps-backup.tar.gz -C /

3）進入項目目錄啟動服務

以某個項目為例：

cd /opt/你的項目目錄 docker compose up -d

查看是否啟動成功：

docker ps

4）如果你備份了 Volume：恢復 Volume 數據（可選）

先創建 Volume（如果不存在）：

docker volume create VOLUME_NAME

再恢復數據：

docker run --rm \

 -v VOLUME_NAME:/data \
 -v $(pwd):/backup \
 alpine sh -c "cd /data && tar -xzvf /backup/VOLUME_NAME.tar.gz"

常見問題：重裝後啟動失敗怎麼辦？

1）端口衝突（最常見） ss -lntp

2）Docker 服務未啟動 systemctl status docker --no-pager

總結

重裝前只要記住兩件事：

備份 compose 文件 + 項目目錄（/opt）

備份關鍵 Docker Volume（如果有）

重裝後基本就是：

解壓 → docker compose up -d → 完成恢復。