痛點拆解：multiplex 不是免費午餐
痛點 1：慢等于頻寬。短连接密集时 DNS+TCP+KEX+认证累計可能超过真实傳輸；无基线会误扩容。
痛點 2：并行被串行化。多路 rsync 共用 ControlPath 会在 SSH 層排队，鋸齒吞吐；限額日誌常誤判为会话而非複用。
痛點 3：NAT 靜默断连。中間盒 300–900s 空闲丢状态；无 ServerAliveInterval/ClientAliveInterval 则表现为字节计数停住。
痛點 4：與 known_hosts、双栈纠缠。複用不免合规；AAAA 抖动时主套可能缓存异常，需拆 Host 或重启主套。
威脅模型與觀測指標：先分離握手、傳輸與閘門
指標分三層：L1 连接（DNS、TCP、KEX）、L2 複用（命中、主套年龄、佇列）、L3 傳輸（rsync 速率、閘門退出码）。L1+L2 不稳勿在 L3 盲目最佳化。
对遠端 Mac 入口，还应把 併行会话與 MaxSessions 與 Runner 出口 NAT 放在同一面板；人机共用账号时拆分 Host 別名與 ControlPath，避免调试时誤殺主套接字。
可引用資料：把「感觉更快」写成可迴歸数字
跨区单次握手常见 120–400ms；短 Job 每分鐘多次可累計数十秒/小時。multiplex 命中后主握手可降到毫秒级，但单流吞吐仍受 TCP 與算法限制。NAT 空闲常见 300/600/900s；ServerAliveInterval 30 與 ServerAliveCountMax 4 应对照最后应用字节时间线；远端 ClientAliveInterval 更大时取更严一侧。大 tarball 时 multiplex 收益有限，优先 分段校驗與原子发布。
決策矩陣：何时啟用、何时停用、如何拆分
| 场景 | multiplex 建議 | 主要收益 | 主要风险 |
|---|---|---|---|
| 大量小文件增量同步 | 啟用 ControlMaster auto + 合理 ControlPersist | 显著降低握手尾延迟 | 主套偶发损坏需自动重建 |
| 同一 Runner 高并行 rsync | 拆分 ControlPath 或关闭 multiplex | 避免 SSH 層串行化 | 握手成本回升 |
| 長傳 + 严格閘門 | 可啟用，但独立 CI 账号與目錄權限 | 减少中段重连 | NAT 與中間盒仍需 keepalive |
| 共享构建账号给人机共用 | 人类與 CI 分 Host 別名與分路径 | 降低误操作面 | 配置分支变多 |
| 安全合规要求高 | 縮短 ControlPersist 或停用 | 縮短憑證暴露窗 | 吞吐與握手成本上升 |
實作步驟：从基线到回滚（How-to）
# A) 在 ~/.ssh/config 为遠端 Mac CI 目标建立別名（示例）
# Host rm-ci
# HostName your.remote.mac.example
# User ciupload
# IdentityFile ~/.ssh/id_ed25519_ci
# ControlMaster auto
# ControlPath ~/.ssh/cm/%r@%h:%p
# ControlPersist 10m
# ServerAliveInterval 30
# ServerAliveCountMax 6
# ConnectTimeout 15
# B) 首次连接建立主套接字；后续 rsync 自动複用
# rsync -avz -e "ssh -F ~/.ssh/config" ./dist/ rm-ci:~/artifacts/
# C) 紧急关闭複用（排障对照）
# ssh -S ~/.ssh/ci/[email protected]:22 -O exit rm-ci
步驟 1：在无 multiplex 情况下跑三次相同 rsync，記錄总时延與 CPU；确认瓶颈不在本地打包或远端磁盘。
步驟 2：加入 ControlMaster auto 與 ControlPath，确保目錄權限仅 CI 用户可写，避免全球可讀套接字路径。
步驟 3：为并行 Job 设计拆分策略：按 matrix 分端口、分账号，或每 Job 独立 ControlPath 子目錄，观察佇列是否消失。
步驟 4：把 ServerAliveInterval 與远端 ClientAliveInterval 对齐到 NAT 窗口之下，并與 併行 SFTP 文 的 keepalive 建議交叉驗證。
步驟 5：把 known_hosts 與 StrictHostKeyChecking 固化在流水线映像層，避免 multiplex 複用时仍觸發互動式提示。
步驟 6：将 partial 與 SHA256 閘門 设计为冪等：主连接重建后仍能断点續傳且不誤判成功。
步驟 7：在发布文件中保留「关闭 multiplex 的 Host 別名」作为緊急开关，避免排障时被迫改生产主配置。
强相关閱讀與站内 CTA
推荐閱讀順序：本文 → known_hosts → 併行 SFTP → IPv6 双栈 → 完整性閘門 → 首頁。
FAQ 與為什麼考慮 SFTPMAC 託管遠端 Mac
ControlPersist 应该设多长？
取决于 Job 间隔與安全基线：高频短 Job 可用 5–15 分鐘；低频次且敏感环境建議縮短或关闭。关键是與 on-call Runbook 一致，而不是各自本地 ~/.ssh 私改。
能否與 ProxyJump 叠加？
可以，但要把 ControlPath 命名到能区分「直达 vs 跳板」两套主套接字，否则排障时很难判斷失败發生在哪一跳。
总结：ControlMaster 治握手税，须與并行、NAT、限額、閘門同设计并保留无 multiplex 回滚別名。
侷限：網路 DNS/双栈/代理不稳时 multiplex 只加速失败，须先收敛 L1。
對比與收束：SFTPMAC 託管遠端 Mac 把握手、併行、keepalive 與權限沉淀为可重复 SLA，團隊可專注迭代而非維護 Runner 拓樸。
把 multiplex、keepalive 與 known_hosts 写进同一 Runbook，託管入口更易做季度迴歸。