将Docker应用迁移到香港服务器,如何保留数据并设置回退条件?

发布人:A5数据发布时间:2026-10-16 15:35阅读量:120

将 Docker 应用迁移到香港服务器时,目标不应只是让容器在新主机上启动,而是让应用版本、配置、数据库、上传文件、定时任务和外部依赖都处于可核对状态。Docker 镜像只包含应用运行所需的镜像层,容器删除、主机更换或重新创建容器后,命名卷、绑定目录、数据库和对象存储中的数据不会自动随镜像迁移,必须单独盘点和复制。

稳妥的做法是保留原服务器作为回退基线,先完成一次全量备份和初始同步,再在香港服务器上以相同版本启动,经过数据校验和业务验证后切换流量。回退条件需要在切换前写清楚;尤其是新服务器已经产生写入后,不能仅通过恢复 DNS 就认为回退完成,否则可能出现订单、用户资料或文件上传的数据分叉。

现状核对:先确认哪些内容需要迁移

划定变更范围

先记录当前生产环境的完整组成,不要只看 docker ps 中的容器名称。至少需要确认以下对象:

对象需要核对的内容迁移时的主要风险
Docker 镜像镜像仓库、标签、摘要、CPU 架构标签被覆盖后,新旧镜像不一致
容器配置环境变量、启动参数、端口、健康检查缺少变量或端口映射导致容器虽启动但业务不可用
数据库类型、版本、字符集、扩展、账号权限、数据量版本差异、导出不完整或写入期间复制造成数据不一致
命名卷卷名称、挂载位置、实际用途卷没有随容器迁移,或者把缓存误当成业务数据
绑定目录上传文件、配置、证书、插件、脚本路径变化、文件权限和属主不一致
队列与定时任务消费者、计划任务、重试机制新旧环境同时运行导致重复消费或重复执行
外部依赖数据库、对象存储、支付、邮件、回调白名单香港服务器出口 IP 变化后被拒绝
域名与证书A/AAAA 记录、证书、反向代理配置DNS 缓存、IPv6 配置或证书域名不匹配

在原服务器上执行只读核对时,可以先使用以下命令。docker inspect 可能输出环境变量,其中可能包含密码或密钥,保存结果前应脱敏。

docker ps -a
docker volume ls
docker network ls
docker compose config --quiet
docker compose config --images
docker system df

对于单个容器,可以查看挂载和重启状态:

docker inspect app-web \
  --format '{{json .Mounts}}'

docker inspect app-web \
  --format '{{json .HostConfig.PortBindings}}'

docker inspect app-web \
  --format '{{json .State}}'

如果生产环境使用多个 Compose 项目,应分别进入对应目录执行命令,确认项目文件、.env 文件和实际运行容器属于同一套配置。不要因为新服务器也能执行 docker compose up -d,就认为配置已经完全一致。

区分镜像、容器和持久化数据

迁移时可以把数据分成三类处理:

  1. 必须保留的数据:数据库、用户上传文件、订单资料、业务附件、需要继续使用的证书和自定义配置。
  2. 可以重新生成的数据:应用缓存、临时文件、构建缓存、部分搜索索引和容器日志。
  3. 需要特别处理的数据:消息队列、登录会话、定时任务状态、增量处理游标。

命名卷本身只是主机上的数据目录抽象,不是备份。绑定目录也不等于已经安全保存。应在迁移清单中记录每个卷的用途、数据大小和最后修改时间,再决定采用数据库导出、文件同步或应用自身导出功能。

数据类型推荐保留方式验收方式
PostgreSQL、MySQL 等数据库逻辑备份或存储层一致性快照恢复后检查表数量、关键记录、最新业务时间
上传文件和附件复制绑定目录或对象存储,保留文件权限文件数量、总大小、抽样下载、校验和
缓存通常不迁移应用能否在新环境自动重建
登录会话根据业务决定迁移或统一失效登录、退出、权限验证
消息队列先停止生产者并处理积压,或按产品能力导出消息数量、消费位点、重复消费检查
日志仅在审计需要时归档能否检索关键时间段,不影响应用启动

如果数据在 Docker 命名卷中,不建议直接猜测 Docker 在宿主机上的内部路径并复制。可以使用应用提供的导出功能,或者在停止写入后,将命名卷挂载到临时容器中打包;复制前要确认目标目录、属主和权限。对数据库文件目录进行普通文件复制时,数据库必须停止,或者使用数据库和存储系统明确支持的一致性快照。

核对版本、架构和外部网络

香港服务器的地域变化通常会伴随出口 IP、网络延迟、DNS 路径和安全策略变化。迁移前应确认:

  • 新旧服务器的 CPU 架构一致,例如都是 amd64,或者镜像明确支持目标架构。
  • Docker Engine、Compose 插件、操作系统内核和文件系统满足应用要求。
  • 数据库大版本、字符集、时区和扩展可兼容。
  • 新服务器的出口 IP 已加入数据库、对象存储、支付回调和邮件服务的允许名单。
  • 应用依赖的域名在香港服务器上能正常解析,且 IPv4、IPv6 不会出现一部分流量走向错误地址。
  • 应用时区被明确设置。香港服务器可以使用 UTC,也可以使用业务要求的时区,但不要因为更换主机而隐式改变数据库和定时任务的时间语义。

如果需要跨服务器复制文件,可先估算传输窗口。以十进制 100 GB 数据、有效传输速率 200 Mbps 为例,理想传输时间为:

100 × 8 × 1000 ÷ 200 = 4000 秒,约 66.7 分钟

如果实际有效速率只有标称速率的 70%,估算时间约为 66.7 ÷ 0.7 = 95.3 分钟。这里的 GB 按十进制计算,速率按 Mbps 计算,不能把 MB/s 和 Mbps 混用。实际窗口还要加上校验、重试、数据库导出和最终停写同步的时间。

变更准备:先建立可回退的基线

形成备份和恢复证据

备份完成不等于具备回退能力。至少要确认备份文件存在、大小合理、可以读取,并在非生产目标库或临时环境中做一次恢复验证。

以 PostgreSQL 为例,可以使用自定义格式导出:

pg_dump \
  --format=custom \
  --no-owner \
  --file=/backup/appdb.dump \
  appdb

pg_restore \
  --no-owner \
  --dbname=appdb \
  /backup/appdb.dump

以 MySQL 为例,单事务方式适合主要使用事务表的场景,但仍需要根据数据库引擎、锁表情况和业务写入量确认影响:

mysqldump \
  --single-transaction \
  --routines \
  --events \
  --triggers \
  appdb > /backup/appdb.sql

mysql appdb < /backup/appdb.sql

上述恢复命令应只在已经准备好的目标数据库上执行,不能对生产源库直接执行覆盖操作。涉及存储过程、事件、触发器、用户权限或数据库扩展时,还要单独备份和核对,不要只检查业务表。

文件同步可以先执行模拟模式,确认源目录和目标目录没有写反:

rsync -nrc \
  --itemize-changes \
  -e "ssh -p 22" \
  /srv/acme/uploads/ \
  migrate@hk-server:/srv/acme/uploads/

确认输出符合预期后,再执行实际同步:

rsync -aHAX \
  --info=progress2 \
  -e "ssh -p 22" \
  /srv/acme/uploads/ \
  migrate@hk-server:/srv/acme/uploads/

这里没有加入 --delete。删除型同步会把目标端多出的文件删除,必须在确认目录对应关系、目标端已有快照并完成备份后才考虑使用。源目录、目标目录和 SSH 账号也应再次核对,避免把空目录同步到生产源端。

备份文件和关键归档可以生成校验值:

sha256sum /backup/appdb.dump
sha256sum /backup/uploads.tar

如果使用对象存储保存附件,还要单独确认桶、前缀、访问凭证和回调地址。只迁移数据库而不迁移对象存储中的文件,通常会表现为业务记录存在,但页面下载附件失败。

Docker应用迁移到香港服务器,除了延续原有容器环境,也需要匹配业务运行所需的计算、存储与网络资源。A5数据提供多种香港物理服务器方案,涵盖Xeon Gold和AMD EPYC平台,以及SSD、NVMe等存储配置,可承载网站、业务后台、数据库和容器应用;不同产品系列还提供CN2或国际带宽选择,为香港部署和跨境业务提供相应的服务器资源基础。

准备香港服务器的运行环境

新服务器上先完成基础环境,不要一上来就切换域名。可以核对:

uname -m
docker version
docker compose version
df -h
df -ih
timedatectl

磁盘空间不仅要容纳当前数据,还要预留数据库临时文件、镜像层、日志和备份空间。大量小文件场景应同时查看 inode 使用率;磁盘容量尚有余量但 inode 用尽,同样会导致容器写入失败。

建议将应用目录、上传目录、备份目录分开规划,例如:

/srv/acme/compose/
/srv/acme/uploads/
/srv/acme/backups/
/srv/acme/logs/

Compose 文件中尽量固定镜像摘要,而不是只使用可能被覆盖的 latest 或普通标签。迁移前记录源环境实际使用的镜像摘要;如果镜像仓库在新服务器上不可访问,应先完成镜像拉取或通过合规的镜像归档方式转移。

防火墙只开放确有需要的端口,管理端口限制为运维来源地址。应用容器可以先只绑定到本机回环地址,由反向代理统一提供 HTTPS,避免目标环境在验证阶段被公网直接访问。

预先安排切换方式

切换方式按业务规模和网络条件选择:

  • 有负载均衡或流量调度能力时,可以先让香港服务器接收少量验证流量,再逐步增加。
  • 只有 DNS 切换时,应提前降低 TTL,但不能假设所有递归解析器都会立即刷新。
  • 没有灰度条件时,应安排明确维护窗口,先让应用进入只读或维护模式,再做最终同步和切换。
  • 新旧两端都存在定时任务、队列消费者或回调接收器时,必须明确谁是唯一活动端,避免重复执行。

原服务器在切换前不要修改关键配置,也不要提前删除容器、卷和数据库。它应当作为回退基线保留,至少覆盖预定观察窗口。

分步实施:先同步,再启动,最后切流

第一步:完成初始数据同步

在业务仍可运行时,可以先复制不易变化的上传文件、静态资源和镜像,减少最终维护窗口。数据库可以先做一次备份恢复,最终切换前再执行一次增量或最终一致性同步。

对持续写入的目录,初始同步不能作为最终结果,因为同步过程中源端仍可能产生新文件。最终同步前需要:

  1. 开启维护模式或停止会产生写入的应用容器。
  2. 暂停队列生产者、定时任务和外部回调写入。
  3. 等待正在处理的请求和队列任务完成,或记录未完成任务。
  4. 对数据库执行最终备份或一致性切换。
  5. 对上传目录执行最终同步,并检查文件数量和总大小。

如果无法接受长时间停机,可以使用数据库原生复制、应用双写或存储快照等方案,但这些方案必须先确认版本、网络、权限和故障切换流程。没有经过验证的双写机制,不能作为简单的“零停机”保证。

第二步:在目标端按原版本启动

目标端首次启动时,优先使用和源端完全一致的应用版本与配置,不要把迁移和版本升级放在同一个变更窗口。若确实需要升级,应先完成同版本迁移并验证,再单独规划升级。

进入 Compose 文件目录后,先验证配置,再拉取和启动:

cd /srv/acme/compose

docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps

docker compose pull 只有在镜像仓库可访问且镜像版本已固定时才适合直接使用。使用普通标签时,拉取结果可能已经不是源环境的镜像。目标端启动前,应检查 .env、证书、配置文件和绑定目录权限。

不要执行以下类型的操作作为“清理旧数据”的常规步骤:

docker compose down -v

-v 可能删除 Compose 管理的命名卷,适用范围仅限于已经确认不含业务数据的测试环境。生产迁移中应通过明确的备份、恢复和目录切换完成数据处理,而不是依赖删除卷后重新启动。

启动后先看容器状态和健康检查:

docker compose ps

docker compose logs --tail=200 web

docker inspect app-web \
  --format '{{json .State.Health}}'

如果服务没有配置健康检查,应通过应用接口或低风险业务请求验证,不要只依据容器状态为 Up 判断成功。容器进程在运行并不代表数据库连接、文件写入、消息消费和外部回调都正常。

第三步:进行最终同步并切换流量

目标端完成初步验证后,进入维护窗口。先停止写入,再完成最终数据库和文件同步。目标库恢复完成后,检查关键记录的数量、最新更新时间和附件关联关系。

切流前可以用 curl --resolve 绕过公共 DNS,对指定域名直接访问目标 IP:

curl --resolve example.com:443:203.0.113.20 \
  --silent \
  --show-error \
  --fail \
  https://example.com/healthz

这种方式可以同时验证目标 IP、HTTPS 证书和域名路由。若接口需要登录,应准备专用测试账号,测试结束后撤销或修改凭证,避免把生产用户数据作为验证样本。

切换流量时,依次确认:

  • 目标端已经完成最终数据同步。
  • 旧端不再接收新的写入。
  • 目标端的数据库、上传目录、队列和定时任务已启动。
  • 反向代理、证书和安全组已生效。
  • A 记录、AAAA 记录或负载均衡后端指向目标端。
  • 旧端仍保留数据和可启动状态,但不再运行会产生重复写入的任务。

如果使用 DNS 切换,旧端可能在一段时间内仍收到缓存 DNS 的请求。因此切换后需要观察旧端访问日志,发现仍有写入请求时,不能直接让两端继续同时处理,应通过维护页、访问控制或应用层只读策略防止数据分叉。

验证与观察:按业务结果判断迁移是否成立

分层验证,不只检查容器

验证可以从低风险到高风险分为四层:

  1. 主机和容器层:CPU、内存、磁盘、inode、网络、容器重启次数、健康检查。
  2. 应用层:首页、登录、权限、核心 API、上传和下载、后台任务。
  3. 数据层:关键表记录、最近业务记录、文件数量、附件可访问性、队列积压。
  4. 外部依赖层:支付或邮件回调、数据库白名单、对象存储、第三方接口和监控告警。

可以使用以下命令做基础观察:

docker compose ps
docker stats --no-stream
docker compose logs --since=10m --tail=300
df -h
df -ih

业务验证应使用预先定义的低风险测试路径,例如创建一条可撤销的测试记录、上传一个测试文件、读取并下载该文件、验证权限后删除测试数据。不能只访问首页,因为首页正常并不能证明数据库写入和异步任务正常。

对于关键数据,建议比较迁移前后的:

  • 业务主表记录数;
  • 最近一条记录的时间和标识;
  • 用户或订单等关键对象的抽样结果;
  • 上传文件总数和总大小;
  • 队列积压数量及消费速度;
  • 数据库连接数、锁等待和错误日志。

比较时需要明确统计时间点。迁移期间仍在写入的表不能直接拿两个不同时间的总数比较,否则正常新增也可能被误判为丢失。

设定观察窗口

观察窗口应覆盖一次完整的业务高峰和至少一轮定时任务。作为常见变更安排,可以采用:

  • 切流后的前 15 至 30 分钟:重点观察 5xx、登录、核心接口、数据库连接和容器重启。
  • 接下来的 2 至 4 小时:观察高峰请求、文件上传、队列积压、定时任务和第三方回调。
  • 之后 24 至 72 小时:保留原服务器和目标端备份,但旧端不再对外处理写入,继续检查慢性问题和延迟到达的回调。

具体时间应根据业务流量调整。低流量业务不能因为半小时没有报错就立即删除旧环境;高写入业务也不能把旧端重新启动后直接接回流量。

回滚条件:按数据状态决定能否直接切回

在切换前预先定义触发条件

回滚阈值应在实施前确定,并以源环境基线作为参照。以下是可调整的示例,不是所有业务的固定标准:

观察项示例触发条件处理方向
核心接口错误连续 5 分钟 5xx 超过 1%,或关键接口持续失败暂停扩大发布并评估回退
延迟核心接口 P95 比源端基线高出 50% 以上,且持续 10 分钟检查资源、数据库和网络,无法快速恢复则回退
数据一致性关键记录缺失、重复、附件无法关联立即停止写入,禁止直接 DNS 回切
数据库连接耗尽、持续锁等待、迁移脚本破坏兼容性停止应用写入,按数据库方案回退
队列任务积压持续增长或出现重复消费、重复通知停止新端消费者,核对消费位点和任务状态
外部依赖支付、回调、邮件等关键链路持续失败先恢复依赖连通性;超过业务容忍时间则回退

单纯 CPU 偏高不一定代表必须回滚,应该结合错误率、延迟、磁盘、数据库等待和业务结果判断。反过来,即使资源使用率正常,只要出现数据丢失或重复扣款,也应立即停止继续观察。

根据是否产生新写入选择回退路径

情况一:尚未切换流量。 如果目标端仅完成启动和验证,没有接收生产写入,回退最简单。停止目标端对外访问,恢复原服务器服务,保留目标端日志和快照供分析。不要删除目标端数据,避免后续排查失去现场。

情况二:已经切换,但目标端没有产生不可逆写入。 可以先冻结目标端,确认旧端仍是完整基线,再恢复负载均衡后端或 DNS 指向旧端。DNS 回切仍然受缓存影响,旧端需要能够识别并处理短时间内到达的请求。回切后应继续观察旧端错误率和数据状态。

情况三:目标端已经产生订单、用户修改、文件上传或其他写入。 这时不能直接把 DNS 指回旧端。旧端数据库和目标端数据库已经发生分叉,简单回切会让目标端新增数据对用户不可见,甚至造成重复处理。

更安全的处理顺序是:

以目标端已产生订单、用户修改、文件上传或其他写入为起点,依次呈现停止目标端新写入并保留数据库和文件快照、导出切换后的新增或变更数据、判断能否按业务顺序回放或是否

  1. 立即停止目标端新写入,保留数据库和文件快照。
  2. 导出目标端在切换后的新增或变更数据。
  3. 判断这些数据能否按业务顺序回放到旧端,或是否需要恢复到切换前备份后重新处理。
  4. 核对数据库结构、主键、文件路径、队列位点和第三方回调状态。
  5. 只有确认数据已经合并或业务明确接受损失时,才恢复旧端流量。

如果新旧应用共用同一个外部数据库,回退还要额外确认数据库结构是否向后兼容。已经执行过不可逆的表结构变更或数据迁移脚本时,旧版本应用可能无法直接使用该数据库。此类场景应在迁移前采用向后兼容的扩展—迁移策略,并准备反向变更或数据库恢复方案。

最终,香港服务器迁移应以“数据状态可解释、业务结果可验证、旧环境仍可接管”为完成标准。切换后至少覆盖一个业务高峰和一轮定时任务;在观察窗口内,只要出现持续错误超阈值、关键数据不一致、队列重复处理、数据库异常或外部依赖无法恢复,就停止继续扩大流量并触发回退评估。只有观察窗口结束、数据核对完成且回退基线仍然可用后,才适合下线旧服务器或清理旧数据。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4049.html

相关推荐