2026 雲端 Mac 併發 SSH 與螢幕共享鎖死排障手冊：當 PTY 自動化與遠端 GUI 爭用時，如何解凍 MacLogin Apple Silicon

平台工程師常在同一 macOS 使用者下混用無頭 ssh 與互動式螢幕共享，於是看起來像隨機卡死：既不像斷線，也不像 CPU 打滿。 2026 年 4 月的工程共識是：控制台工作階段爭用——WindowServer、loginwindow 與綁定 PTY 的自動化爭搶同一套 GUI 脈絡——外在表現很像 VNC 不穩，實則是本機鎖。 本手冊提供凍結症狀決策矩陣、九條必須依序執行的恢復步驟、五列表埠號與常駐程式衝突說明、可直接貼進工單的統一日誌述詞，以及面向 MacLogin 在香港、東京、首爾、新加坡與美國租約的常見問題。

建議與 共享 SSH 工作階段治理清單、VNC 剪貼簿與螢幕錄製政策、SSH 金鑰輪換與雙因素 對照閱讀。若事件以退租收尾，請執行 企業退租抹除流程。營運入口：定價、說明文件、VNC。

在 MacLogin 上，租約通常綁定單一業務線；當港美股收盤視窗與亞太 CI 高峰重疊時，最容易出現「人看螢幕、機器跑指令稿」的疊加。先把問題歸類為控制台爭用而非單純頻寬，可顯著縮短排障時間：先數清 PTY 與螢幕共享連線數，再對照矩陣選欄，而不是先重開機。若團隊在 Slack 維護 on-call 手冊，請把九步順序寫死，避免新人跳過暫停 CI 直接殺行程，造成鑰匙圈或 FileVault 狀態更難復原。

日誌側請堅持「先取證、後動作」：WindowServer 與 screensharingd 的 20 分鐘視窗通常足以覆盤；若只保存 sshd 日誌而缺少 GUI 側證據，稽核常會追問誰在何時持有 GUI 鎖。壓縮套件命名建議包含租約 ID、區域縮寫與 UTC 偏移，便於新加坡與美國團隊共用同一份 tarball。對受監管產業，保留 35 天與後文閾值一致，可滿足多數橫向比對需求。

併發遠端工作階段何時卡死（以及為何常誤判層級）

2026 年 4 月 MacLogin 事故橋接裡，三類模式最常見：

• 經 SSH 的 CI 在同一桌面被螢幕共享觀看時啟動 osascript 或 xcodebuild——雙方預設 Aqua 仍然順暢。
• 安全軟體 彈出僅出現在實體控制台的 TCC 對話框，螢幕共享觀看者看不到；自動化可能阻塞 27–40 分鐘，直到有人現場接入或終止工作。
• 多路螢幕共享 在把 5900 經 SSH 轉送後又疊加原生監聽；每多一名觀看者都會放大影格緩衝差異，即便 CPU 閒置也可能把 WindowServer GPU 占用推到 85% 以上。

凍結症狀矩陣（重啟前先選對欄）

可觀察訊號	偏 SSH 假設	偏螢幕共享假設	首選動作	建議取證
游標可動但點擊無效	sudo 密碼助理卡住	WindowServer 假死	暫停 CI；斷開第二名觀看者	對 WindowServer 取樣 10 秒
SSH 仍收輸入但 GUI 凍結	PTY 仍健康	控制台使用者 GUI 鎖	用次要管理員帳號做對照	loginwindow 心跳日誌
雙通道約 5 秒內同時卡死	核心 I/O 或 APFS 快照	同源	檢查 diskutil apfs listSnapshots	儲存壓力曲線
螢幕共享約每 11 分鐘掉線	上游閒置 TCP 逾時	ARD 保持連線不一致	為 SSH 隧道啟用 60 秒 keepalive	在用戶端做 TCP 擷取

鎖機制：控制台、ARD 代理與 SSH PTY 的相互作用

大量 macOS 自動化原語綁定在控制台使用者工作階段上。螢幕共享推送的正是該工作階段；SSH 可以保持無頭，也可能間接觸發需要 GUI 情境的工具。當兩者同時施壓，會出現優先權反轉：loginwindow 仍在處理認證，但 WindowServer 無法合成新影格，因為某工具持有 CGS 鎖。

在 MacLogin 主機上，ARD/螢幕共享通常監聽 5900，觀察模式可能使用 5901–5903。工程師筆電睡眠/喚醒後重複新增 -L 5900 轉送，會與原生監聽衝突。

九步有序處置手冊（請勿跳步）

1. 標定影響面：在工單寫明租約 ID、區域（HK/JP/KR/SG/US）、控制台使用者名稱、螢幕共享用戶端數量、互動式 SSH 工作階段數量。
2. 暫停 CI 至少 6 分鐘，讓卡住的 osascript 助手有機會退出。
3. 斷開冗餘螢幕共享，僅保留一路；等待 90 秒再判定是否恢復。
4. 校驗監聽：執行 netstat -an | grep 590 並清理重複轉送。
5. 若治理允許，輪換到次要 macOS 使用者，拆分建置與操作員身分，參見 共享建置帳號治理。
6. 擷取統一日誌 300 秒，述詞見下一節；gzip 後附在工單。
7. 遠端執行 pmset displaysleepnow 再依賴網路喚醒（若啟用）做一次顯示器睡眠重設，有時可清掉卡死的合成器狀態而無需重啟。
8. 僅當第 7 步連續失敗兩次再重啟；對 JP 金融租戶請避開交易時段。
9. 事後在排班備註中寫明哪些自動化今後不得與螢幕共享重疊。

埠號與常駐程式衝突矩陣

TCP 埠	常見占用者	衝突特徵	緩解
22	OpenSSH	MaxStartups 限制突發	謹慎提高 staging 的 MaxStartups；優先跳板
5900	螢幕共享	重複的 SSH -L 轉送	為每位工程師分配不同本機埠
3283	ARD 代理（舊）	ARD 與螢幕共享政策混用	在伺服器政策中關閉不用的 ARD 能力
動態	USB 工作階段工具	測試用 HID 模擬	在專用租約上跑 HID 套件

統一日誌述詞與證據包

請收集三類材料，便於支援側無需猜測即可覆盤：

• WindowServer： log show --last 20m --predicate 'process == "WindowServer"'
• 螢幕共享認證： log show --last 20m --predicate 'process == "screensharingd"'
• SSH 工作階段元組： 在每個卡住工作階段匯出 SSH_CONNECTION 並貼入工單正文。

保留目標：在共享物件儲存上壓縮保存 35 天，方便 JP 與 US 監管方審閱同一份套件而無需再從租約拉取。

常見問題

能否在 SSH 上直接執行 sudo pkill ScreenSharing？ 僅在所有閒置觀看者斷開後；否則可能讓工程師卡在 FileVault 解鎖中途。

是否應徹底停用螢幕共享？ 不建議——許多 macOS 提示必須 GUI。更可行的是把螢幕共享排進維護視窗並與 CI 行事曆對齊。

MacLogin 會限制螢幕共享頻寬嗎？ 區域級整形寫在 定價 說明裡；跨區飽和路徑抖動會更高。

為何 Mac mini M4 更利於併發遠端工作流

Apple Silicon M4 的 GPU 影格緩衝路徑更寬、媒體引擎更高效，在併行 tail 大型 Xcode 日誌時仍能保持螢幕共享回應。統一記憶體減少小型 x86 虛擬機常見的 GPU/CPU 記憶體池割裂換頁。MacLogin 在 HK、JP、KR、SG、US 的布局讓你把 GUI 重的租約放在離團隊最近的區域，而 CI 留在無頭設定，從實體拓樸上降低東京交易員與新加坡機器人誤共享同一控制台的機率。

依 定價 增租比把 Aqua 自動化與人類螢幕共享硬塞在同一台 mini 更划算：若執行本手冊後併發事故仍超過每月 3 次，應拆分租約而非繼續堆疊風險。