应选用支持目标协议的客户端库而非 os.copy，因其不支持网络协议、认证及断点续传；推荐 sftp（github.com/pkg/sftp）、http 自定义 api 或 rsync over ssh；安全上传需结合 size、modtime（含时钟漂移余量）与分块哈希比对；并发上传须用信号量限流避免 channel 耗尽。
为什么不用 os.Copy 直接推到远程？
因为 os.Copy 只能在本地文件系统间操作，它不理解网络协议、身份认证、断点续传或目录结构映射。硬套 os.Copy 到 net.Conn 或 http.Response.Body 会立刻 panic 或静默丢字节——它期望的是实现了 io.Reader 和 io.Writer 的本地句柄，不是带超时、重试、加密的远程流。
真正要同步到远程服务器（如 Linux NAS、开发机），必须选一个支持该协议的客户端库：
-
sftp：用github.com/pkg/sftp，依赖golang.org/x/crypto/ssh，适合已有 SSH 账号的场景； -
http：用net/http+ 自定义 REST API（如接收POST /upload的 Go 服务端），控制力强但需两端开发； -
rsync over ssh：调用系统exec.Command("rsync", "-avz", ...)，复用成熟逻辑，但丧失 Go 原生并发与错误分类能力。
别试图自己封装 TCP 连接发文件——SFTP 协议本身有 channel、packet、状态机，出错时连“文件已存在”和“权限拒绝”都分不清。
如何用 sftp.Client 安全上传并跳过未变更文件？
核心不是“上传”，而是“判断要不要上传”。sftp.Client 提供 Stat() 和 Lstat()，但远程 ModTime() 在 NFS 或某些 SSHD 配置下可能被截断（Windows SFTP 服务尤其常见），单靠时间戳会误同步。
推荐组合判断逻辑：
- 先用
client.Stat(srcPath)和client.Stat(dstPath)拿远程文件 size 和 modtime； - 若 size 不同，必须上传；
- 若 size 相同但 modtime 差异 > 2s（留出时钟漂移余量），再读取源文件前 8KB + 后 8KB 计算
sha256.Sum256，与远程对应块比对； - 远程没此文件？直接上传；
- 远程有但哈希一致？
continue跳过。
注意：sftp.FileInfo.ModTime() 返回的是 UTC 时间，本地 os.Stat().ModTime() 也是 UTC，无需时区转换；但某些嵌入式 SFTP 服务返回的 time 是本地时间且无 TZ info，此时应降级为仅比 size。
并发上传时如何避免 sftp.Session 爆满或连接中断？
sftp.Client 底层复用同一个 SSH 连接，但每个 client.Open() 或 client.Create() 都会占用一个 channel。默认最大并发 channel 数是 1024，但实际受 sshd_config 的 MaxSessions 限制（常为 10）。盲目开 100 个 goroutine 同时 Create()，大概率卡在第 11 个上阻塞等待 channel 可用。
正确做法是加一层 channel 限流：
- 用
sem := make(chan struct{}, 5)控制同时最多 5 个活跃上传任务； - 每个 goroutine 开始前
sem ，结束后 <code>； - 别用
time.Sleep模拟重试——SFTP 错误如*sftp.StatusError的Code字段明确区分了sshFxNoSuchFile和sshFxPermissionDenied，应针对性处理（比如前者建父目录，后者记录告警）； - 每次
client.Connect()后，用client.Dial()复用连接，而非反复新建*ssh.Client。
如何原子替换远程文件而不破坏正在读它的进程？
SFTP 协议不支持原子 rename 跨目录，也无法像本地那样用 os.Rename。常见错误是直接 client.Create(dstPath) 覆盖——若另一个程序正 mmap 读这个文件，会触发 SIGBUS 或静默数据损坏。
安全做法分三步：
- 上传到临时路径：
dstPath + ".tmp"（确保同文件系统，否则 SFTP 无法 rename）； - 调用
client.Rename(dstPath+".tmp", dstPath)； - 捕获错误：
if errors.Is(err, syscall.EXDEV)，说明跨设备，fallback 到先client.Remove(dstPath)再client.Rename（风险略高，但比覆盖更可控）。
别忽略 client.Chmod(dstPath, mode) —— SFTP 默认上传权限是 0644，若源文件是可执行脚本（0755），必须显式设置，否则远程执行失败。
最后提醒：所有 sftp.File 打开后必须 defer f.Close()，否则句柄泄漏会快速耗尽服务端资源；而 sftp.Client 本身不用 defer close，它复用底层 ssh.Client，应在整个同步流程结束时统一 client.Close()。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
