在两台服务器之间同步一个大文件夹（可续传、后台运行）

最近更新: 2026-07-08

你在一台服务器上有一个很大的文件夹——几十 GB——想在另一台上得到一份完整副本。你没法盯着终端好几个小时，而且传到一半断掉的传输不应该从头再来。relayium sync 正是为此而生：一个单向增量镜像，跳过已经存在的文件，把传了一半的文件从中断处续传，并对每个文件做端到端校验。

本指南搭建一个无人值守、自动恢复的传输：把发送方授权一次，让监听端在后台运行，并在 tmux 里用重试循环驱动 relayium sync，让它在掉线之后继续跑，直到整个文件夹全部到达。

为什么 relayium sync 适合这件事

sync 是走原生协议的单向增量镜像（两端都要装 relayium）。有三个特性让它可以安心地无人值守地反复运行：

跳过已存在的文件：接收方上大小和修改时间都一致的文件不会重复发送。
续传半截文件：如果某个文件在连接断开时只传了一半，下次运行会从磁盘上已有的字节偏移继续，而不是重新传。
校验每个文件：每个文件都做端到端的 SHA-256 校验，因此完成的镜像可以确认是完整的。
正因如此，这条命令是幂等的——再跑一次只做剩下的活，这正是重试循环能完成一次超大传输的关键。

前提条件

两端服务器都要装 relayium（sync 走原生协议，因此每一端都必须有）：

# on BOTH servers
curl -fsSL https://relayium.com/install.sh | sh

本指南用守护进程直连（relayium://），所以两台服务器之间不需要 SSH 互访。
在接收方的防火墙或安全组上，向发送方开放监听端口（默认 9031）。

把发送方授权一次（在接收方）

接收方对发送的那台机器授权一次；授权会写入磁盘并在重启之间保持有效，因此你无需重复。先在终端里前台启动监听端，并把 --dir 指向父目录——relayium sync /root/workspace 会在接收方重建出 workspace/...，所以 --dir /root 会把文件落到 /root/workspace/。

当发送方首次连接时（见下一节），serve 会显示它的地址和指纹并请你批准；回答 y，它就会被永久记住：

# on the RECEIVER (foreground, to approve interactively)
relayium serve --dir /root --port 9031

# on the RECEIVER, at the first connection:
Incoming push from 203.0.113.9:52140
  fingerprint: 9f2c41ab…
Accept and remember this peer? [y/N] y

若要完全无人值守，可跳过提示：在发送方运行 relayium id 打印其指纹，再在接收方运行 relayium authorize <指纹>。
--dir 是你要同步的文件夹的父目录，而不是文件夹本身——否则文件会多落一层（例如 /root/workspace/workspace）。

让监听端在后台运行（在接收方）

指纹授权之后，停掉前台的 serve（Ctrl-C），再以脱离终端的方式重新启动，让它在你退出登录后依然存活。它会读回已保存的指纹并静默接受发送方——这次不再提示：

# on the RECEIVER
nohup relayium serve --dir /root --port 9031 > ~/relayium-serve.log 2>&1 &

serve 一次处理一个连接并持续运行，因此下面重试循环的每次重连它都准备好接收。
若要做常驻收件箱，改用 systemd 运行（Restart=always，--config-dir /etc/relayium）。

在 tmux 里用重试循环运行 sync（在发送方）

长时间的传输总会被打断——会话断开、网络抖动、机器重启。解决办法不是什么高级工具，而是一个把 sync 反复重跑到成功为止的循环，再加一个终端复用器让它在你退出登录后存活。这里 tmux 比 nohup 更省心：没有容易写错的输出重定向，而且可以重新接入查看进度。

开一个 tmux 会话，然后在 until 循环里运行镜像——它每 10 秒重试一次，直到 sync 成功返回，然后自己退出：

# on the SENDER
tmux new -s xfer      # apt install -y tmux if it's missing

until relayium sync /root/workspace relayium://203.0.113.43:9031; do echo "$(date) retrying"; sleep 10; done

按 Ctrl-b 再按 d 脱离；关掉终端后循环仍在跑。用 tmux attach -t xfer 重新接入。
每次重试做的活都更少：已传完的文件被跳过，传了一半的文件续传——所以循环会收敛并结束。
进度是每传完一个文件打印一行，因此一个大文件会安静地传到完成为止。没有输出不代表卡住（见排错）。

验证与收尾

当 until 循环结束、你回到普通的 shell 提示符时，传输就完成了。确认两边一致，然后停掉监听端：

# compare totals on BOTH servers
du -sh /root/workspace

# on the RECEIVER, once verified
pkill -f 'relayium serve'

每个文件到达时都做过 SHA-256 校验，所以大小一致再加上干净退出，就意味着副本是完整的。

排错

有几件事看起来像问题，但通常并不是——以及一个通常确实是问题的（端口被挡）。

没有输出不代表卡住。进度只在每个文件传完时才打印，因此一个大文件会安静地传。用 ss -tnp | grep 9031 在发送方查看真实状态——ESTAB 表示已连上并在传；SYN-SENT 表示连不上监听端。
SYN-SENT 表示端口被挡。在接收方向发送方开放 9031/TCP（云安全组，或 ufw allow 9031/tcp）。这是「传输迟迟不开始」最常见的原因。
优先用 tmux 加单行循环，而不是多行 nohup。把带引号和 > 重定向的多行命令粘进 shell，常常会在重定向处出错，或让你停在 > 续行提示符上。
清理进程时要精确匹配（pkill -f 'relayium sync'），而不是 pkill relayium——宽泛匹配可能误杀同一台机器上无关的 relayium 进程。
venv 等可再生目录值得排除。一个 Python 虚拟环境可能装着几个 GB 的库，这些在对端 pip 就能重建；跳过它们能省下大量传输。
符号链接和特殊文件会被跳过——sync 只传常规文件。重要的软链请单独处理。

常见问题

传到一半被打断会怎样？

什么都不会丢。重新运行 relayium sync——它会跳过接收方已有的文件，并把传了一半的文件从磁盘上已有的字节偏移续传。本指南里的 until 循环会自动做这件事，直到整个文件夹镜像完成。

这和 rsync 有什么不同？

两者都做增量单向镜像，但 relayium sync 走锁定的 TLS 连接、不需要 SSH 账号（守护进程直连），通过证书指纹互相认证两台机器，并对每个文件做 SHA-256 校验。它和 relayium 其它模式用的是同一个传输引擎。

sync 会把我从源端删掉的文件在接收方也删掉吗？

只有你要求时才会。默认情况下 sync 只新增和更新。加 --delete 才会镜像删除，而且接收方必须以 --allow-delete 运行 serve 才会执行——否则删除会被忽略并回报给你。

我能让两个文件夹持续保持同步吗？

可以。加 --watch，sync 会持续运行，在源目录下任何改动时重新镜像。对于一次性搬运一个大文件夹，你不需要它——重试循环加一个普通的 sync 就够了。

我必须开一个端口吗？

用守护进程直连的话，是的——监听端口（默认 9031）必须能从发送方访问到。如果你不想开端口、而且两台服务器之间已经有 SSH，sync 也可以走 SSH：relayium sync /path user@host:/path（远端必须装了 relayium）。

在你自己的两台服务器之间镜像一个文件夹——增量、可续传、无需盯守。

获取 CLI