首次連線
先核對位址、連接埠與帳戶
確認使用訂單中的主機位址、連線連接埠與帳戶名稱。首次 SSH 連線應人工核對指紋；VNC 則先使用預設解析度與中等畫質建立基準。
進入連線排查
技術支援入口
從錯誤現象開始，定位雲端 Mac 問題
輸入錯誤訊息片段、工具名稱、連線方式或訂單主題。本文件涵蓋首次連線、權限、macOS 操作、Xcode 建置、節點網路、儲存空間擴充、帳單與付款。
HELP ROUTER
先判斷問題發生在哪一層
01
連線層憑證、連接埠、SSH、VNC、區域網路
02
建置層xcodebuild、fastlane、簽署環境、快取
03
節點層地區選擇、延遲、抖動、傳輸工作
04
訂單層週期、節點、附加項目、付款與服務狀態
建議先記錄原始錯誤訊息
不要先清除整個環境；保留可重現的證據，更容易定位根本原因。
依發生階段選擇入口
七組主題同時展開，不需要逐一篩選。先進入最接近現象的主題，再依檢查順序縮小範圍。
帳戶權限
區分登入失敗與操作權限不足
可以登入但無法寫入目錄時，通常應檢查檔案擁有者、目錄權限與命令執行身分；完全無法登入時，優先檢查憑證、金鑰權限與連線目標。
查看判斷路徑
macOS 操作
先檢查資源，再修改系統設定
查看磁碟剩餘空間、記憶體壓力、佔用 CPU 的程序與系統時區。涉及版本或工具鏈調整時，先記錄目前狀態，避免一次修改多個變數。
查看首次設定
Xcode 建置
保留完整命令與第一個失敗點
記錄 Xcode 版本、scheme、configuration、目標平台與原始命令。應從第一個明確錯誤開始分析，而不是只截取最後一行失敗摘要。
開啟建置手冊
網路延遲
分別判斷延遲、抖動與傳輸佔用
單次 ping 不能代表互動體驗。持續取樣並觀察中位數、抖動與封包遺失，同時排除本地 Wi-Fi、代理伺服器、上傳工作與高畫質遠端桌面的影響。
比較節點方向
儲存空間擴充
先確認工作集與快取增長速度
區分原始碼、依賴快取、建置產物與素材檔案。擴充前記錄目前可用空間與每日增長量，再決定是否選擇 +1TB SSD 或 +2TB SSD。
查看附加選項
訂單帳單
逐項核對週期、節點與附加項目
帳單問題不要只提供總額。應同時記錄訂單識別碼、機型、計費週期、所選節點、SSD 擴充與 Thunderbolt 5 並聯項目。
查看訂單說明先定位失敗發生在驗證、網路還是畫面層
不要同時更換用戶端、網路與憑證。每次只變更一個條件，並保留對應時間點與錯誤文字。
01
憑證錯誤
出現 Permission denied 或金鑰驗證失敗時，核對使用者名稱、私密金鑰檔案、金鑰權限，以及是否選錯主機。不要反覆猜測憑證。
檢查結果
主機可連線，驗證未通過
02
連接埠無法連線
出現逾時或拒絕連線時，先確認位址與連接埠，再從另一個網路測試。逾時通常表示路徑不通；立即拒絕則表示目標可達但連接埠未接受連線。
檢查結果
尚未開始驗證
03
遠端桌面畫面異常
可以建立工作階段但出現黑畫面、花畫面或嚴重卡頓時，先降低解析度與畫質，關閉背景大型檔案傳輸，再中斷並重新建立工作階段。
檢查結果
連線已建立，顯示鏈路異常
04
本地網路限制
同一節點在手機熱點可用、辦公室網路不可用時，優先檢查本地防火牆、代理伺服器策略、出口限制與 Wi-Fi 封包遺失，而不是立即更換雲端節點。
檢查結果
服務端正常，需排查本地路徑
保留環境資訊，再處理建置失敗
建置記錄的價值取決於上下文。至少同時提供工具版本、執行命令、工作目錄、目標與第一個失敗點。
| 問題類型 | 先檢查 | 建議動作 | 保留資訊 |
|---|---|---|---|
| xcodebuild | scheme、configuration、destination、SDK 與工作目錄 | 使用同一個完整命令重新執行，並從第一個明確錯誤開始定位 | 命令、結束代碼、Xcode 版本、失敗上下文 |
| fastlane | Ruby 環境、依賴鎖定檔、lane 參數與工作目錄 | 優先使用專案鎖定的依賴執行，避免臨時升級整套工具 | lane 名稱、呼叫參數、依賴版本、原始輸出 |
| 簽署環境 | 憑證有效性、描述檔匹配關係、鑰匙圈存取權限 | 核對 bundle identifier、團隊設定與目標配置，不要上傳未去識別化的簽署資料 | 目標名稱、簽署方式、去識別化後的錯誤文字 |
| 清理快取 | DerivedData、套件管理器快取與磁碟剩餘空間 | 只清理與失敗目標相關的快取，避免同時重設整個環境 | 清理前後的命令、磁碟剩餘空間、依賴解析結果 |
| 記錄收集 | 時間範圍、時區、命令結束代碼與結果套件 | 保存文字記錄與必要的結果套件，截圖僅作為補充 | 發生時間、重現步驟、第一個錯誤及其前後輸出 |
最小重現
先證明同一個命令能穩定失敗
如果失敗只出現在自動化工作中，請使用相同工作目錄、環境變數與依賴版本手動執行一次。手動成功而佇列失敗時，再比較執行身分、工作目錄與環境注入差異。
xcodebuild -scheme App -configuration Release build
echo $?
sw_vers
xcodebuild -version五個在售節點，依主要存取方向選擇
目前目錄僅包含新加坡、東京、首爾、香港、美國西部。兩種機型在這五個節點均可訂購，實際可用狀態以控制台即時回傳為準。
新加坡
適合主要訪客位於東南亞的工作流程。比較節點時，應使用實際辦公網路持續測試，而不是只參考地理距離。
東南亞方向東京
適合日本及東亞方向的互動工作。需要長時間使用 VNC 時，應同時觀察延遲、抖動與畫面位元率。
日本與東亞方向首爾
適合韓國及東北亞方向。若 SSH 回應正常但畫面卡頓，應先降低遠端桌面畫質並暫停背景傳輸。
韓國與東北亞方向香港
適合華南與部分東南亞方向。企業網路與家庭網路的出口路徑可能不同，選擇前應在實際使用網路中測試。
華南方向美國西部
適合北美西岸方向，以及需要靠近當地協作鏈路的工作。跨洲存取應優先評估互動延遲，再評估大型檔案傳輸。
北美西岸方向
就近不等於只看地圖
先從地理位置較近的節點開始，再在相同網路、相同時段完成持續取樣。比較中位延遲、抖動、封包遺失與 VNC 操作回應；如果多位成員跨地區協作，應綜合主要互動者與大型檔案傳輸方向決定節點。
分開核對訂單內容與付款記錄
訂單配置決定交付內容，付款記錄決定結算狀態。提交問題時應分別提供兩組資訊，避免只傳送付款截圖而缺少訂單識別碼。
訂單問題：先開啟控制台核對目前配置
依序檢查訂單識別碼、Lemon M4 或 Lemon M4 Pro、日／週／月／季週期、所選節點、SSD 擴充、Thunderbolt 5 並聯項目與目前服務狀態。
- 機型規格應與訂單摘要一致。
- 節點應為新加坡、東京、首爾、香港、美國西部其中之一。
- 附加項目應與帳單明細逐項對應。
- 可用性以控制台即時回傳為準。
付款說明：只核對支援的兩類管道
所有訂單均以美元（USD）結算。實際可用的付款閘道以後端回傳為準，支援範圍僅包括以下兩類：
- USDT-TRC20：核對網路類型、收款資訊、金額與交易識別碼，轉帳前逐字確認。
- 銀行卡：Visa / Mastercard / Amex，由 Stripe 處理；依結帳頁面提示完成驗證。
若付款狀態與訂單狀態不一致，請保留訂單識別碼、付款時間、金額與去識別化後的交易憑證，不要提交完整卡片資訊或存取權杖。
六項資訊可大幅縮短往返確認時間
請刪除私密金鑰、助記詞、完整存取權杖與未去識別化的簽署資料。支援團隊需要可重現的資訊，不需要敏感憑證。
01
訂單識別碼
提供控制台中可見的訂單識別碼，不要只寫機型名稱或付款金額。
02
發生時間
寫明問題發生的時間與時區；間歇性問題還應記錄最近一次正常的時間。
03
所選節點
註明新加坡、東京、首爾、香港或美國西部，並說明主要存取者所在方向。
04
重現步驟
從已知正常狀態開始，依實際操作順序列出命令、介面操作與失敗位置。
05
截圖或去識別化記錄
優先提供可複製的錯誤文字；截圖應包含必要上下文，記錄應保留第一個錯誤前後的輸出。
06
預期與實際結果
分別說明預期發生什麼、實際發生什麼，以及問題是否能穩定重現。
支援管道只有兩種
登入控制台提交工單，適合關聯現有訂單與服務狀態；或寄送電子郵件至 support@lemonvm.com，適合售前選型及無法登入控制台的情況。
準備開始
確認用途、節點與週期，再選擇實體節點
兩種機型、五個節點、日／週／月／季四種週期均會在下單流程中清楚顯示。購買後可在控制台查看配置與服務狀態。