01
首次登入控制台
使用下單時填寫的電子郵件登入控制台，依頁面指示完成登入或開通帳號。進入實例清單後，核對訂單對應的機型、節點和計費週期。
付款完成不代表系統已準備就緒。先查看實例的交付狀態；只有在實例詳細資料中取得連線資訊後，才能開始連線。找不到訂單時，請確認目前使用的電子郵件是否與下單時相同。
登入查看實例
自助指南 · 從連線到執行
找到下一步，
找到下一步，
讓你的雲端 Mac 跑起來。
已取得節點？先連線桌面、變更密碼，再開始建置或推論工作。還沒下單？可以先查看操作需求，再決定要選哪個方案。
輸入關鍵字即可篩選本頁操作說明，也可以直接閱讀。
連線位址與登入資訊請以登入後的實例詳細資料為準。本頁不會顯示可用的登入資訊，也不會執行遠端操作。
先完成這四件事
從首次登入開始
依照下列順序操作。先確認實例和連線資訊，再處理工具鏈；不要把連線問題和建置問題混在一起排查。
02
取得 VNC / SSH 登入資訊
在已就緒實例的詳細資料中查看連線位址、使用者名稱、密碼和連接埠。VNC 和 SSH 請分別使用頁面提供的資訊，不要假設兩種連線使用相同的連接埠。
首次使用 SSH 連線時，請先核對主機資訊，再信任指紋。不要將密碼、私密金鑰或含登入資訊的截圖分享到公開程式碼儲存庫、聊天群組或建置記錄。
依平台查看連線步驟03
檢查 Xcode 與命令列工具
先檢查目前路徑和版本，再決定是否安裝。若專案需要完整的 Xcode，只有命令列工具並不足夠；SDK、模擬器和建置工具版本都必須符合專案需求。
xcode-select -p
xcodebuild -version
xcrun --find clang使用組織核准的安裝套件安裝或切換 Xcode。首次開啟後完成元件初始化，再於終端機重新檢查版本；切換開發者目錄可能需要管理員權限。
檢查結果：路徑、版本、編譯器04
首次登入後變更預設密碼
在 macOS 使用者設定中變更目前使用者的密碼，或在終端機執行 passwd 並依提示變更密碼。請使用專屬的高強度密碼，不要與程式碼託管服務或電子郵件共用。
變更後先保留目前的連線工作階段，再用第二個連線測試新密碼。改用 SSH 公開金鑰前，也要先確認新工作階段可以登入；尚未確認有復原方式前，不要直接關閉原有的驗證方式。
先確認新連線可用，再結束舊工作階段
將工作交給節點執行
整合 CI，先跑通最精簡的流水線
先完成 runner 註冊、確認執行使用者並驗證工具鏈，再調整並行數。以下操作在你的節點上進行，流水線權限由你的程式碼託管平台管理。
GitHub Actions：註冊自架 runner
在儲存庫或組織的 Actions 設定中新增自架 runner，選擇 macOS 和 ARM64。下載與註冊指令請使用該頁面當次產生的內容，別將註冊權杖寫入長期使用的指令碼。
- 1使用建置帳號註冊
使用實際執行建置的 macOS 使用者完成註冊。確認該使用者可以讀取專案目錄，並能存取建置所需的鑰匙圈。
- 2新增專用標籤
例如，為節點設定
osxflow-m4標籤，先將單一測試工作流程指定給該標籤，避免舊 runner 同時接走工作。 - 3驗證後再設為常駐
先以互動模式啟動，確認工作流程執行成功後，再依 runner 隨附的服務說明設定為常駐。重新登入後，檢查程序和平台端的連線狀態。
jobs:
verify:
runs-on: [self-hosted, macOS, ARM64, osxflow-m4]
steps:
- run: |
uname -m
xcodebuild -version
xcrun --find clang不要讓不受信任的外部提交直接使用可存取簽章資料的 runner。測試工作流程通過後，再移轉發布流程和機密變數。
GitLab Runner：選擇 shell executor
使用專案或群組設定中建立的 runner 驗證資訊完成註冊，並選擇 shell做為執行器。這表示工作會直接在節點使用者環境中執行，不具備容器層級的隔離。
先將並行數限制為 1，避免多個簽章工作或快取寫入互相干擾。確認 runner 使用者的 PATH、開發者目錄和 Ruby 環境都與手動測試時一致。
concurrent = 1
[[runners]]
executor = "shell"
shell = "bash"這只是註冊後設定檔中的相關欄位，並非完整的註冊設定。保留註冊工具產生的位址、驗證資訊和其他欄位，不要用這段內容覆寫整個檔案。
為 runner 設定專用標籤，並讓測試工作輸出 whoami、pwd 和 xcode-select -p。若終端機可以建置，但 CI 失敗，請優先比對使用者、路徑和環境變數，而不是重複安裝工具。
Fastlane：將簽章資料與程式碼分開
依團隊授權流程匯入憑證、私密金鑰和描述檔。不要將這些資料放入原始碼儲存庫，也不要在 Fastlane 輸出中列印解密密碼。
- 為 CI 使用專用鑰匙圈，並限制檔案存取權限；建置使用者必須能解鎖並讀取鑰匙圈。
- 透過程式碼託管平台的機密變數傳遞密碼，避免直接將值串接到可能顯示執行內容的指令中。
- 依目前 Xcode 版本的要求放置描述檔，並執行一次最小規模的封存，確認團隊、憑證和設定檔彼此相符。
- 匯出產物後，清除暫存簽章檔案。節點租期結束前，撤銷不再使用的 runner 註冊和存取權杖。
專用實體機不會取代專案權限管理。能修改發布工作流程的人，也可能透過工作存取簽章環境，因此也要一併檢查儲存庫權限。
先驗證，再增加模型規模
使用 MLX 進行一次可重現的推論實驗
Flow M4 Pro 的規格為 M4 Pro / 64GB / 2TB。系統和工作會共同使用統一記憶體，64GB 並非全數都能分配給模型；權重、上下文和執行快取都要預留空間。
建立隔離的 Python 環境
先確認 Python 使用 ARM64 架構，再為每個實驗建立虛擬環境。不要將不同模型專案的相依套件混裝在系統環境中。
python3 -c "import platform; print(platform.machine())"
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install mlx-lm
python -m pip freeze > requirements.lock.txt保存相依套件清單、Python 版本和模型版本。重現實驗時，先使用相同環境安裝，再比較輸出和資源使用量。
目標：獨立環境、可重現的相依套件從小型模型和較短的上下文開始
選擇你有權使用且相容於 MLX 的量化模型，並先閱讀模型說明。記錄量化位元數、上下文長度和生成長度，不要只比較模型檔案大小。
python -m mlx_lm.generate --help依照已安裝版本的說明傳入模型和提示詞。先完成單次推論，再逐步增加上下文；使用活動監視器觀察記憶體壓力和交換空間，若壓力持續升高，就縮小工作規模。
比較實驗時，固定提示詞、生成長度和並行數。不同模型與量化方式的結果不能直接視為節點效能差異。
不預設吞吐量，也不保證模型一定能裝入記憶體將模型檔案與專案分開存放
若需要更多容量，可在下單設定中選擇 +2TB SSD。先在節點上確認實際掛載路徑和可用容量，再將模型權重和下載快取移入；不要假設所有節點使用相同的磁碟區名稱。
移轉前先停止正在讀取模型的工作。複製完成後，核對檔案數量和大小，再變更工具中的模型路徑或快取設定。先確認模型成功載入，再刪除原始副本。
擴充儲存空間不等於備份。請將模型版本、設定和重要結果另存到你能掌控的位置，避免只留在租用節點上。
查看儲存空間擴充方案與價格
先統一用語
八個常見術語，一次說清楚
下單、連線和提交支援單時都會沿用這些定義。描述問題時使用一致的用語，更容易分辨機器、連線協定和計費設定。
- 實體節點
- 承載你所租用服務的實際 Mac 裝置，而非遠端桌面用戶端。使用情境：提交支援單時，附上實例詳細資料中的節點編號，避免只說「那台機器」。
- 專用
- 租用期間，整台裝置供你的工作使用，CPU、GPU 和統一記憶體不會與其他租戶共用。使用情境：安排建置並行工作時，仍須管理自己多個工作之間的資源競爭。
- 非虛擬機
- 你使用的是實體 Mac 上的原生 macOS 環境，而不是共用主機上的虛擬化實例。使用情境：確認專案所需的 Apple Silicon 工具鏈和 macOS 版本。
- VNC
- 一種傳輸桌面畫面與鍵盤、滑鼠輸入的遠端存取協定，適合操作圖形介面。使用情境：首次開啟 Xcode、變更系統設定或檢查活動監視器。
- 螢幕共享
- macOS 提供的遠端桌面連線功能，可依實例提供的資訊連線至節點。使用情境：在本機 Mac 的 Finder 中選擇「連線伺服器」，進入遠端圖形桌面。
- self-hosted runner
- 由你註冊和管理、在自己的節點上執行流水線工作的背景程序。使用情境：讓發布流水線透過專用標籤選取這台雲端 Mac。
- 計費週期
- 下單時選擇的按日、週、月或季預付單位，與單一建置工作的執行時間不同。使用情境：發布工作結束後，仍要留意訂單到期日，並提前匯出資料。
- Thunderbolt 5 並聯
- 依每台裝置計價的多機協作加購項目，不會自動將多台裝置合併成一個統一記憶體空間。使用情境：規劃多節點工作時，先確認應用程式是否支援相應的分散式執行方式。
一次只修改一個變數
常見故障，依照這個順序排查
先記錄原始錯誤訊息，再調整設定。保留一個已連線的工作階段；不要為了測試而關閉唯一可用的存取方式。
VNC 已連線，但畫面一片黑
先確認實例詳細資料顯示系統已就緒，再核對 VNC 位址和連接埠。中斷連線後，只保留一個用戶端重新嘗試，並試著降低解析度或關閉自動調整畫質，以分辨用戶端顯示問題和節點工作階段問題。
若 SSH 仍可連線，請勿立即重新啟動正在執行工作的節點。記錄用戶端名稱、版本、黑畫面出現前的操作，以及 SSH 是否可用；提交支援單時，附上不含登入資訊的截圖。
查看各平台的桌面連線方式SSH 連線遭拒，先看是哪一種錯誤？
Connection refused 優先檢查位址、連接埠和服務狀態；若連線逾時，先檢查本機網路、代理伺服器和存取限制；Permission denied 則優先檢查使用者名稱和驗證方式，不要將驗證失敗誤判為網路故障。
除錯時可使用 ssh -v 查看連線階段。不要公開完整的除錯記錄；分享前請遮蔽位址、使用者名稱、金鑰路徑和驗證相關內容。使用私密金鑰時，請確認檔案權限，以及它是否與伺服器端的公開金鑰相符。
若仍能進入圖形桌面，請先在系統設定中檢查遠端登入狀態。若無法判斷，請附上原始錯誤訊息、節點編號和使用的連接埠提交支援單，不要連續修改多項驗證設定。
Xcode 下載或安裝速度很慢
先判斷目前是在下載、驗證還是解壓縮。觀察網路流量、CPU 和磁碟活動：網路暫時沒有流量，但磁碟仍在忙碌，不一定代表下載中斷。不要重複啟動多個相同的安裝工作。
確認目標磁碟有足夠空間容納安裝套件、解壓縮內容和專案快取。需要固定版本時，請使用組織核准的安裝套件並驗證完整性；安裝後再次執行 xcodebuild -version，確認 CI 與圖形介面使用相同版本。
提交支援單時，請說明 Xcode 版本、目前階段、剩餘空間，以及是否透過代理伺服器存取；不要只寫「很慢」。
磁碟空間不足，先清除快取還是擴充容量？
先查看磁碟區容量，再找出大型目錄。以下指令只會讀取容量，不會刪除檔案；大型使用者目錄的統計可能需要一些時間。
df -h
du -sh "$HOME/Library/Developer/Xcode/DerivedData"
du -sh "$HOME/Library/Caches"暫停建置後，再處理可重新產生的快取。不要整個刪除鑰匙圈、簽章資料、專案原始檔或唯一的模型副本。清除快取後，首次建置通常需要重新產生內容，請將所需時間納入發布安排。
持續增加的模型權重和建置產物，適合預先規劃獨立的儲存空間。可查看 +1TB SSD 和 +2TB SSD 加購項目；若需調整現有訂單，請先透過控制台支援單確認處理方式，不要假設加購後專案會自動移轉。
查看 SSD 加購項目
除了操作步驟，也了解判斷依據
繼續閱讀技術文章
本頁說明「下一步該怎麼做」。建置實務、裝置選擇和資料保護的完整說明，請至技術文章目錄查看；文章標題、摘要和發布日期以目錄中的實際內容為準。
清楚交代問題
仍未解決？提交支援單前，先備妥這三項資訊
已購買服務的使用者，建議先登入控制台提交支援單，方便我們關聯實例。請勿提供密碼、私密金鑰、完整卡號或含登入資訊的截圖。
- 01問題對象
節點編號、訂單編號，以及問題發生的大約時間和時區。若涉及付款，只提供交易識別資訊，不要提供驗證資料。
- 02重現步驟
你執行了什麼、預期結果為何，以及實際看到的內容。連線問題請附上用戶端和版本；建置問題請附上工具鏈版本。
- 03已完成的檢查
附上已遮蔽敏感資訊的原始錯誤訊息，說明圖形桌面或 SSH 哪一種仍可使用，以及是否有不能中斷的執行中工作。