支援中心:SSH 連線與故障排除指南

Quick Start

快速上手:從收到憑證到連線,6 個步驟

下單後平均 4 分鐘,控制台會發送一封含 IP、使用者名稱與初始金鑰的開通信件。依下列順序操作,首次連線通常在 3 分鐘內完成。

保存憑證並設定金鑰權限

下載信件附件中的私鑰 m4rent_ed25519,放入 ~/.ssh/,權限必須是 600,否則 SSH 會拒絕使用。

chmod 600 ~/.ssh/m4rent_ed25519

首次 SSH 登入

請替換成開通信件裡的實際 IP。預設使用者 m4rent 具備 sudo 權限,首次登入會要求確認主機指紋。

ssh -i ~/.ssh/m4rent_ed25519 m4rent@203.0.113.10

修改初始密碼

初始隨機密碼僅用於畫面分享與 sudo。登入後請立即改成自訂的強密碼,再到控制台標記「憑證已輪換」。

passwd

開啟 VNC 通道

畫面分享埠 5900 預設不對公網開放,需透過 SSH 通道轉發到本機後再連線,避免明文暴露。

ssh -i ~/.ssh/m4rent_ed25519 \
  -L 5901:localhost:5900 -N m4rent@203.0.113.10

連接畫面分享

在本機 macOS 開啟「畫面分享」或任一 VNC 客戶端,位址填通道的本機端。帳號為 m4rent,密碼為上一步修改後的密碼。

open vnc://localhost:5901

核對系統與預裝環境

確認 macOS 版本、Xcode 與 Homebrew 是否符合預期;若版本不符,可在控制台一鍵重灌,約 15 分鐘完成。

sw_vers && xcodebuild -version && brew -v

安全基準:所有節點預設關閉 SSH 密碼登入、僅允許金鑰驗證,並已預裝 fail2ban。修改 sshd_config 前請先在控制台建立一次快照,設定錯誤時 5 分鐘內即可回復。

Troubleshooting

連線問題排查對照表

按「症狀 → 定位指令 → 處理方式」三個欄位執行。此表涵蓋工單系統中約 70% 的連線類問題。

症狀	先執行的定位指令	最可能原因與處理方式
SSH 連線逾時	`ping` + `nc -zv IP 22`	本地網路封鎖 22 埠:改用備用埠 2222(所有節點同時監聽)
Permission denied (publickey)	`ssh -v` 查看握手記錄	私鑰權限或路徑錯誤:執行 `chmod 600`,並以 `-i` 明確指定金鑰檔案
WARNING: UNPROTECTED PRIVATE KEY FILE	`ls -l ~/.ssh/m4rent_ed25519`	權限過寬:執行 `chmod 600` 後重試,請勿放在雲端同步資料夾中
VNC 能連上但畫面全黑	SSH 登入後用 `who` 確認連線狀態	沒有活動的圖形工作階段:在控制台點選「喚醒顯示」,或執行 `sudo caffeinate -u -t 5`
VNC 提示密碼錯誤	SSH 登入驗證密碼是否可用	畫面分享用的是系統密碼而非 SSH 金鑰:用 `passwd` 重設後再連線
連線頻繁中斷	`ping -c 20 IP` 觀察封包遺失率	跨區線路不穩:客戶端加上 `ServerAliveInterval 30`,或改用距離較近的節點
REMOTE HOST IDENTIFICATION HAS CHANGED	核對控制台主機詳情頁的指紋	剛完成重灌,指紋已更新:執行 `ssh-keygen -R IP` 清除舊記錄後再連線

排查前請先查看控制台主機詳情頁的電源與網路指示燈:主機處於「重灌中」狀態時,以上所有連線方式都會暫時無法使用,這是正常現象。

System

系統與環境:重灌、切換版本、預裝清單

重灌 macOS

進入控制台 → 主機詳情 →「重新安裝系統」,選好映像檔後確認即可。重灌會格式化整顆磁碟,平均耗時 15 分鐘,完成後會發信通知新的主機指紋與初始密碼。重灌不會改變 IP,也不會額外計費。

重灌前記得先匯出資料或建立快照。

切換系統版本

M4 機型提供 macOS 13 / 14 / 15 三種映像檔;M4 與 M4 Pro 機型受硬體限制,僅提供 macOS 15 起的映像檔。降級到硬體不支援的版本無法透過重灌實現,選型前請先確認目標 Xcode 的系統需求。

查看各機型可選映像檔 →

Xcode 與 Homebrew 預裝

所有映像檔皆預裝 Homebrew、Git 與 Xcode Command Line Tools;「開發者映像檔」額外預裝最近兩個正式版 Xcode(可用 xcode-select -s 切換)。需要舊版本時,可用 xcodes install 自行安裝,機房到映像來源的頻寬為 1Gbps,一個 Xcode 安裝包約 8 分鐘下載完成。

Xcode 授權條款須於首次使用時自行同意。

CI/CD

CI/CD 接入:註冊 self-hosted runner

獨享物理機不做虛擬化,建置快取與模擬器狀態會在任務間保留,iOS 增量建置通常比託管 runner 快 30% 以上。以下為兩大平台的註冊要點。

GitHub Actions

在儲存庫 Settings → Actions → Runners 取得 token 後,SSH 登入主機執行:

mkdir actions-runner && cd actions-runner
curl -o runner.tar.gz -L \
  "$(gh api /repos/OWNER/REPO/actions/runners/downloads \
  --jq '.[]|select(.os=="osx" and .architecture=="arm64").download_url')"
tar xzf runner.tar.gz
./config.sh --url REPO_URL --token YOUR_TOKEN --labels macos,arm64
./svc.sh install && ./svc.sh start

使用 ./svc.sh install 註冊為 LaunchDaemon,重新開機後會自動啟動;
workflow 中設定 runs-on: [self-hosted, macos, arm64];
單機建議並行數維持 1,Xcode 建置吃滿全部核心時,並行反而更慢。

GitLab Runner

用 Homebrew 安裝後,以專案的 registration token 註冊,executor 選 shell:

brew install gitlab-runner
gitlab-runner register \
  --executor shell \
  --url GITLAB_URL --token YOUR_TOKEN \
  --tag-list "macos,arm64"
brew services start gitlab-runner

shell executor 直接沿用主機的 Xcode 與簽署憑證,沒有容器額外開銷;
將 concurrent 保持為 1,並替 job 設定 timeout 以避免卡死;
憑證與 provisioning profile 建議存放於 CI 變數,建置時注入臨時鑰匙鏈。

建置農場規模超過 5 台時,可申請批量價格與統一管理面板,詳情請見企業與批量採購通道。

Billing

計費與帳務規則

帳單週期如何計算?

按日計費從開通時刻起算,每 24 小時為一個計費日;按週 / 月 / 季則為預付整期。同一自然月內,日付累計費用達到對應機型的月付價(例如 M4R M 為 $99)即自動封頂,超出部分不再扣款。帳單與用量明細可在控制台 → 帳務頁面即時查詢。

如何申請發票?

於控制台 → 帳務 →「申請發票」填寫抬頭與稅務編號後提交,電子發票會於 3 個工作日內寄送到帳戶信箱。支援單筆或按自然月合併開立;企業客戶若需紙本發票或合約蓋章文件,請透過企業通道處理。

退款條件是什麼?

按日付費的訂單一經開通即不予退款。按月及以上週期的訂單,開通後 72 小時內可申請全額退款(須未發生濫用行為);超過 72 小時後,依剩餘整月折算退還,已使用月份按月付單價計算。因 M4Rent 端故障導致的服務不可用,將依 SLA 折算代金券補償,不佔用退款額度。

到期後資料會保留多久?

訂單到期後,主機會停機並保留資料 72 小時,期間續費即可原樣恢復;超過 72 小時後將執行整機清除,無法復原。快照會隨主機一併保留,清除時也會同步刪除。重要資料請務必在到期前自行匯出——快照只是輔助手段,不能取代自己的備份。

升級規格如何計算差額?

於控制台發起升級,依目標機型與目前機型的日均價差 × 剩餘天數補繳差額,資料會整機遷移到新主機,遷移過程約 20 分鐘即可重新上線。僅支援向上升級;降級須待到期後重新下單。各方案價格請見方案與價格頁。

Status

服務狀態與近 90 天可用率

即時狀態每 5 分鐘更新一次,詳細事件時間軸請見控制台狀態頁。

節點	區域代碼	目前狀態	近 90 天可用率	監測探針延遲中位數
東京	`JP`	運作正常	99.98%	34 ms
新加坡	`SG`	運作正常	99.97%	68 ms
香港	`HK`	運作正常	99.95%	21 ms
矽谷	`US-W`	運作正常	99.99%	128 ms

可用率以分鐘為單位統計,節點全年 365 天不間斷運行,不安排停機維護。月度可用性目標為 99.9%,賠付規則請見服務條款。延遲數值為全球多地監測探針到該節點的中位數。

SLA

工單與回應時限

30 min

工作日工單首次回應(GMT+8 9:00–24:00)

7×24

嚴重故障通道:主機無法連線、節點級中斷,全天候受理

4 h

硬體故障目標修復時限,含整機更換與資料遷移

等級	定義	首次回應時限	受理時段
P1 嚴重	主機無法連線、節點級網路中斷、資料風險	15 min	7×24
P2 高	效能明顯劣化、單項功能無法使用	30 min	工作時段
P3 一般	使用諮詢、設定協助、帳務問題	2 h	工作時段

提交入口:控制台工單系統(建議使用,可自動關聯主機資訊)或電子郵件 support@m4rent.com。售前與企業採購問題請走聯絡頁的分級通道,回應速度更快。

Docs

本頁沒涵蓋到?知識庫裡還有 80+ 篇文件

登入控制台開啟完整知識庫:逐版本的 Xcode 相容性對照表、各語言執行環境安裝指引、網路與安全強化手冊,全部與產品同步更新。

開啟控制台知識庫立即租用 Mac mini