連線
SSH 或 VNC 無法建立工作階段
適用於連線逾時、主機指紋變更、憑證遭拒、圖形工作階段中斷或重新連線後顯示異常。
查看連線診斷
問題分類
將現象對應至檢查入口
六類問題同時展開，不必逐一切換篩選條件。每張卡片都列出最常見的症狀、優先檢查項目與本頁對應位置。
系統
工具鏈版本發生變更
適用於 Xcode 選擇錯誤、命令列工具路徑變動、系統更新後相依性不相容或環境變數失效。
查看維護方法
網路
擷取、上傳或埠號轉送失敗
適用於 Git 擷取中斷、SFTP 傳輸失敗、SSH 通道無法連線、DNS 解析異常或本機網路限制。
查看傳輸建議
儲存空間
建置快取塞滿本機磁碟
適用於 DerivedData、封存檔、相依性快取或記錄持續增長，導致建置失敗、匯出中斷或寫入速度下降。
查看空間檢查
建置
簽署、封存或自動化工作失敗
適用於憑證與簽署檔案不相符、runner 環境不一致、相依性快取污染或封存產物未產生。
查看建置維護
帳戶
需要核對訂單或裝置記錄
適用於需要確認租期狀態、裝置識別碼、訂單記錄、通知電子郵件或工單關聯對象的情況。
進入控制台
連線診斷
依相同順序縮小故障範圍
不要同時重設憑證、切換網路並修改系統設定。先保留原始錯誤訊息，一次完成一項檢查，結果才可比較。
01
節點狀態
在控制台核對裝置識別碼、區域、租期與存取狀態。確認操作的是目標裝置，並記錄狀態變更的時間。
02
存取憑證
核對使用者名稱、SSH 私密金鑰路徑與檔案權限。不要將私密金鑰、密碼或完整連線憑證貼到電子郵件、聊天記錄或一般記錄中。
03
SSH 通道
先驗證主機指紋，再使用詳細輸出定位失敗階段。區分 DNS、TCP 建立連線、金鑰協商與使用者驗證，避免只憑「連線失敗」判斷原因。
04
圖形工作階段
SSH 正常而 VNC 異常時，檢查用戶端位址、工作階段狀態與解析度設定。斷線後先等待原工作階段釋放，再使用同一裝置記錄重新連線。
05
系統防火牆
確認遠端存取所需的程序仍在執行，相關埠號處於預期的監聽狀態。修改規則前先儲存目前設定，方便問題擴大時復原。
06
本機網路
最後再更換本機網路進行比對。暫時停用可能改寫路由的代理伺服器或 VPN，並比較公司網路、家用網路與行動熱點下的結果。
遠端桌面
讓圖形工作階段可恢復、可交接
VNC 適合需要 Xcode、預覽程式與圖形工具的工作。連線前先確保 SSH 通道可用；圖形工作階段異常時，仍可使用命令列檢查路徑。
準備受控的 VNC 用戶端
從可信來源安裝用戶端，儲存裝置名稱，而不是共用完整憑證。首次連線先核對目標區域與裝置識別碼，再確認加密與鍵盤配置設定。
- 分別儲存裝置名稱與存取位址
- 團隊成員使用各自受控的存取方式
- 優先透過受控網路或 SSH 通道連線
先調整解析度，再判斷流暢度
遠端畫面同時受解析度、色彩深度與本機網路影響。先降低顯示範圍進行比對，不要同時更換用戶端、網路與系統顯示設定。
- 從較低解析度開始驗證輸入反應
- 避免在傳輸大型檔案時同時評估畫面
- 記錄異常出現前最後一次設定變更
鎖定工作階段，不要強制結束程序
短暫離開時鎖定圖形工作階段，避免直接關閉仍在執行建置的應用程式。斷線重新連線後，先確認原工作狀態，再決定是否重新啟動工具。
- 離開前儲存專案與尚未提交的變更
- 不要因畫面凍結就立即重複啟動工作
- 成員離開團隊後及時撤銷其存取方式
建置環境
固定工具鏈，再清理可重新產生的資料
持續建置最怕環境在工作之間無記錄地變更。將版本選擇、簽署材料與快取清理寫入團隊執行手冊。
固定 Xcode 與命令列工具
在專案設定與 runner 初始化腳本中記錄 Xcode 版本，執行工作前核對目前的開發者目錄。系統或 Xcode 發生變更後，先執行最小測試工作，再恢復完整工作流程。
分離憑證、簽署檔案與程式碼儲存庫
憑證、簽署檔案、權杖與環境變數應透過團隊自己的秘密管理流程注入。不要將長期憑證提交至 Git，也不要把包含敏感欄位的原始記錄當作一般附件轉寄。
依來源清理快取
先確認空間是由 DerivedData、相依性快取、封存檔、模擬器資料還是專案素材佔用。優先刪除可重新產生的資料，保留仍需回傳的建置產物與問題現場。
環境核對清單
執行工作前
- Xcode
- 版本與專案限制一致
- 開發者目錄
- 指向目標工具鏈
- 簽署材料
- 依工作暫時注入
- 磁碟空間
- 涵蓋快取、封存與匯出
- 最小測試
- 先驗證擷取、編譯與產物產生
一次只變更一項
將結果寫入建置記錄
網路與檔案
分開驗證連線通道與檔案通道
先用小型檔案驗證路徑與權限，再傳輸完整儲存庫、素材或建置產物。失敗時記錄方向、大小、時間與具體階段。
只轉送必要的埠號
明確指定本機埠號、目標位址與用途，避免開放過於寬泛的監聽。建立通道後，分別驗證 SSH 本身與被轉送的服務，方便區分驗證問題與應用程式問題。
先確認目錄權限
使用專用的專案目錄接收檔案，先上傳小型樣本並核對讀寫權限。大型檔案完成後檢查大小或校驗值，不要將用戶端進度列視為唯一結果。
限制儲存庫憑證範圍
為自動化工作使用最小權限憑證，並限制至必要的儲存庫。擷取失敗時，分別檢查 DNS、遠端可達性、主機指紋、憑證權限與儲存庫位址。
回傳後再清理來源檔案
為產物附上工作識別碼、版本與校驗資訊。確認目標端已完整接收後，再清理節點上的中間檔案，避免重複建置卻無法還原原始結果。
知識文章
從操作步驟延伸至團隊策略
以下文章依發布日期由新到舊排列，涵蓋系統升級、連線安全、服務選擇、音訊與視訊、Unity iOS 建置及 M4 開發工作觀察。
知識文章整理中
完整文章發布前，可先使用本頁的連線診斷、系統維護、網路傳輸與建置環境檢查清單。
人工支援
讓支援工單直接進入可排查狀態
技術問題請優先透過控制台提交，這樣可以關聯特定裝置與訂單。無法登入時，可寄送電子郵件至 support@runnervps.com，但不要附上密碼、私密金鑰或完整付款憑證。
裝置識別碼
控制台中顯示的裝置名稱，不要傳送存取密碼
區域
新加坡、日本（東京）、韓國（首爾）、香港或美國東部
問題時間
包含時區，並註明最後一次正常操作的時間範圍
重現步驟
依執行順序寫出命令、操作與實際結果
去識別化記錄
移除權杖、金鑰、密碼、儲存庫憑證與個人資料