服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 迁移清单要覆盖实际数据库目录、WAL、表空间、容器卷、运行时和证书续期配置。
- 停应用并不等于数据库已关闭;普通文件冷复制要在数据库正常停止后进行。
- 原生账号按用途映射,容器卷按对应镜像要求保留数字 UID/GID,避免全目录改属主。
- 新机产生写入后,回滚需要保护新增数据,不能直接用旧快照覆盖。
先清点服务和真正的数据位置
Ubuntu 同机运行网站、代理核心、数据库和容器时,完整迁移包含程序、配置、持久数据、运行用户与启动方式。先为每个服务列出 unit、工作目录、监听入口、数据库版本、数据目录、卷以及调度器;不要用一份整机目录复制代替这张对应表。
容器镜像声明的默认目录,不一定就是正在使用的数据目录。分别核对数据库运行时报告的位置,以及容器的 bind mount、命名卷和匿名卷;看到一个似乎未使用的卷,也先保留,不能凭名称或镜像默认值删除。
只读清点容器镜像与挂载
bashCONTAINER='REPLACE_WITH_CONFIRMED_CONTAINER'
docker inspect --format '{{.Image}}' "$CONTAINER"
docker inspect --format '{{range .Mounts}}{{println .Type .Source .Destination}}{{end}}' "$CONTAINER"
先停止写入,再取得一致的冷副本
安排维护窗口后,先停止应用写入者、后台 worker 和可能写入数据的定时任务,再正常停止数据库及相关容器。只关闭网站、禁止新连接或看到应用 unit inactive,均不足以证明数据库文件已经处于可冷复制状态。
物理冷备要保存整个 PostgreSQL 集群及相关 WAL、外置表空间,不是抽取单个表文件。恢复时保留原 PostgreSQL 大版本及必需扩展和运行环境;跨大版本迁移应走受支持的升级或逻辑备份流程。Redis 则按实际持久化配置保存完整相关目录,不只复制一个看起来最新的文件。
在每套 PostgreSQL 实例中只读确认位置
textSHOW server_version;
SHOW data_directory;
SHOW config_file;
恢复账号与容器卷时,分开处理身份
新机上相同的 UID/GID 数字可能属于其他账号。原生服务按账号用途建立映射,只调整明确归属该服务的数据;不要覆盖新机的账户数据库,也不要对混合业务根目录递归执行一次 chown。
容器数据需要匹配固定镜像内的数字身份。保存实际 image ID 与原标签映射、全部卷的来源和目标,再为新机建立持久的 Compose 卷引用。恢复阶段避免浮动标签自动拉取新版本,否则镜像、数据格式和启动行为可能同时变化。
先恢复到暂存区,再按依赖顺序启动
将冻结副本放在受保护的暂存目录,核对传输返回码、容量和文件清单后,再按服务逐项恢复。数据库和缓存先恢复并确认可连接,随后启动应用、worker 和入口代理;已经启动并接受新写入的目录,不能再被后续批量复制覆盖。
下面的 rsync 命令只有预览功能,不会写文件;目标必须是明确的新暂存目录。元数据一致不等于已完成逐文件内容哈希或数据库业务对账,重要数据仍应按相应备份方案验证完整性。
只预览冷副本与暂存目录差异
bashSNAPSHOT='/REPLACE_WITH_FROZEN_SNAPSHOT'
STAGING='/REPLACE_WITH_EMPTY_RESTORE_STAGING'
rsync -aHAXn --numeric-ids --itemize-changes -- "$SNAPSHOT/" "$STAGING/"
切换 DNS 前后,逐项验证真实行为
切换入口前核对域名的 A/AAAA、Host/SNI、证书链及回调地址;切换后从外部验证实际连接到了新机,再用原账号检查关键数据和必要业务。代理服务要用真实授权客户端请求核对出口,监听端口存在或 HTTPS 首页返回 200 都不能替代这些检查。
分别恢复服务的运行状态与持久启用状态。timer 显示 waiting、cron 为 active 或脚本路径存在,只能证明配置就位;要查看任务实际执行结果和续证结果。整机重启后的恢复能力也须单独验证,不能由 enabled 或容器重启策略直接推定。
只读核对服务、容器与定时器状态
bashUNIT='REPLACE_WITH_APPLICATION_UNIT.service'
systemctl show "$UNIT" -p ActiveState -p SubState -p Result -p UnitFileState --no-pager
docker ps -a --format 'table {{.Names}}\t{{.Status}}'
systemctl list-timers --all --no-pager
新机开始写入后,回滚先保护增量
新机尚未接受写入时,可以在停止相关服务后按已验证的恢复方案回退。新机已经接收订单、配置或其他数据后,先停止新写入、保存增量并制定反向同步或恢复方案;直接重新启用旧数据库会造成分叉或丢失新增数据。
保留旧机、冷副本及新机恢复前备份,直到数据和业务验收完成。迁移使用过临时 SSH 授权时,只撤销该次明确添加的公钥;不要整体替换 authorized_keys。迁移清单、备份和密钥资料均放在受保护的位置,公开文档仅使用占位符。
资料来源
常见问题
Docker 显示 healthy,是否代表迁移完整?
不代表。还需检查实际数据库、原账号和关键数据、代理出口、任务结果与入口切换。
原机和新机用户名一样,可以直接保留原生文件数字属主吗?
先核对 UID/GID 与账号用途。数字相同可能对应不同账号;容器数据与原生服务必须分别处理。
rsync 退出码为 0,能证明所有数据内容一致吗?
不能单凭退出码下结论。明确校验选项及范围,并完成备份完整性和应用数据核对。