Debian 13 教程 / 将服务迁移到Debian 13并验证切换与回滚

在将服务迁移到新的 Debian 服务器时,您应首先准备运行环境和账号,然后恢复在写入停止时所做的最终备份,最后比较功能和数据。迁移并不仅仅通过切换访问就完成,您必须决定如何保留在新服务器上生成的任何数据,以便能够安全地回滚到原服务器。

定义迁移范围并识别每台服务器

本练习在两个 Debian 13 虚拟机(VM)之间迁移一个由 Python 制作的小型只读 HTTP 服务。它提供程序、数据和 systemd 单元,并且只在 127.0.0.1:8085 上响应。如 Python http.server 文档 所述,这并不是用于面向互联网的生产服务器的示例。本练习不包括数据库模式迁移、实际的域名系统(DNS,Domain Name System)更改以及外部TLS(Transport Layer Security,传输层安全)配置迁移。

角色 练习连接 检查内容
源旧服务器 主机 127.0.0.1:22212 → 原始虚拟机 SSH 参考响应,最终备份,停止并重启
目标新服务器 主机 127.0.0.1:22213 → 目标虚拟机 SSH 专用账户 · 恢复 · 服务响应 · 重启
工作电脑 SSH/SCP 分别验证两个服务器的主机密钥 备份传输,哈希比较,选择连接目标

即使在使用网络地址转换(NAT,Network Address Translation)的两个虚拟机中出现相同的 10.0.2.15 地址,它们也不是相同的服务器。在此示例中,通过 VirtualBox 网络 → NAT → 高级 → 端口转发 连接了不同的主机回环端口。请替换为实际的服务器地址和端口,并分别验证每个服务器的身份和主机密钥。在练习过程中,目标虚拟机的启动被卡住,因此在正常 ACPI 关机后重新启动,并且只有在确认目标能够成功连接后才进行恢复。

在工作用 Linux 计算机上,您可以像以下方式在 ~/.ssh/config 上设置别名。将私钥路径替换为您自己的路径,并且不要将密码或私钥内容复制到文本或日志中。

Host old-server
    HostName 127.0.0.1
    Port 22212
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

Host new-server
    HostName 127.0.0.1
    Port 22213
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

每台服务器都需要 Python 3、curl 和 tar。如果未安装,请使用 sudo apt install python3 curl tar 准备它们,并在工作计算机上安装 SSH 和 SCP 客户端。下面的原始示例假设教程中已有的 lfstudent 账户,其用户ID(UID,User ID)和组ID(GID,Group ID)均为 1000。如果使用不同的账户,也需要更改用户和组及所有权说明。使用新的练习环境,不要覆盖同名的现有目录或服务。

创建完整的源服务并在停止时备份

在源服务器上执行。 此模块创建程序、数据和单元,比较响应,然后停止服务。最终创建tar归档时,本示例的只读服务已经停止。其他服务或现有升级实践文件不在目标范围内。

sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-migrate35 /var/lib/lf-migrate35 /var/backups/lf-migrate35 /etc/systemd/system/lf-migrate35.service; do test ! -e "$p"; done
test "$(id -u lfstudent)" = 1000
test -z "$(ss -H -ltn 'sport = :8085')"
install -d -m 755 /opt/lf-migrate35
install -d -m 750 -o lfstudent -g lfstudent /var/lib/lf-migrate35
install -d -m 700 /var/backups/lf-migrate35
cat > /opt/lf-migrate35/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != '/':
            self.send_error(404)
            return
        try:
            body = Path('/var/lib/lf-migrate35/message.txt').read_bytes()
            status = 200
        except OSError:
            body = b'data unavailable\n'
            status = 503
        self.send_response(status)
        self.send_header('Content-Type', 'text/plain; charset=utf-8')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)

HTTPServer(('127.0.0.1', 8085), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
printf 'migration payload 35\n' > /var/lib/lf-migrate35/message.txt
chown lfstudent:lfstudent /var/lib/lf-migrate35/message.txt
chmod 640 /var/lib/lf-migrate35/message.txt
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > /var/backups/lf-migrate35/before.txt
cmp /var/lib/lf-migrate35/message.txt /var/backups/lf-migrate35/before.txt
systemctl stop lf-migrate35.service
tar --numeric-owner -cpf /var/backups/lf-migrate35/service.tar -C / opt/lf-migrate35 var/lib/lf-migrate35 etc/systemd/system/lf-migrate35.service
cd /var/backups/lf-migrate35
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
echo SOURCE_STOPPED_FINAL_SAMPLE_BACKUP_READY
ROOT

如果简短的启动延迟不足且 curl 失败,请检查 sudo systemctl status lf-migrate35.service 和 sudo journalctl -u lf-migrate35.service -n 30。检查路径、所有权和端口冲突,然后在准备就绪后重试失败的请求和比较。不要在部分创建的资源上重新运行创建模块,也不要在停止源之前创建最终归档。确保本地 curl 请求绕过任何已配置的代理。

预期结果是 service.tar: OK 和备份准备消息。正常响应是单行 migration payload 35。如果没有数据或数据不可读,该服务返回 503,并且不会显示文件列表或读取其他路径。

对于实际的数据库或文件上传服务,您需要判断仅停止一个进程是否足够。停止批处理作业、队列消费者、其他服务器的写入,或使用产品的一致性转储或在线备份方法。如果在初始批量复制后重新同步最终更改,请记录两个时间点和写入停止的时间间隔。

通过工作站传输备份

以 lfstudent 身份在源服务器上运行导出块。 如果导出目录已存在或任何复制失败,则停止。在工作站上,如果 mkdir migration35、校验和验证或目标导入目录创建失败,也应停止;不要让后续的 scp 命令重复使用旧目录。

仅复制您刚创建的实训归档及其校验和这两个文件,不要暴露源服务器的仅限 root 的备份,将它们放到练习账号的专用目录中。对于实际的服务备份,根据是否包含机密信息,应用不同的加密和存储策略。

test ! -e "$HOME/lf-migrate35-export"
install -d -m 700 "$HOME/lf-migrate35-export"
sudo install -m 600 -o "$(id -un)" -g "$(id -gn)" /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256 "$HOME/lf-migrate35-export/"

在 Linux 工作站上运行。 确认 SSH 别名指向目标服务器,然后在新的专用本地目录中接收文件。

ssh old-server hostname
ssh new-server hostname
mkdir -m 700 migration35
scp old-server:lf-migrate35-export/service.tar old-server:lf-migrate35-export/service.sha256 migration35/
cd migration35
sha256sum -c service.sha256
tar -tvf service.tar
ssh new-server 'test ! -e "$HOME/lf-migrate35-import" && install -d -m 700 "$HOME/lf-migrate35-import"'
scp service.tar service.sha256 new-server:lf-migrate35-import/

哈希值必须匹配,列表中应只包含 opt/lf-migrate35、var/lib/lf-migrate35 以及相关的服务单元。仅向您创建的可信归档授予恢复权限,如果存在绝对路径、包含..的上级目录路径或意外链接,请停止。校验和用于验证传输过程中是否损坏,并不能替代源的信任。SCP 选项和传输方法可参见 OpenSSH scp 手册。

使用专用账户恢复到目标

在目标服务器上运行。 首先确认 /opt/lf-migrate35、/var/lib/lf-migrate35、/var/backups/lf-migrate35 和 /etc/systemd/system/lf-migrate35.service 不存在,并且 getent passwd lf-migrate35 未找到现有账户。如果 sudo ss -ltn 显示端口8085已被占用,请停止并进行调查。

所有之前的目标缺失检查都是强制性的:恢复块假设它们已经通过。同时确认 getent group lf-migrate35 没有找到现有的组。导入路径假设登录账户的主目录是 /home/lfstudent;如果您的不同,请始终替换。最终的 UID-not-1000 断言展示了本实验中不同的 ID;成功的生产映射由预期的目标身份定义,而不是普遍要求的数字差异。

归档先解包到暂存目录,再安装所需文件;在确认目标单元不存在之后,只创建本实训的单元,不会将原服务器的整个/etc或服务配置直接覆盖到目标。它没有复制原始的数字 UID,而是将数据所有权重置为目标的专用账户名。

sudo bash <<'ROOT'
set -euo pipefail
install -d -m 700 /var/backups/lf-migrate35
mv -- /home/lfstudent/lf-migrate35-import/service.tar /home/lfstudent/lf-migrate35-import/service.sha256 /var/backups/lf-migrate35/
rmdir /home/lfstudent/lf-migrate35-import
chown root:root /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
chmod 600 /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
cd /var/backups/lf-migrate35
sha256sum -c service.sha256
mkdir -m 700 staging
tar -xpf service.tar -C staging
useradd --system --user-group --home-dir /var/lib/lf-migrate35 --no-create-home --shell /usr/sbin/nologin lf-migrate35
install -d -m 755 /opt/lf-migrate35
install -m 644 staging/opt/lf-migrate35/app.py /opt/lf-migrate35/app.py
install -d -m 750 -o lf-migrate35 -g lf-migrate35 /var/lib/lf-migrate35
install -m 640 -o lf-migrate35 -g lf-migrate35 staging/var/lib/lf-migrate35/message.txt /var/lib/lf-migrate35/message.txt
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lf-migrate35
Group=lf-migrate35
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > after.txt
cmp after.txt staging/var/lib/lf-migrate35/message.txt
cmp /opt/lf-migrate35/app.py staging/opt/lf-migrate35/app.py
test "$(stat -c %U /var/lib/lf-migrate35/message.txt)" = lf-migrate35
test "$(id -u lf-migrate35)" != 1000
id lf-migrate35
stat -c '%U:%G:%a' /var/lib/lf-migrate35/message.txt
systemctl show lf-migrate35.service -p User -p Group -p NoNewPrivileges -p ProtectSystem -p MainPID
systemctl restart lf-migrate35.service
sleep .3
curl -fsS http://127.0.0.1:8085/ | cmp - after.txt
echo TARGET_RESTORED_BY_ACCOUNT_NAME_BYTES_AND_RESTART_PASSED
ROOT

验证虚拟机的原始数据所有者是 UID 1000,目标专用账户是 UID 和 GID 988。数据权限设置为 lf-migrate35:lf-migrate35:640,代码字节、HTTP 响应以及服务重启后的响应均相同。NoNewPrivileges 和只读系统保护是根据 systemd 运行时环境设置 的限制。将相同的单元直接应用于写入服务也可能阻止必要的数据写入,因此应为每条路径单独设计权限。

在实际应用中,还会比较运行时版本、扩展模块、数据库客户端、环境变量、证书和上传路径。不要因为操作系统版本相同就假设文件格式和行为一致;在目标上执行产品支持的验证工具和功能请求。

测试切换、回滚和再次切换

当前,原服务已停止,目标服务正在响应。在工作电脑上,使用选择连接目标的变量进行读取检查。这是用于选择 SSH 目的地的操作,不会更改 DNS、负载均衡器或公共网页地址。

active=new-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
  1. 在目标上执行 sudo systemctl stop lf-migrate35.service。
  2. 在源服务器上执行 sudo systemctl start lf-migrate35.service。
  3. 在工作计算机上,对源服务器进行如下读取操作,并检查响应是否相同。
active=old-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'

要再次切换到目标,首先停止源,然后启动目标服务,并使用 active=new-server 进行验证。我们将目标恢复/重启在两台虚拟机上的所有响应、源回滚和目标切换与参考文件进行了比较。这个小型服务是只读的,因此它不能反映切换后出现新的写入冲突的场景。

在实际生产切换之前需要做出的额外决策

项目 判断标准
DNS 和负载均衡器 考虑当前缓存、现有连接、健康检查和传播延迟。仅降低 DNS生存时间(TTL,Time to Live)并不会立即路由所有请求。
恢复写入和回滚 在最终同步之前,阻止对源的写入,并确定目标生成的数据是否可以重新应用到源。若模式不向后兼容,请避免简单回滚。
计划任务、电子邮件、队列 如果两台服务器同时运行,仅对可能重复的任务激活其中一台。与 Web 请求切换单独验证。
成功判断 分别比较进程、端口、响应、数据、主要功能和错误率。仅成功读取并不算作正常写入。

在移除源或备份之前,设置回滚窗口和保留期。请参阅 Debian GNU tar 手册,以了解数字所有权和提取行为,并遵循针对数据库或主要版本数据迁移的产品特定官方程序。

仅清理实训资源

验证后,仅清理您在每台服务器上创建的实训资源。停止并禁用服务,删除恰好三个文件,并仅移除空目录。保留备份,并保留源服务器现有的 lfstudent 账户。

sudo systemctl disable --now lf-migrate35.service
sudo rm -- /etc/systemd/system/lf-migrate35.service /opt/lf-migrate35/app.py /var/lib/lf-migrate35/message.txt
sudo rmdir /opt/lf-migrate35 /var/lib/lf-migrate35
sudo systemctl daemon-reload

在目标系统上,仅在该专用账户的进程全部结束、实训数据已清理后,使用sudo userdel lf-migrate35删除新创建的账户。将您的保留策略应用于源系统和工作站上的明确列出的归档与校验和两个传输文件。对于生产迁移,请在恢复窗口结束之前保留已验证的最终备份和切换记录。