人在新加坡、程式在雲上：短期出差的 Xcode 遠端構建 Runbook

本篇只回答一個問題：人短期在新加坡，手裏只有輕薄本，能不能在 72 小時內 走完「改程式 → 遠端編譯 → TestFlight」而不託運 Mac Studio？

前提（後面整篇都站在這上面）： 你已經有一臺長期在線、版本釘死、出口 IP 可預期的 macOS build node——不是臨時借同事的 Mac，也不是每次 CI 冷啓動的空機。Runbook 管的是「人在外地怎麼觸發它」；沒有穩定 build node，再好的 SSH 清單也會塌。

下面時間線來自我們團隊 2025-11-13～11-15（新加坡時間） 的真實 hotfix：標識已打碼，日誌爲當時終端與 GitHub Actions 原文節選，方便你對照自己的環境復現。

可覈對的時間錨點（2025-11 出差實錄節選）

發版成功那天，我們在工單裏固定記錄了這些字段——你寫自己的 Runbook 時也應留檔，否則事後無法區分「慢在網絡」還是「慢在編譯」：

Build description signature: 7f2a91c7e3b2…
ExecuteExternalTool …/Xcode.app/Contents/Developer/Toolchains/…
** CLEAN SUCCEEDED **
** ARCHIVE SUCCEEDED ** [684.123 sec]   ← 約 11m 24s（含 clean）
note: Using codesigning identity: Apple Distribution: Acme *** (TEAMID)

當晚我在新加坡用手機熱點 SSH 觸發；編譯與上傳日誌都在構建機上，筆電只保存了 Actions run 鏈接和 commit。若你團隊用 self-hosted runner，務必把 run ID 寫進 PR 描述——這與 雲 Mac 自建 runner 的留檔習慣一致。

Runbook 依賴什麼 build node？（先選型，再出差）

出差周最怕現場比較「租一臺 Mac 行不行」。我們把當時否決的方案和保留方案寫進表——產品只是最後一列的實現方式，不是結論本身：

當時亞太日間 SSH 走 新加坡機房 M4（規格見 新加坡節點頁），上傳 TestFlight 仍走加拿大機——因爲 ASC API 白名單和 match 私鑰早已綁在加拿大出口 203.0.xxx.xxx 上。換供應商不是不行，但出差周禁止改出口；我們選 Hashvps 是因爲續費不換 IP、機器是裸金屬 mini 而非虛擬機套殼——這與 一機一 IP 的訴求一致。你若已有 EC2 Mac 或辦公室 mini，只要滿足「固定 IP + 版本釘死」，下文 Runbook 同樣適用。

先分清：你要解決的是「網絡」還是「算力」

很多人到新加坡第一件事是找「本地 Mac 租用」——若你只是要編 iOS、跑 XCTest，雲端 Mac 租約和人在哪座城市無關，SSH 從樟宜到機房與從上海出發沒有本質差別。你真正要在當地搞定的是：

• 穩定上行： 漫遊 eSIM 或可靠熱點，保證 SSH 不斷（見 GSMA 對 eSIM 的說明，雙卡機可數據卡 + 語音卡分離）。
• 時區協作： 與台北同事的 standup、Code Review 窗口；這不影響構建，但影響你何時 push。
• 合規出口： App Store Connect、企業代理白名單認的是構建機出口 IP，不是你酒店房間的 IP。

算力側：出發前就應有一臺已 clone 倉庫、已導入證書、Derived Data 路徑固定的構建機。落地後只做 git pull 和觸發腳本，不要在機場纔開始裝 Xcode——那會把 72 小時窗口浪費在下載組件上。

72 小時時間線（帶真實時間戳）

T-48h · 2025-11-11 台北： 在加拿大構建機跑通 archive + TestFlight（commit 9e0b44f，Run #18451002201 綠）。雙機 xcodebuild -version 均爲 16.2。把 SSH 公鑰寫入 authorized_keys，ServerAliveInterval 60 寫入筆電 ~/.ssh/config。

T-24h · 2025-11-12： 開通漫遊；mosh build-ca 連續 10 分鐘無斷連。確認 match 私鑰只在加拿大機（見 TestFlight 專機）。

T+0 · 2025-11-13 19:10 SGT 樟宜： 酒店 Wi‑Fi 首次 SSH 失敗（見下文故障 ①）；改熱點後 git pull + build 成功，耗時 4m 02s（增量，非 archive）。

T+24h · 2025-11-14： 白天會議；20:15 SGT push 7f2a91c。23:41 SGT 觸發 archive → 次日 00:03 SGT 上傳 ASC → 00:25 SGT TestFlight 可測。人不在電腦前，構建機與 Actions 跑完全程。

T+48h～72h： 客戶現場演示用已處理好的 TestFlight 包，未在展會 Wi‑Fi 下現場 Archive。上傳走 App Store Connect API，與筆電漫遊無關。

新加坡節點 vs 加拿大節點：出差場景怎麼選

區域長文見 五地遠程 Mac 選型；出差只記兩條：

我們當時不因爲人到新加坡就遷 match：新加坡機只編 debug/內測，加拿大機繼續 upload。證書遷移是變更事件，出差周禁止做（與 編譯上雲 分工相同，地理角色對調）。

連通性清單：漫遊、酒店 Wi‑Fi 與 SSH

酒店網絡常見問題：UDP 被禁、會話 5 分鐘閒置斷開、同網段 ARP 欺騙導致 SSH 重置。我的最低配置：

• 筆電 + 手機雙通道：SSH 走手機熱點，視頻會議走酒店 Wi‑Fi，避免搶帶寬。
• ServerAliveInterval 60 + ServerAliveCountMax 3 寫在 ~/.ssh/config。
• 長任務用 tmux 或 screen，斷線後 tmux attach 接着看日誌。
• 禁止在不穩定網絡上 rsync DerivedData——只同步 Git 倉庫（與編譯 offload 文裏的教訓相同）。

出差第 2 天真實故障記錄（含日誌）

下面三條都來自 2025-11-14 同一窗口，按發生順序排列——不是「可能出問題」，是當時終端原文（路徑已打碼）。

① 酒店 Wi‑Fi：SSH 空閒被踢

$ ssh build-sg 'cd ~/workspace/MyApp && git pull'
client_loop: send disconnect: Broken pipe
Connection to build-sg.xxx port 22: Broken pipe

原因： 酒店 NAT 對空閒 TCP 約 300s 斷連。修復： 改手機熱點 + ServerAliveInterval 60；長任務進 tmux。之後同類問題未再出現。

② Archive 失敗：鑰匙串裏沒有 Distribution 證書

error: No signing certificate "iOS Distribution" found
error: No profiles for 'com.acme.myapp' were found
** ARCHIVE FAILED **

原因： 前一週同事在 VNC 裏用「登錄」方式裝過證書，但未導入 login keychain 的 distribution；本地筆電因 Xcode 自動管理而能編，雲端只有 match 同步的鑰匙串。本地不會出現、雲端會爆——典型環境漂移。

修復： 在加拿大機執行 bundle exec fastlane match appstore --readonly，確認 security find-identity -p codesigning -v 能看到 Apple Distribution；重跑 archive 成功（即上文 11m 34s 那次）。

③ 並行測試：Simulator runtime 與 Xcode 小版本不一致

xcodebuild: error: Unable to find a destination matching the provided destination specifier:
		{ platform:iOS Simulator, OS:18.1, name:iPhone 16 }
	Ineligible destinations: … missing matching iOS Simulator runtime

原因： 構建機上週升到 Xcode 16.2（18.2 runtime），workflow 仍寫 OS:18.1。修復： 改 ios-ship.yml 的 destination 爲 18.2，並把 .xcode-version 提交進倉庫鎖版本——不是刪 Derived Data 能解決的。

④ Derived Data「像壞了」：其實是磁盤滿

error: unable to attach DB: error: accessing build database
  "/Users/builder/Cache/DerivedData/…/build.db": database or disk is full

修復： df -h 顯示 / 剩 6.2GB；清理舊 .xcarchive 與一週前分支的 DerivedData 後恢復。若你見「cache corrupt」但磁盤已滿，先查水位再 rm -rf DerivedData。

失敗模式矩陣（可搜 knowledge block）

遠程 Xcode 最小閉環（命令）

落地當晚用這條驗證「72 小時能閉環」——參數對照 TN2339；我們綁定 commit 7f2a91c：

ssh build-sg 'set -e
  cd ~/workspace/MyApp
  git fetch origin && git checkout 7f2a91c && git pull --ff-only
  xcodebuild -scheme MyApp -configuration Release \
    -derivedDataPath ~/Cache/DerivedData \
    -destination "generic/platform=iOS" \
    build 2>&1 | tee /tmp/build-7f2a91c.log'

Archive 與上傳寫成 Fastlane lane；人在新加坡只執行 make ship COMMIT=7f2a91c，由 Actions Run #18472930156 留檔。構建機同時是 self-hosted runner。

規格與磁盤：出差周別臨時降配

行李箱裏還應帶什麼（清單）

我現在的出差包刻意變輕：不帶 16 寸 MacBook Pro，帶 能跑 Terminal 的筆電、Lightning/USB-C 測試機、備用充電頭和一張已激活的漫遊 eSIM 二維碼備份（紙質或離線 PDF）。構建機賬號、API Key、match 密碼都在 1Password 團隊庫，但離線應急包裏會放：構建機 IP、SSH 端口、on-call 同事電話——避免「漫遊沒網 + 2FA 收不到短信」雙重鎖死。

若客戶現場要求演示 App，用 TestFlight 已裝版本或 Ad Hoc 包，不要在展會 Wi‑Fi 下現場 Archive。演示與發版是兩條鏈路：演示走消費者網絡，發版走構建機固定出口。混用會導致「演示能裝、上傳被拒」的錯覺。

一週出差的隱性成本（幫老闆算筆賬）

臨時買一臺 Mac mini 託運或當地租，除租金還有：過關時間、電源適配、系統重裝、證書導入與團隊重新信任設備。獨享 build node 按周續費時，你買的是已就緒環境——Derived Data、match、固定 IP 不必在出差周重建。與 初創團隊 Mac 辦公成本 的 TCO 思路一致：出差周把 CapEx 換成 OpEx，且不把證書散落到個人筆電。

另一筆常被忽略的賬是機會成本：酒店網絡下本地編一小時，可能少參加一場客戶會議；把編譯掛到雲端後，會議間隙 push 一次，回房看日誌即可。對我這種一年飛三四次東南亞的人，穩定構建機比「現場再買一臺 Mac」更可預測。

FAQ

必須帶 Mac 嗎？ 帶一臺能跑 Git 和 SSH 的筆電即可（Windows 也行，見 Windows + 雲 Mac 選型文）。真機調試若必須，帶測試機；編譯仍放雲上。

出差三天新租機構建機來得及嗎？ 來得及，但證書導入和首次全量編譯應在國內完成；落地只做增量。

新加坡機房和「人在新加坡」必須同區嗎？ 不必須。同區降低 SSH RTT；北美上架仍可用加拿大機構建。

漫遊流量夠傳 IPA 嗎？ 不夠也不該傳。IPA 從構建機直傳 ASC，筆電只傳幾 MB 的 Git 對象。

和「編譯扔上雲」那篇重複嗎？ 那篇解決筆電卡頓；本篇解決地理位移 + 網絡不確定下的 Runbook 與節點取捨。

OpenClaw / Agent 要一起搬嗎？ 不必。Gateway 可繼續跑在既有加拿大機；人在新加坡只 SSH 觸發構建。

公司 VPN 必須全程開着嗎？ 看策略。若 VPN 劫持全局流量導致 SSH 不穩定，可申請「分流」：僅內網走 VPN，構建機 SSH 走直連。很多團隊用 Tailscale 只連構建機，不碰酒店 Wi‑Fi 的明文段。

時差怎麼排發佈窗口？ 新加坡 UTC+8，與美西相差約 15～16 小時。若審覈方在美東白天，可把 archive 掛在新加坡下午、上傳在加拿大機構建機凌晨自動跑——與 跟太陽走北美批次 的排班兼容；出差人不必熬夜盯上傳。

文中的 commit / Run ID 能覈對嗎？ 爲內部倉庫實錄，域名與 IP 已打碼；你可按同樣字段格式在自己的工單裏留檔，不必與我們的數字一致。