部署教程

Docker 应用备份与迁移：配置、数据目录和恢复顺序

发布于 2026-10-01更新于 2026-10-03

区分 Compose 配置与应用数据，备份 SQLite 应用、数据库和上传文件，并在新 VPS 恢复。

迁移容器之前，先找数据在哪里

Compose 文件说明容器怎样启动，数据通常在绑定目录或命名卷。先打开 compose.yaml 查看 volumes，再用 docker inspect 对照实际挂载；镜像可以重新下载，数据库和上传文件需要自己保存。

bash；使用前请核对本文前提。如内容超出，可左右滑动，键盘使用方向键或 Home/End 查看。

仅复制文本，不会执行。

sudo docker compose ps
sudo docker inspect 容器名 --format "{{json .Mounts}}"

Compose 项目不一定把数据放在当前目录。先用 docker compose config 查看 volumes，再用 docker volume inspect 查看实际卷；项目名前缀也会影响卷名。

数据库卷优先使用数据库工具导出。一般文件卷可在停止写入后挂到临时工具容器中打包，保存时保留目录、权限和所需配置；不要只复制 compose.yml。

以 /srv/memos/data 保存数据的单实例应用为例，先停止应用，再把数据和配置打包到项目目录以外。下面的目录必须换成自己的实际位置，确认 tar 包生成后再启动服务。

bash；使用前请核对本文前提。如内容超出，可左右滑动，键盘使用方向键或 Home/End 查看。

仅复制文本，不会执行。

cd /srv/memos
sudo docker compose stop
sudo tar -czf /srv/memos-backup-$(date +%F).tar.gz compose.yaml data
sudo docker compose start

打包结束后把备份复制到另一台机器或外部存储。打包数据库正在写入的文件可能得到不一致的副本；MySQL、PostgreSQL 使用它们各自的逻辑导出或一致性备份方式。

一组备份应同时包含数据库导出、上传目录、Compose、.env、密钥，以及软件和数据库版本。n8n 的凭据依赖原加密密钥，只有数据库可能仍无法使用。

应用正在上传文件时，数据库和目录分别复制可能产生不同时间点的副本。迁移前安排停写窗口：停止接收新任务、上传和 Webhook，等待正在执行的任务结束，再保存数据库与文件。保留数据库服务运行以执行逻辑导出，不能先停数据库再运行 pg_dump。

PostgreSQL 的 pg_dump 可以取得数据库一致快照，但它不能同时冻结应用文件目录。下面假定 Compose 服务名为 db，替换数据库账号与库名，并在停写后执行；dump 文件位于宿主机当前目录。备份目录应仅允许维护账号读取。

bash；使用前请核对本文前提。如内容超出，可左右滑动，键盘使用方向键或 Home/End 查看。

仅复制文本，不会执行。

umask 077
docker compose exec -T db pg_dump -U DB_USER -d DB_NAME -Fc > database.dump
test -s database.dump

命令成功并且文件非空仍需恢复验证。数据库版本、应用版本、Compose、.env、密钥和上传目录写入同一份备份记录。MySQL 或外部数据库使用对应官方一致性备份方法，不把 pg_dump 命令照搬过去。

新 VPS 安装 Docker 后，复制配置与数据并恢复正确权限。核对挂载路径、宿主机目录与命名卷，避免应用启动后在错误目录生成一份空数据库。先完成以下版本与恢复检查，再切换域名。

先用原应用版本恢复，再按软件支持的路径升级。PostgreSQL 等数据库大版本不能直接换镜像读取旧数据目录，应使用逻辑导出恢复或对应升级工具。

在隔离机器恢复匹配的数据库和文件后，先关闭预演副本的定时任务、通知和外部写入，确认不会重复发邮件或触发业务，再用原应用版本启动。用 --resolve 或受控临时域名检查 HTTPS，公网 DNS 先不切换。

检查登录、旧记录、附件下载、临时记录写入及后台任务。抽查文件校验和、数据库恢复退出状态和日志，再对照应用内数量与关键记录。首页可打开、容器 Up 或数据库能连接，都不能独立证明恢复完整。

正式切换后，再逐项启用所需通知、Webhook和定时任务，并检查外部服务白名单及回调地址。确认旧实例不再执行相同任务，避免新旧服务重复处理。

预演通过后，旧实例停写，完成最后一份数据库和文件备份，再恢复到目标实例并切换域名或代理。DNS 缓存可能让请求仍到旧机器，旧入口应继续停写或转发到新入口，避免两个数据库分别产生新记录。

切换前保留旧机器、旧解析、代理配置及迁移前备份。新实例尚未接收业务写入时，可以恢复旧入口；新实例已经有新记录时，应先停写并保存增量，再安排回迁，不能只把 DNS 改回去。

旧服务结束前，确认定时任务、回调和依赖都已迁走。清理容器不需要删除数据卷；docker compose down -v 会删除项目卷，不用于普通停止或镜像更新。

Restic 可将配置、上传文件和数据库导出文件保存到 SFTP 仓库。仓库密码与 SSH 登录密钥分别保管；先完成一次备份，再从指定快照恢复到独立目录。

数据库使用自身的导出工具生成备份后再交给文件备份程序，避免直接归档持续写入的数据目录。保留策略先预览待删除的快照，再执行清理；备份任务同时记录退出状态与运行日志。

需要按计划上传文件并保留历史版本，可以用 Duplicati；需要目录快照、去重仓库与策略管理，可以用 Kopia。两者都先准备一致的数据库导出，再备份文件产物。

切换服务器前记录任务周期、目标位置与加密口令。最终同步完成后停掉旧任务，再由新实例接管；检查下一次自动任务和远端结果，恢复一份文件。