從交付到開工

主機連不上?
先從這裡排查

這是專屬雲端 Mac 的連線與開發環境指南。先核對控制台提供的交付資訊,再檢查工具鏈和工作設定。你的節點是專屬實體主機,不是虛擬機;圖形介面和命令列都能使用。

已有訂單的話,請前往執行個體詳細資料頁面。主機位址、使用者名稱、連接埠與目前交付狀態,請以控制台即時顯示的資訊為準。

首次連線

先取得連線資料,再選擇連線方式

遠端桌面適合檢查系統、設定 Xcode 和除錯圖形介面;SSH 適合下載程式碼、執行建置和查看記錄。兩種方式連線到同一台機器,不必複製兩份專案。

圖形介面

螢幕共享/VNC

在控制台的執行個體詳細資料中取得遠端桌面位址與登入資料。macOS 可使用螢幕共享;其他系統則使用相容 VNC 的用戶端。請勿混用 SSH 密碼和獨立的 VNC 登入資料。

  1. 複製主機位址、遠端桌面連接埠和使用者名稱,並確認沒有多餘空格。
  2. 在用戶端輸入位址與連接埠。VNC 常用連接埠是 5900,實際連接埠請依控制台顯示的資料填寫。
  3. 依照交付說明完成驗證。若出現驗證失敗,先確認使用者名稱和登入資料類型,再試一次。
  4. 登入桌面後,請變更初始系統密碼;如使用獨立的遠端桌面登入資料,也請依執行個體說明更新並妥善保存。

桌面延遲嚴重時,先降低畫質並關閉不必要的桌面動畫;保留一個 SSH 連線,方便判斷是網路還是圖形工作階段出了問題。

命令列

SSH

使用系統終端機或可信任的 SSH 用戶端。SSH 常用連接埠是 22;如果交付資訊使用其他連接埠,連線命令必須加上對應的 -p 參數。

  1. 從執行個體詳細資料中取得主機位址、SSH 連接埠和使用者名稱,請勿猜測預設帳戶。
  2. 使用 ssh -p PORT USER@HOST 連線,並將大寫欄位替換成實際交付資料。
  3. 首次連線出現主機指紋提示時,先核對可信任的執行個體資訊。若指紋突然變更,請停止連線並提交工單。
  4. 首次登入後執行 passwd 變更初始密碼,再設定自己的 SSH 公開金鑰。

確認公開金鑰登入成功後,再調整密碼登入設定。變更前請保留已登入的工作階段,避免把自己鎖在機器之外。

從錯誤訊息開始排查,不必反覆重設機器
遇到的狀況 優先檢查 提交工單時請附上
連線逾時 執行個體是否已交付;位址與連接埠是否正確;本機網路或防火牆是否允許對外連線。可換一個網路測試比較。 節點、機器編號、連線方式、錯誤發生時間與時區。
驗證失敗 使用者名稱是否正確;登入資料是否用錯;密碼是否已變更。請勿在記錄或截圖中公開密碼。 完整錯誤訊息、使用的用戶端與驗證方式;請勿附上密碼或私密金鑰。
SSH 可連線,但桌面黑畫面 結束並重新連線圖形工作階段;檢查用戶端是否相容。先不要結束正在執行的建置或測試工作。 用戶端版本、黑畫面截圖、SSH 是否正常,以及近期變更過的系統設定。
主機指紋已變更 是否有已確認的更換機器或重設系統記錄。確認之前,請勿直接刪除本機指紋記錄。 舊指紋與新指紋、機器編號、近期交付通知。
第一天準備

約 4 分鐘,完成開工前基本檢查

以下時間估計適用於環境已交付、儲存庫較小且網路正常的情況,不包括大型專案下載、安裝 Xcode 或編譯相依套件。先檢查再操作;不要為了加快速度而略過安全設定。

  1. 01

    變更密碼並檢查防火牆

    約 1 分鐘

    變更初始密碼並妥善保存登入資料。啟用或確認 macOS 防火牆規則,並確認允許你使用的遠端連線服務;尚未驗證連線前,請勿一次關閉所有入口。

  2. 02

    檢查 Xcode 與命令列工具

    約 2 分鐘

    在圖形介面檢查 Xcode 版本,再執行 xcode-select -p 和 xcodebuild -version。如果專案要求特定版本,請先切換至對應工具鏈,再執行建置。

  3. 03

    下載儲存庫並執行小型工作

    約 1 分鐘

    設定權限最小化的儲存庫存取憑證,然後下載程式碼。先執行小範圍建置或測試,確認相依套件、路徑和寫入權限,再啟動完整工作流程。

完成標準:你可以重新登入、工具鏈版本符合專案需求、程式碼可讀取,且建置輸出目錄可寫入。任何一項未通過,就先停下來處理。

遷移與 CI

先搬資料,再搬工具鏈,最後設定工作流程

分三階段遷移,問題會更容易定位。不要將本機快取、舊架構的二進位相依套件和正在使用的簽署憑證一次整批搬過來。你的主機可以保留穩定的開發環境,但工作權限仍需自行設定。

01 / DATA

資料

使用 rsync 或外接雲端硬碟遷移專案與資源。先確認目標磁碟的可用空間,再按專案、素材和封存檔分批複製。可重新產生的建置產物和快取不必優先遷移。

首次執行 rsync 時,建議加上 --dry-run 預覽;留意來源路徑結尾的斜線會影響複製後的目錄結構。確認目標內容之前,請勿使用會刪除目標檔案的選項。

完成標準:專案目錄結構完整、重要資源可讀取,檔案數量或校驗結果符合預期。

02 / TOOLS

工具鏈

確認 Homebrew、Xcode、SDK 和專案相依套件的版本。Apple Silicon 上的 Homebrew 常見路徑是 /opt/homebrew,請勿直接沿用本機電腦的絕對路徑。

使用專案的鎖定檔重新安裝相依套件。分別確認簽署憑證、對應的私密金鑰和描述檔;圖形介面能使用,不代表無介面的 CI 程序也有簽署權限。

完成標準:版本指令正常、本機建置成功,且憑證與描述檔符合目前專案需求。

03 / CI

CI 設定

註冊 GitHub Actions 或 GitLab Runner 自架執行器。使用專用系統使用者和最小權限權杖,並將執行器標籤與專案工作正確對應。

先執行只讀取程式碼、不進行簽署的驗證工作,再加入測試和發布。檢查執行器程序的 PATH、工作目錄和鑰匙圈存取權限;不要只在互動式終端機中驗證。

完成標準:工作可正常領取、記錄完整,重新啟動執行器後仍能依預期連線。

執行器能存取哪些儲存庫,就能接觸其中的程式碼。請勿讓來源不可信的工作和發布簽署共用同一個執行環境;多人協作也不代表應共用同一個系統帳戶。

Xcode 與簽署

機器上有憑證,程序也必須有權限

簽署錯誤時,先檢查憑證、私密金鑰、描述檔和程序權限這四項。不要反覆匯入同一份檔案,也不要將私密金鑰放入程式碼儲存庫或工單附件。

匯入憑證後,為什麼還是找不到簽署身分?

先在鑰匙圈存取中確認憑證下方是否有對應的私密金鑰。只有憑證檔、沒有私密金鑰,就無法完成簽署。如果使用含私密金鑰的匯出檔,請確認匯出密碼和匯入的目標鑰匙圈,再檢查憑證有效期限。

接著執行 security find-identity -v -p codesigning 查看目前使用者可用的簽署身分。如果命令結果與圖形介面不一致,請優先確認執行使用者和鑰匙圈搜尋清單,不要馬上更換機型。

憑證可用,但建置仍顯示描述檔不相符?

確認專案的 Bundle Identifier、團隊識別碼、建置類型和描述檔有效期限。開發測試與發布可能使用不同描述檔;若要測試裝置,也要確認目標裝置已加入對應設定。

先選定一種明確的建置設定進行驗證。多個 Target 的專案請逐一檢查簽署設定,避免主應用程式與擴充功能使用不同團隊或過期檔案。

終端機可以簽署,為什麼 CI 會失敗?

CI 可能以不同使用者、不同環境變數或無介面工作階段執行。請檢查它實際使用的鑰匙圈是否已解鎖、是否包含簽署身分,以及簽署工具是否獲准存取私密金鑰。

將必要憑證存放在 CI 的受保護機密設定中,不要寫進指令碼。先以執行器使用者執行最小簽署測試,記錄失敗階段;提交工單時只提供已遮蔽敏感資料的錯誤訊息,不要提供鑰匙圈密碼、匯出密碼或私密金鑰。

多人共用一台實體主機,如何隔離權限?

為每位成員建立獨立系統使用者,依職責設定目錄和鑰匙圈權限;自動化工作則使用獨立的執行器使用者。交接時說明目前由誰使用圖形工作階段,避免在他人建置期間切換工具鏈或清理共用目錄。

這些措施能降低操作失誤,但同機使用者仍共用主機的 CPU、記憶體和磁碟。需要嚴格隔離的專案、彼此不信任的工作或穩定的並行發布,應各自使用不同節點。

效能與磁碟

先找出瓶頸,再決定要升級什麼

編譯速度慢不一定是晶片的問題。先在活動監視器檢查記憶體壓力和 CPU,再確認磁碟空間、相依套件下載情況和同時執行的工作數量。使用相同專案與建置設定進行比較。

模擬器和建置快取塞滿磁碟,該先清理哪裡?

先執行 df -h 查看剩餘空間,再於 Xcode 中檢查不再使用的模擬器執行環境和建置封存檔。DerivedData 可以重新產生,但清理後下一次建置需要重建快取;清理正在使用的專案前,請先暫停工作。

使用 xcrun simctl list devices 確認裝置清單;確認不再需要後,使用 xcrun simctl delete unavailable 清理無法使用的裝置。刪除裝置時,模擬器內的測試資料也可能一併遺失,重要資料請先匯出。

什麼時候該加購 +1TB SSD 或 +2TB SSD?

如果專案、多個模擬器執行環境、容器映像和素材都需要長期保留,而且清除可重新產生的快取後仍持續接近磁碟容量上限,就可以考慮擴充。+1TB SSD 每天 $2.2,+2TB SSD 每天 $4.4;其他租用週期的價格請在下單設定中確認。

加大磁碟可解決容量問題,無法取代更大的記憶體。如果同時執行多項工作且記憶體壓力長期偏高,應先減少並行工作,或評估更合適的方案。

建置與推論工作,三種方案怎麼選?

Hold 16 配備 M4、16GB 記憶體和 256GB SSD,適合輕量建置與單一專案 CI。Hold 24 配備 M4、24GB 記憶體和 512GB SSD,適合日常 Xcode 開發、多個模擬器和 UI 測試。

Hold Pro 64 配備 M4 Pro、64GB 記憶體和 2TB SSD,適合大型專案與 MLX 實驗。模型是否能執行仍取決於模型大小、量化方式和上下文需求,不能只憑機型名稱判斷,請實際測試。

Thunderbolt 5 串接適合哪些工作?

適合已擁有多台節點,且軟體工作流程支援跨機協作的情況。此附加服務每台每天 $1.5;設定前請說明參與節點數量、資料交換方式和應用程式需求,讓支援團隊協助確認適用條件。

串接不會自動把多台機器合成一台記憶體更大的 Mac,也不會自動拆分一般建置工作。先確認應用程式支援跨機協作,再決定是否設定。

計費與續租

續租前,先確認訂單與租期

支援按日、週、月、季租用,全部以美元計價。訂單、到期時間、附加服務和付款狀態,請以控制台記錄為準。付款後請回到控制台確認訂單是否已續租,不要只看用戶端提示。

在哪裡確認到期日和續租狀態?

登入控制台查看相應訂閱的到期日、帳單和續租入口,也請留意帳戶電子郵件的到期提醒。確認信箱能正常收信;實際提醒時間以通知為準,不要只靠一次提醒來安排最後一刻續租。

付款完成後,請返回原訂閱確認新的到期日。若帳單已付款,但訂閱時間尚未更新,請提交帳單編號和付款記錄,請勿重複支付同一筆帳單。

續租後,連線資料會變更嗎?

同一個執行個體正常續租時,請繼續使用執行個體詳細資料頁面上的最新連線資訊。續租不代表系統會重設;若有更換機器、重新建立或其他交付變更,請以控制台提供的新連線資料和服務通知為準。

如果已停止租用並進入回收流程,請勿將續租當成資料復原方式。到期前請匯出專案、憑證備份和無法重新取得的資源;磁碟清除後,重新下單也無法還原資料。

支援哪些付款方式?

僅支援 USDT-TRC20 和 Visa/Mastercard/Amex(透過 Stripe),全部以美元(USD)結算。實際可用的付款閘道以後端介面回傳為準。

使用 USDT-TRC20 時,請逐一核對付款頁面的網路、地址和金額;使用信用卡時,依照付款閘道要求完成驗證。查詢付款問題時可提供交易雜湊或帳單編號,請勿提供完整卡號、安全碼或錢包私密金鑰。

想升級方案或調整附加磁碟,要直接下新訂單嗎?

先記下目前的執行個體編號、希望調整的設定,以及工作可暫停的時間,再透過控制台提交工單。是否需要遷移、能否保留原有連線資料,以及何時生效,請在執行前確認。

附加磁碟涉及資料路徑,取消訂閱前請先遷出資料並檢查應用程式設定。不要假設變更會即時完成、自動保留所有資料或自動退款;實際處理方式以訂單規則和確認結果為準。

問題還沒解決?整理好資訊再交接

已有執行個體的問題,請登入控制台提交工單。請寫明機器編號、節點、錯誤發生時間與時區、最近一次正常使用的時間,以及已嘗試的步驟。附上遮蔽敏感資料的記錄,比只寫「連不上」更容易定位問題。

請在控制台工單中查看處理進度。回覆時間取決於問題性質和排查範圍;本頁不保證固定的回覆時間。購買前諮詢、團隊設定或無法登入的問題,請寄信至 support@vpshold.com。