從首次連線開始

先跑通上機流程，
再讓工作流程穩定運作。

依實際操作順序整理獨享實體 Mac mini 的使用方式。先核對交付資訊，再連線至系統、設定工具，最後安排建置、備份與續租。不必一次讀完，依目前要處理的工作查找即可。

立即租用雲端 Mac 開啟控制台

已有實例：在控制台查看交付資訊與訂單狀態。需要協助：登入後提交工單，請勿在公開內容中貼上密碼、私鑰或簽署材料。

先連線，再設定

首次使用的四項檢查

每個步驟都有明確的完成條件。先在互動式工作階段驗證，再將相同設定交給自動化工作。

01核對交付資訊

收到憑證後首次登入

確認訂單、機器與連線資訊彼此相符。先驗證一台機器，避免把其他節點的位址填進用戶端。

展開操作步驟
  1. 登入控制台，開啟對應訂單的實例詳細資料。確認機型、節點、租期與目前交付狀態。
  2. 記下連線位址、登入使用者名稱與實際連接埠。以控制台提供的交付資訊為準，不要從轉寄郵件或聊天紀錄拼湊。
  3. 首次連線後更改登入密碼，執行 sw_vers 確認系統版本，再執行 df -h 查看磁碟剩餘空間。
  4. 記錄專案目錄、成果目錄與負責人。團隊共用時，請勿將同一組憑證直接提交至程式碼儲存庫。

完成條件：能夠重新連線、系統資訊與訂單相符，並且知道建置成果儲存的位置。若已付款但尚未收到憑證，請在訂單內提交工單，不要重複建立訂單。

02遠端連線

設定螢幕共享與 SSH 公鑰

圖形介面適合首次設定與互動式除錯；SSH 適合執行指令、傳輸檔案與自動化工作。

展開操作步驟
  1. 使用交付資訊連線螢幕共享。在系統設定中檢查「一般 → 共享」，只允許需要使用的帳號存取。
  2. 需要使用命令列時，檢查「遠端登入」。在本機產生或選用現有 SSH 金鑰，只將公鑰上傳至遠端。
  3. 將公鑰附加至目標使用者的 ~/.ssh/authorized_keys，將目錄權限設為 700、檔案權限設為 600。
  4. 保留目前的工作階段，另開終端機確認公鑰登入成功，再調整驗證方式。私鑰務必留在本機或團隊的金鑰管理系統中。

完成條件：圖形工作階段可正常連線，SSH 公鑰也能在新工作階段通過驗證。請依實際交付資訊確認連接埠與防火牆設定。

查看各系統的連線說明
03確認工具

安裝並確認 Xcode 命令列工具

先確認目前環境符合專案需求，不要因為系統已有 Xcode 就直接升級。

展開操作步驟
  1. 使用 xcodebuild -version 和 xcode-select -p 檢查版本與開發工具路徑。
  2. 若未安裝命令列工具，執行 xcode-select --install。完整建置需要符合專案需求的 Xcode，命令列工具無法取代所有 SDK。
  3. 若同時安裝多個 Xcode，使用 DEVELOPER_DIR 為單次工作指定開發工具目錄，或使用 xcode-select 切換系統選用的版本。
  4. 確認工具使用授權並安裝首次啟動所需元件，再編譯並測試一個小型專案。

完成條件：終端機與 CI 日誌中的 Xcode 版本一致，且看得到目標 SDK。將版本寫入專案設定或 runner 啟動環境，不要仰賴操作人員記憶。

04設定自動化

在 Mac mini server 註冊自架 runner

先成功手動建置一次，再交由 runner 執行工作。各 CI 平台的註冊指令請以專案後台為準。

展開操作步驟
  1. 建立專用建置使用者與工作目錄，並從 CI 專案設定取得適用於 macOS 與 Apple Silicon 的 runner 安裝套件。
  2. 使用短效註冊權杖完成綁定。標籤中註明系統、晶片、節點與用途；不要將長期存取權杖寫入儲存庫。
  3. 先以背景程序執行一項最小工作，檢查 PATH、Xcode 路徑、鑰匙圈存取與成果上傳。
  4. 確認無人值守執行所需的權限後，再依 CI 平台說明設定服務。涉及圖形操作的工作，應另外確認工作階段需求。

完成條件：提交一項測試變更即可觸發工作、日誌能找到對應實例，且成果儲存在機器之外。獨享整台機器不代表工作可以無限並行；先逐一驗證，再依記憶體與磁碟使用量調整並行數。

讓流程可重現

建置、簽署與快取

Unity、Flutter 或原生專案都應保留工具版本、相依套件鎖定檔與建置指令。簽署材料與可重新產生的快取應分開管理。

Unity iOS 雲端建置流程

將 Unity 專案匯出與 Xcode Archive 拆成兩個可獨立驗證的階段，失敗時才能確認問題出在哪個步驟。

展開操作步驟
  1. 固定 Unity 編輯器版本、套件相依項目與 iOS 建置支援模組。先確認專案的授權需求，避免將授權問題誤判為機器故障。
  2. 同步專案後匯出 Xcode 專案。將產生的目錄與原始碼目錄分開，保留匯出日誌與本次提交的識別碼。
  3. 安裝專案所需的原生相依項目，確認 scheme、目標裝置類型、Bundle Identifier 與簽署設定。
  4. 執行 Archive，確認匯出成果後，再透過團隊既有的發佈流程上傳。不要把「編譯成功」當成「已完成發佈」。

建議保存：提交識別碼、工具版本、匯出日誌、Archive 日誌與成果校驗值。重試前先處理第一個錯誤，不要只截取日誌末尾的通用失敗訊息。

移轉 Xcode 憑證與描述檔

建置簽署需要憑證、對應的私鑰與有效描述檔。通常只複製憑證檔案並不足以完成簽署。

展開操作步驟
  1. 從團隊控管的位置準備包含私鑰的簽署材料，並使用加密傳輸。透過另一個安全管道提供匯出密碼。
  2. 匯入建置使用者可存取的鑰匙圈，確認憑證仍有效且與私鑰相符。可使用 security find-identity -v -p codesigning 檢查可用的簽署身分。
  3. 匯入符合目標 App、團隊與發佈方式的描述檔，確認 Bundle Identifier、有效期限與所需功能。
  4. 以與 runner 相同的使用者和執行方式測試簽署，確認無人值守工作不會卡在權限提示上。

安全注意事項：不要在日誌中輸出匯出密碼、私鑰或完整簽署檔案。輪替或撤銷材料時，同步更新建置設定；租期結束前清除機器上的敏感材料，並在團隊端保留安全備份。

將建置快取移至加裝的 SSD

+1TB SSD 適合集中存放可重新產生的快取與中間成果。修改建置腳本前，先確認實際掛載路徑。

展開操作步驟
  1. 執行 df -h 確認加裝 SSD 的掛載位置與可用空間，為專案建立獨立目錄，避免多項工作共用同一份可寫入快取。
  2. 將 Xcode DerivedData 指向專用快取目錄。Unity Library 快取則依專案、編輯器版本與相依項目狀態區分。
  3. 將快取、Archive 與匯出套件分別存放。透過 SFTP 或團隊儲存空間傳回成果後，再依保留政策清理。
  4. 重新啟動或連線後，檢查掛載狀態。若路徑無法使用，應讓工作明確失敗，不要靜默改寫至系統磁碟，直到空間用盡。

容量評估：分別估算工作副本、相依項目、快取、並行工作與成果所需空間。機器歸還時，加裝的 SSD 也會一併清除，並非租期結束後仍可存取的備份磁碟。

先確認容量足夠，再測試速度

24GB 規格的本機推論準備

GNU Studio M4 配備 M4、24GB RAM 與 512GB SSD。模型檔案大小不等於推論時的總記憶體用量；量化方式、上下文長度與並行請求都會影響需求。

建立可重現的 MLX 推論環境

先用小型模型完成載入與輸出驗證，再調整上下文或並行數。不要一開始就讓服務程序承受最高負載。

展開操作步驟
  1. 確認相依項目支援目前的 macOS、Python 與 Apple Silicon 環境。為每項實驗建立獨立的虛擬環境。
  2. 安裝專案所需的相依項目並記錄版本，保留相依項目鎖定檔。固定模型版本與量化格式，避免兩次測試使用不同權重。
  3. 先以單一請求和較短上下文載入模型，記錄程序記憶體用量、記憶體壓力與交換空間變化，再逐步增加輸入長度。
  4. 比較結果時，固定提示詞、生成長度與預熱條件，並分別記錄首次載入與後續生成。

完成條件：使用相同設定即可重複載入模型並產生結果。需要增加並行數時，先觀察資源使用狀況，不要只憑磁碟檔案大小推估可處理的請求數。

規劃模型檔案與磁碟用量

將模型權重、下載快取、轉換副本與實驗輸出分開存放。保留多種量化版本時，磁碟用量會累加。

展開操作步驟
  1. 下載前先查看模型儲存庫中的實際檔案大小。磁碟預算至少應涵蓋原始檔案、量化或轉換輸出、下載暫存檔與執行日誌。
  2. 將模型目錄與 Python 環境分開；使用加裝 SSD 時，將模型快取路徑明確寫入啟動設定。
  3. 使用 du -sh 檢查目錄用量，使用 df -h 檢查所在磁碟區的剩餘空間。這兩個指令查看的內容不同。
  4. 為下載失敗與轉換程序預留暫存空間。刪除舊模型前，先確認沒有執行中的工作仍在使用該目錄。

選擇須知：+1TB 或 +2TB SSD 增加的是儲存空間，不會增加統一記憶體。歸還前匯出實驗設定、結果與需要保留的權重，不要把唯一副本留在實例中。

將到期日納入排程

續租、升級與付款

請以控制台訂單顯示的計費週期、到期日與付款狀態為準。實例全年 365 天持續運作；專案排程仍應預留備份與移轉時間。

續租與到期前檢查

可選擇按天、週、月或季租用。不要把已開始付款當成續租完成。

展開操作步驟
  1. 在控制台開啟對應訂單，核對實例與到期日，確認剩餘租期涵蓋正在執行的建置或實驗。
  2. 透過控制台提供的續租入口確認週期與金額。若目前訂單沒有可用的操作選項，請提交工單確認處理方式。
  3. 付款後檢查訂單狀態與新的到期日。若資訊尚未更新，請保留訂單編號與付款憑證，透過工單查詢。
  4. 計畫退租時，先停止新增工作，匯出成果與設定，再確認本機或團隊儲存空間中的副本可以開啟。

注意：不要假設有自動續租或到期後固定的寬限期。機器歸還後會清除資料，加裝的 SSD 也會一併處理；重要資料應在租期結束前完成移出。

升級規格與加購項目

分別評估記憶體與磁碟需求。更換機型前，先安排資料與建置環境的移轉。

展開操作步驟
  1. 記錄目前工作負載的記憶體壓力、磁碟剩餘空間與失敗狀況。快取過大不代表需要升級記憶體規格。
  2. 需要升級規格時，透過控制台工單提供目前的訂單編號、目標規格與移轉需求，並先確認處理方式與費用。
  3. 需要 +1TB SSD、+2TB SSD 或 Thunderbolt 5 並聯時，請確認控制台提供的選項與報價。並聯方案應先說明設備數量、軟體用途與資料交換方式。
  4. 設定變更後，重新確認掛載路徑、權限、runner 標籤與工作路由，再恢復正式工作。

注意事項：加裝儲存空間不會增加記憶體容量；Thunderbolt 5 並聯不會自動合併各台機器的記憶體，也不保證任何軟體都能自動分配工作。

查看兩種機型與加購項目的價格

完成付款並確認入帳狀態

僅支援 USDT-TRC20，以及透過 Stripe 處理的 Visa／Mastercard／Amex，所有款項均以美元（USD）結算。

展開操作步驟
  1. 在訂單中確認機型、節點、週期、加購項目與應付金額。實際可用的付款閘道以介面回傳資訊為準。
  2. 使用 USDT-TRC20 付款時，請依目前付款頁面顯示的網路、收款資訊與金額操作，不要沿用舊截圖中的地址。
  3. 使用信用卡時，透過 Stripe 付款流程完成卡片驗證，再返回控制台確認訂單狀態。
  4. 若付款狀態尚未確認，先記下付款時間、訂單編號與交易識別碼，再提交工單查詢，避免在原因不明時重複付款。

付款證明：鏈上付款可提供交易雜湊值；信用卡付款可提供付款收據。請勿傳送完整卡號、安全碼、密碼或私鑰。

取得帳單與申請帳務文件

先從特定訂單找到付款紀錄，再提出文件需求，比只傳送扣款截圖更方便核對。

展開操作步驟
  1. 在控制台的帳單與訂單紀錄中找到對應付款，確認金額、幣別、週期與訂單編號。
  2. 保存可取得的帳單或付款收據。若需要發票或其他帳務文件，請在控制台工單中註明用途與所需欄位。
  3. 提交抬頭等必要資料前，請先確認拼寫，避免在工單附件中夾帶無關個人資料。
  4. 團隊核對後會回覆文件類型、開立方式與處理結果；付款閘道的收據不一定能作為所有用途的發票。

非訂單相關諮詢：可寄送電子郵件至 support@gnumac.com。已有訂單的帳務問題，建議優先透過工單處理，以保留完整紀錄。

完整工作流程紀錄

繼續閱讀：從操作步驟到專案實作

本指南協助您快速找到目前要執行的操作。專案實作與技術紀錄集中收錄於部落格，文章發佈後可從文章列表查看。

查看技術文章列表
保留現場資訊，逐步排查

無法連線或磁碟警告，先檢查這三項

先分辨網路無法連線、驗證失敗與應用程式錯誤。記錄原始錯誤、發生時間與已嘗試的操作，避免重複修改設定。

無法連線螢幕共享

位址無法連線、驗證遭拒與連線後出現黑畫面是不同問題。未確認原因前，不要反覆重新啟動實例。

展開排查步驟
  1. 從控制台重新確認位址、連接埠與使用者名稱，並確認用戶端沒有沿用其他實例的舊設定。
  2. 檢查本機網路是否允許對外連線。也可在經允許的其他網路環境中重新測試，判斷是否受到本機政策限制。
  3. 若 SSH 可用，請檢查螢幕共享設定與允許存取的使用者。若兩種方式都無法連線，請記錄各自的錯誤後提交工單。
  4. 若已連線但畫面異常，請降低解析度與畫質，並記錄用戶端名稱、版本與問題截圖。

工單請附上：訂單編號、錯誤發生時間與時區、用戶端、完整錯誤訊息，以及是否能透過 SSH 連線。截圖請遮蔽憑證。

SSH 逾時或驗證失敗

連線逾時通常與位址、連接埠或網路路徑有關；驗證失敗則先檢查使用者名稱、公鑰與權限。

展開排查步驟
  1. 使用交付資訊中的實際連接埠連線，不要預設為標準連接埠。使用 ssh -vv 查看失敗發生於連線、協商或驗證階段。
  2. 逾時時請確認本機對外連線限制與實例狀態；若出現「拒絕連線」，請檢查遠端登入服務是否已啟用。
  3. 若出現 Permission denied ，請檢查目標使用者、公鑰內容與檔案權限，並確認本機選用的是正確私鑰。
  4. 若主機指紋變更，先在控制台確認是否曾重新安裝系統或更換機器。確認原因後再更新本機紀錄，不要直接忽略安全警告。

工單請附上：已遮蔽敏感資訊的連線指令、錯誤訊息末段、發生時間與時區。請勿傳送私鑰內容或密碼。

磁碟空間警告

先停止仍在持續寫入的大型工作，再找出空間用量來源。不要直接刪除系統目錄或其他工作正在使用的檔案。

展開排查步驟
  1. 執行 df -h 找出空間不足的磁碟區，區分系統磁碟與加裝的 SSD，不要只看 Finder 顯示的總容量。
  2. 使用 du -sh 檢查專案、建置快取、模型下載與成果目錄的用量，並確認目前是否仍有工作正在寫入。
  3. 先移出需要保留的成果，再清除可重新產生的快取與失敗下載的暫存檔，並檢查日誌輪替是否正常。
  4. 清理後重新確認剩餘空間，再恢復一項工作並觀察寫入量。若長期空間不足，請評估加裝 SSD，不要反覆刪除同一批必要資料。

工單請附上：訂單編號、相關磁碟區的容量輸出、用量最大的目錄與近期工作變化。請勿上傳包含敏感檔名的完整目錄清單。

提交工單前，整理一份可重現問題的紀錄

  • 問題定位：訂單編號、實例、節點，以及問題發生的時間與時區。
  • 問題現象：預期結果、實際結果，以及問題是首次發生還是每次都會發生。
  • 佐證資料：最簡短的重現步驟、已遮蔽敏感資訊的日誌，以及已嘗試的排查操作。

已有訂單的問題，請在控制台提交工單。購買前諮詢或無法登入帳戶時，可寄送電子郵件至 support@gnumac.com。請勿提交密碼、私鑰、完整信用卡資料或簽署材料。

登入並提交工單 查看聯絡方式

確認流程後，再開始租用。

選擇機型、節點與租期，並準備好專案設定與備份路徑。已有實例的問題，請直接在控制台訂單中接續處理。

開始租用雲端 Mac 前往控制台