1. 雲主機
  2. 使用支援
04 Support

SSH 連線、Xcode 建置與 Runner 設定:自助支援文件

先查文件再送工單。連線、簽名、VNC 這三類高頻問題,大多能在本頁 10 分鐘內自行排解;排解不了的,頁尾會教你怎麼送出一張工程師一看就懂的工單。

快速上手

快速上手三步驟

下單後平均 5 分鐘,憑證信件就會送達。照下面三個步驟走,第一次連線不會超過 3 分鐘。

01

收到憑證信件

信件內含節點位址(例如 hk1.oncemini.com)、SSH 連接埠 22、初始帳號 dev、初始密碼與 VNC 密碼。沒收到請先檢查垃圾信件匣,再到控制台的執行個體詳細資料頁確認。

02

SSH 首次登入並修改密碼

執行 ssh -p 22 dev@節點位址,登入後立刻執行 passwd 改掉初始密碼;建議接著用 ssh-copy-id 上傳公開金鑰,再關閉密碼登入。

03

VNC 連線圖形介面

用 macOS 內建的螢幕共享或任何 VNC 用戶端連線至 節點位址:5900,輸入 VNC 密碼即可進入完整的 macOS 桌面。首次配對 Xcode、核准彈出視窗都在這裡完成。

交付當下就含 root 權限:sudo 全程可用,系統層設定隨你調整。改壞了也不用擔心——控制台可自助重灌 macOS,詳見下方指南。
終端實錄

從登入到上傳:一條流程跑到底

下面是一台香港節點 Mini M(M4 / 24GB)上的真實輸出節錄:SSH 登入、Xcode 建置、fastlane 上傳到 App Store Connect。右側指令可直接複製使用。

dev@mini-hk1 — zsh — 96×28 
ssh -p 22 dev@hk1.oncemini.com
Last login: Mon Jul 27 09:12:33 2026 from 203.0.113.24
sw_vers
ProductName:    macOS
ProductVersion: 15.5
BuildVersion:   24F74
xcodebuild -scheme App -configuration Release -destination 'generic/platform=iOS' build
▸ Compiling AppDelegate.swift
▸ Linking App
▸ Signing App.app
** BUILD SUCCEEDED ** [128.4s]
bundle exec fastlane release
[10:24:08] Login to App Store Connect (API key)
[10:26:41] Upload progress: 100%
Successfully uploaded package to App Store Connect
dev@mini-hk1 ~ %

常用指令 · 點擊複製

ssh -p 22 dev@hk1.oncemini.com
passwd
ssh-copy-id -i ~/.ssh/id_ed25519.pub dev@hk1.oncemini.com
sudo xcode-select -s /Applications/Xcode_16.4.app
xcodebuild -scheme App -configuration Release build
security unlock-keychain login.keychain-db

把 hk1 換成你的節點前綴即可,各節點網域名稱請見節點分布。你在本機跑得動的 CI 腳本,搬上來原樣可跑。

使用指南

常見任務指南

四個最常被問到的任務,照步驟操作即可。每篇指南都在真實機器上驗證過。

多版本 Xcode 與切換

  1. 交付映像檔預先安裝兩個穩定版 Xcode,依版本號命名放在 /Applications/Xcode_16.4.app、/Applications/Xcode_15.4.app。
  2. 查看目前啟用的版本:xcodebuild -version。
  3. 全域切換:sudo xcode-select -s /Applications/Xcode_15.4.app。
  4. 在 CI 裡別動全域設定,用環境變數單次指定即可:DEVELOPER_DIR=/Applications/Xcode_16.4.app xcodebuild …。
  5. 需要其他版本(含 beta)請提交工單說明版本號,預裝庫涵蓋 15.0 起的所有正式版,上班時段內通常 2 小時內就會推送到機器上。

設定 GitHub Actions self-hosted runner

  1. 進入儲存庫 Settings → Actions → Runners → New self-hosted runner,系統選 macOS、架構選 ARM64。
  2. 依頁面提供的指令下載並解壓 runner 套件,執行 ./config.sh --url … --token … 完成註冊。
  3. 註冊為常駐服務:./svc.sh install && ./svc.sh start,機器重新開機後 launchd 會自動啟動。
  4. workflow 裡寫上 runs-on: [self-hosted, macOS, ARM64];多台機器建議加自訂 label 區分。
  5. 併發參考值:Mini M(24GB)可穩定跑 2 個併發 job;需要更高併發選 Mini Pro(64GB),詳見租用方案。

掛載實機遠端偵錯

  1. 測試用的 iPhone 與雲端 Mac 不在同一區域網路時,先用 WireGuard 等組網工具把裝置與主機拉進同一網段。
  2. 首次配對在 Xcode 的 Devices and Simulators 視窗完成,透過 VNC 圖形介面操作一次即可。
  3. 配對時勾選網路偵錯,之後 xcodebuild -destination 'platform=iOS,name=裝置名稱' 可直接指定實機。
  4. 只跑單元測試與模擬器 UI 測試不需要實機,交付即可直接使用,不必做任何組網。

重灌 macOS

  1. 登入控制台 → 執行個體詳細資料 → 重灌系統,可選擇 macOS 14 / 15 兩個大版本。
  2. 重灌會清空整個磁碟且無法復原,操作前請先在控制台下載快照。
  3. 全程自助操作,平均 10 分鐘就能回到待登入狀態,新憑證會自動重設並以信件重新寄送。
  4. 不限次數、不額外收費。系統被改壞、想換大版本、退租前想手動清空磁碟,都走這條路。
術語速查

術語小辭典

文件與工單溝通中高頻出現的八個詞彙,統一說法,避免雞同鴨講。

物理機
整台實體 Mac mini 直接交付,作業系統跑在真實硬體上,沒有虛擬化層,效能零折損。
獨佔
一台機器同一時間只屬於一位租戶。CPU、記憶體、SSD、1Gbps 頻寬都不會與任何人分攤。
VNC
遠端圖形介面協定。連上後看到的就是完整的 macOS 桌面,配對裝置、點系統彈出視窗全靠它。
self-hosted runner
註冊在你自己機器上的 CI 執行器。GitHub Actions / GitLab CI 的 macOS 任務由這台 Mac 直接執行,不必排官方佇列。
統一記憶體
Apple Silicon 的 CPU 與 GPU 共用同一塊記憶體池。64GB 機型可直接載入大型量化模型,不受獨立顯示記憶體限制。
Apple Silicon
Apple 自行研發的 ARM 架構晶片(本站為 M4 / M4 Pro)。iOS 實機建置、MLX 與 CoreML 實驗都以它為原生目標。
快照
整個磁碟資料的打包映像檔。可在控制台隨時建立並下載到本機,是重灌、退租、換節點前的一道保險。
SLA
服務可用率承諾,本站為 99.9%。未達標將依規則賠付時長,細則請見安全承諾。
故障排除

故障自查清單

三類問題約占工單總量七成。依順序逐條排查,大多數在第 2、3 步就能找出問題。

SSH 連不上

  1. 到控制台確認執行個體狀態為 running,電源指示正常。
  2. 在本機執行 ping / mtr 測試節點網域名稱,若封包遺失率高先換網路環境,或用節點分布頁的測試 IP 再驗證線路。
  3. 核對連接埠 22 與使用者名稱 dev;執行 ssh -v 查看握手卡在哪一步。
  4. 自己改過 sshd_config 結果被鎖在門外:到控制台強制重新開機,再透過 VNC 進桌面改回設定。
  5. 仍失敗:把 ssh -vvv 的完整輸出貼進工單。

建置簽名發生錯誤

  1. 出現 errSecInternalComponent 或鑰匙圈存取失敗:先執行 security unlock-keychain login.keychain-db。
  2. CI 工作階段預設不會解鎖鑰匙圈,可在腳本開頭加上解鎖指令,或改用 fastlane match 管理憑證。
  3. 確認憑證已匯入:security find-identity -v -p codesigning 應會列出你的簽名身分。
  4. 出現 unsupported SDK 多半是 Xcode 版本不符,依上文指南切換版本後再試一次。

VNC 黑屏

  1. 先試試 SSH——能登入就代表系統正常,只是顯示服務出問題,先別急著重灌。
  2. 透過 SSH 重新啟動螢幕共享服務:sudo launchctl kickstart -k system/com.apple.screensharing。
  3. 解析度過高會導致黑屏或畫面異常,將用戶端降到 1920×1080 再重新連線。
  4. 仍無效則到控制台重新啟動執行個體。主機內建虛擬顯示器,重新開機後畫面即可恢復。
工單支援

工單與回應時效

支援團隊採 UTC+8 與 UTC-8 雙時區輪班。聯絡管道只有兩種:控制台工單與支援信箱,沒有電話與線上即時客服。

控制台工單(首選)

路徑:登入控制台 → 工單 → 新增,選擇關聯的執行個體。工單會自動帶入該執行個體的上下文,處理速度最快。適用情境:執行個體故障、Xcode 版本申請、升降配、重灌協助。

  • 寫清楚執行個體 ID、節點與問題發生的時間點
  • 貼上完整指令與錯誤輸出,用文字別用截圖
  • 列出已依本頁清單排查過的步驟,避免來回追問

支援信箱

登不進控制台、帳務與發票問題、下單前的技術疑問,都可以寄信到 support@oncemini.com。標題請寫清楚主題,信件內文附上註冊信箱,方便關聯帳號。

  • 用註冊信箱寄送,免去身分驗證的往返
  • 更多聯絡情境與寄信範本請見聯絡我們
問題類型 首次回應 服務時段 建議管道
緊急故障(執行個體當機、完全無法連線) 30 分鐘 7×24 控制台工單,標記緊急
一般技術問題(建置、設定、效能) 2 小時 上班時段(UTC+8 / UTC-8 輪班) 控制台工單
帳務、發票與下單前諮詢 1 個工作日 上班時段 support@oncemini.com
運行狀態

運行狀態與通知機制

常見問題

計費與帳務常見問題

連線與建置問題請看上面,這裡回答的是錢與資料相關的問題。價格詳情請見租用方案。

計費從什麼時候開始起算?

從憑證信件送達的那一刻起算,不是下單當下。按天計費以 24 小時為一天,交付平均只需 5 分鐘,這段時間不會計費。

怎麼續租?會自動扣款嗎?

控制台的執行個體詳細資料頁可隨時手動續租,也可以開啟自動續租開關。到期前 72 小時與 24 小時各會寄出一封提醒信件。自動續租若失敗(例如卡片過期),會立即以信件通知,並保留 72 小時緩衝期。

到期沒續租,資料會馬上被刪除嗎?

不會。到期後執行個體會先停止,資料保留 72 小時,期間續租即可原樣恢復。超過 72 小時會執行 APFS 加密磁碟區金鑰銷毀加全碟覆寫,屆時無法復原,完整流程請見安全承諾。

怎麼把舊機器的資料搬到新機器?

兩台機器都還在租期內時,直接機對機同步最快:rsync -avz -e "ssh -p 22" ~/work/ dev@新節點:~/work/,同區節點間的內網速率可以跑滿千兆。也可以先在控制台把快照下載到本機,再還原到新機器上。

支援哪些付款方式?

全站均以美元計價結算。支援 USDT-TRC20 與 Visa / Mastercard / Amex(Stripe),實際方式以控制台結帳頁列出的選項為準。沒有隱藏流量費,帳單金額就是方案標示的價格。

能開發票嗎?

每筆付款都會自動生成 PDF 帳單收據,可在控制台的帳單頁隨時下載。若需要指定公司抬頭或補充稅務編號,請寄信到 support@oncemini.com,1 個工作日內會處理完成。

租用期間想升級規格,怎麼計費?

升級按剩餘週期的價差折算,只補差額不會重複收費。在控制台送出升級申請後,資料會透過快照轉移到新機型,期間舊機仍可正常使用。降級則需等目前週期結束後才能更換。

第一次租用不滿意能退款嗎?

首次交付後 24 小時內可申請全額退款,續租週期不予退款。建議先以按天計費租 $19.9 試用 1 天,實際跑一遍自己的建置腳本後再決定要不要包月。

重灌 macOS 要收費嗎?次數有限制嗎?

免費,不限次數,全程在控制台自助完成,平均 10 分鐘就能搞定。唯一要注意的是:重灌會清空整個磁碟,請務必先下載快照。

一個帳號能租幾台?可以轉租給別人嗎?

一個帳號可同時租用多台機器,團隊常見做法是依專案各租一台,再用 label 區分 runner。轉租、轉賣給第三方違反服務條款,一經查實將終止服務;團隊內部多人共用同一台則不受限制。

$ oncemini ticket new --priority normal

文件沒有涵蓋你的問題?

登入控制台送出工單,上班時段 2 小時內就會有人回覆;還沒有機器的話,先按天租一台試試看。

登入控制台送出工單 查看租用方案與價格