client_loop: send disconnect: Broken pipeSH 连接中断导致 SCP 文件传输失败的问题解决方案

在使用 SCP 命令将本地文件传输到远程服务器时，我们有时会遇到 client_loop: send disconnect: Broken pipe 错误。这种错误通常是由于网络连接不稳定、目标服务器的 SSH 配置问题，或文件传输速度太快导致连接超时引起的。本文将介绍如何应对这种问题，并提供几种常见的解决方案。

问题描述

在将文件从本地某路径复制到远程服务器的某目录下时，执行以下命令：

scp -r /local/path/* user@remote-server:/remote/path/

在传输过程中可能会出现以下错误：

filename1.model           100% 8238KB 104.3MB/s   00:00
filename2.model             0%    0     0.0KB/s   --:-- ETA
client_loop: send disconnect: Broken pipe
lost connection

该错误导致文件传输中断，连接丢失。

解决方案

针对这个问题，可以尝试以下几种解决方案：

1. 减少传输速度

通过限制传输带宽，可以降低传输速度，从而减小网络波动的影响，增强传输的稳定性。可以使用 -l 参数来限制带宽。例如，将传输速度限制为 1MB/s：

scp -r -l 1000 /local/path/* user@remote-server:/remote/path/

-l 1000 表示将带宽限制为 1000Kbps（即 1Mbps），以避免由于传输速度过快而导致的连接中断。

2. 启用保持连接选项

可以通过设置 ServerAliveInterval 参数，使客户端在传输过程中定期向服务器发送信号，以保持连接活跃。这样可以防止长时间传输过程中出现超时中断的情况。

scp -o ServerAliveInterval=60 -r /local/path/* user@remote-server:/remote/path/

此命令设置了每隔 60 秒发送一次保持连接的信号，确保连接不被中断。

3. 使用 rsync 替代 SCP

rsync 是一个功能更为强大的文件传输工具，尤其适用于不稳定的网络环境。rsync 支持断点续传功能，可以在网络中断后继续传输，减少因意外中断而导致的传输失败。

rsync -avz /local/path/ user@remote-server:/remote/path/

其中：

-a 表示归档模式，保留文件的属性（如权限、时间戳等）。
-v 表示详细模式，会在终端输出传输的详细信息。
-z 表示在传输过程中对数据进行压缩，以减少传输时间。