遠端連線備忘

開機後 10 分鐘內
連上你的 Mac

先用 SSH 確認連線正常,再開啟螢幕共享。你使用的是獨享實體 Mac mini,可完整使用 macOS 圖形介面與命令列,適合遠端工作、建置與測試。

此處所說的 10 分鐘,是指連線資訊、用戶端與網路都已準備就緒後的操作目標,不代表訂單交付時間。連線位址、連接埠與驗證方式請以控制台顯示為準。

先選擇連線方式

桌面操作用螢幕共享,自動化工作用 SSH

日常設定可使用圖形介面;編譯、查看記錄與傳輸檔案,建議使用命令列。兩種連線方式各有用途,不必為了每次建置都持續開著桌面。

下表列出服務的預設連接埠,實際連線時請使用控制台提供的連接埠
連線方式適用工作所需連接埠驗證方式與注意事項
macOS 螢幕共享設定 Xcode、操作模擬器、檢查圖形介面與遠端工作VNC 預設 TCP 5900;使用通道時還需要 SSH 連接埠使用提供的系統使用者驗證。桌面連線不能取代 SSH 公鑰驗證。
第三方 VNC 用戶端從 Windows 或 Linux 連線至 macOS 桌面VNC 預設 TCP 5900,或使用用戶端連線至本機通道連接埠用戶端須支援伺服器端的驗證方式。請勿為了解決相容性問題而關閉驗證或開放所有來源。
SSH 命令列執行建置、查看記錄、註冊 runner,以及透過 SFTP 傳輸檔案SSH 預設 TCP 22;對外映射設定請以控制台為準建議使用公鑰登入。首次連線時先核對主機指紋,再確認信任。

先確認連接埠,再檢查用戶端。連線逾時通常應先檢查位址、輸出連線政策與目標連接埠;若已出現驗證提示,通常表示網路路徑已打通,此時應檢查使用者名稱、密碼或金鑰。

依照本機作業系統操作

三種用戶端,同一套檢查流程

先建立 SSH 工作階段,確認執行個體身分與工作目錄,再連線至桌面。以下步驟不需要關閉本機防火牆,也不需要讓雲端 Mac 對所有來源開放連線。

從 macOS 連線

  1. 開啟「終端機」,使用控制台提供的使用者名稱、位址與 SSH 連接埠連線。首次出現指紋提示時,請先核對,不要直接確認。
  2. 需要使用桌面時,開啟「螢幕共享」,輸入執行個體的螢幕共享位址;若使用通道,請改填本機監聽位址與連接埠。
  3. 輸入系統使用者名稱與密碼。進入桌面後,檢查鍵盤配置、顯示解析度與時區,再開啟工作專案。
  4. 結束桌面工作階段前,確認建置記錄已寫入檔案。中斷螢幕共享不代表停止租用,也不代表背景工作已結束。

首次確認:終端機可讀取系統資訊,桌面可開啟 Finder,且專案目錄可寫入。

從 Windows 連線

  1. 在 PowerShell 中檢查 OpenSSH 用戶端是否可用;若公司裝置不允許安裝元件,請先向本機管理員確認。
  2. 使用 SSH 命令確認位址與連接埠。輸入密碼時不會顯示字元,這是正常現象,請勿因此重複貼上。
  3. 安裝支援 macOS 螢幕共享驗證方式的 VNC 用戶端,分別填入主機與連接埠;不同用戶端的位址格式可能不同。
  4. 建議透過 SSH 通道連線至桌面。若交握失敗,先確認驗證方式是否相容,再檢查服務狀態,請勿反覆猜測密碼。

首次確認:可建立 SSH 工作階段,VNC 驗證成功,且快捷鍵對應符合日常操作需求。

從 Linux 連線

  1. 使用 Linux 發行版提供的 OpenSSH 用戶端;檢查本機金鑰權限,確保私鑰不會開放給其他使用者。
  2. 依照提供的連線資訊使用 SSH。需要傳輸專案或產出檔案時,可使用同一個 SSH 入口透過 SFTP 傳輸。
  3. 選用支援伺服器端驗證方式的 VNC 用戶端,優先連線至 SSH 轉發的本機連接埠,而非直接將桌面服務對外開放。
  4. 首次進入桌面後,檢查剪貼簿與輸入法。大量傳輸檔案請使用 SFTP,不要把桌面剪貼簿當成專案同步工具。

首次確認:金鑰驗證成功、SFTP 可存取目標目錄,且桌面輸入與顯示正常。

SSH 與桌面通道命令

先在本機終端機設定變數:SSH_USER 是系統使用者名稱,SSH_HOST 是執行個體位址,SSH_PORT 是控制台提供的 SSH 連接埠。請勿將密碼寫入命令或指令碼。

ssh -p "$SSH_PORT" "$SSH_USER@$SSH_HOST"

ssh -N -o ExitOnForwardFailure=yes \
  -L 127.0.0.1:15900:127.0.0.1:5900 \
  -p "$SSH_PORT" "$SSH_USER@$SSH_HOST"

只有在遠端螢幕共享服務監聽本機 TCP 5900,且允許 SSH 轉送時,才能使用第二個命令。保持終端機執行,再讓 VNC 用戶端連線至 127.0.0.1:15900。這是本機連接埠,不是執行個體的公網連接埠;若此連接埠已被使用,可改用其他未占用的本機連接埠。

先確保操作順暢

降低畫面負載,比盲目提高頻寬更有效

遠端桌面體驗會受到往返延遲、封包遺失、畫面變化量與用戶端編碼能力影響。以下設定適合作為起點,不代表節點測速結果或頻寬保證;請以本機網路的實際測試結果為準。

先用較低解析度建立穩定工作階段,再逐步提高畫質
網路與工作類型起始解析度畫質與色深調整方式
行動網路或跨境網路不穩1280 × 720優先使用自動調整壓縮;若用戶端支援,可試用 16 位元色彩關閉桌面動態效果,暫停大型檔案同步,先觀察操作是否跟手。
穩定寬頻,處理程式碼與文件1920 × 1080先使用自動畫質;若文字不夠清晰,再提高畫質每次只調整一項設定,比較捲動畫面、拖曳視窗與鍵盤輸入的反應。
檢查介面與處理圖片從 1920 × 1080 開始需要呈現色彩細節時,可使用 24 位元或更高色深,視用戶端支援度而定檢查縮放與壓縮失真;最終影像品質請以匯出的檔案為準。

桌面適合操作,不適合判斷即時影音效果

影片預覽、快速動畫與高影格率操作會增加畫面變化量。影音素材可在遠端轉檔,但最終成品應下載至本機檢查;請勿將遠端桌面掉格誤認為匯出檔案有問題。

建議順序:降低解析度 → 開啟自動畫質 → 檢查封包遺失 → 再調整色深。

建置與傳輸不必依賴桌面持續開啟

長時間建置請使用 runner 或可管理的背景工作,並將記錄儲存為檔案。專案與產出檔案請透過 SFTP 傳輸;中斷桌面連線後,工作是否繼續取決於啟動方式,不要假設所有終端機命令都會持續執行。

需要長時間遠端工作時,先完成一個完整工作流程的測試,再決定長期租用方案。

真機測試須知

能開啟模擬器,不代表找得到你手邊的手機

雲端 Mac 的實體資源獨享,與行動裝置能否透過網路連線,是兩回事。Xcode、模擬器與建置工作可在遠端執行;要連接本機 iPhone 或 iPad,還必須符合裝置配對、信任與網路探索等條件。

方式一:先完成遠端模擬器測試

在雲端 Mac 上開啟專案,確認 Xcode、SDK 與專案設定相符,再執行模擬器測試介面、邏輯與基本回歸。適合先排除編譯與執行環境問題。

模擬器無法取代真實裝置的相機、感測器、行動網路、效能與溫度測試。需要這些功能時,請另行安排真機測試。

交付內容:可重現的建置記錄、測試記錄與模擬器執行結果。

方式二:確認裝置網路除錯條件

網路除錯通常需要先完成裝置與目標 Mac 的配對,並符合相應的 Xcode 與作業系統版本要求。裝置與 Mac 也必須能彼此探索,或透過已驗證的網路路徑通訊。

SSH 通道不會自動解決裝置探索、首次配對與信任問題。即使公網位址可連線,也不代表能直接進行無線真機除錯。

下單前請確認:配對方式、網路拓撲、裝置作業系統版本與實際操作權限。

遠端裝置連線需要另外確認可行性。USB 轉送或其他遠端裝置方案會受到協定相容性、驅動程式、裝置重新連線與網路品質影響,不屬於預設交付功能,也不包含手機裝置。若必須讓本機裝置連接雲端 Xcode,請先將裝置型號、作業系統版本、配對方式與測試目的提供給團隊;確認可行後再安排正式工作。若只需驗證安裝套件,可將已簽署的產出交由測試人員在本機裝置上測試,不必持續維持遠端除錯工作階段。

連線成功後,接著完成

先收緊存取權限,再放入專案與金鑰

獨享實體主機可避免與其他租用者共用運算資源,但不能取代帳戶安全措施。完成以下 3 項後,再部署建置憑證、程式碼與自動化驗證資訊。

  1. 啟用公鑰登入

    在可信任的本機裝置上產生金鑰,並將公鑰加入遠端相應使用者的授權檔案。私鑰留在本機,不要上傳至主機或支援單。另開一個終端機,確認公鑰登入成功;保留原有工作階段作為復原入口,再調整密碼驗證設定。

  2. 更換提供的初始密碼

    首次登入後更換系統密碼,並儲存於可信任的密碼管理工具。請勿將密碼寫入 runner 設定、命令歷史或專案儲存庫。團隊協作時應為每位成員分配可追蹤的存取身分,避免多人長期共用同一組連線資訊。

  3. 只開放必要連接埠

    僅保留實際使用的 SSH 與桌面連線方式;可使用通道時,優先採用通道。變更防火牆或存取規則前,先確認目前的管理入口,並準備復原方式。請勿為了排查連線問題而一次關閉所有防護。

遇到問題時,支援單應提供哪些資訊?

請提供執行個體識別碼、用戶端作業系統與版本、連線方式、發生時間與時區、完整錯誤訊息,以及具體狀況(例如「逾時」、「拒絕連線」或「驗證失敗」)。可附上已遮蔽敏感資訊的畫面截圖,請勿附上密碼、私鑰或完整連線資訊。

連線前檢查

備妥 4 項資訊,再首次登入

依序確認各項資訊。若有缺漏,先補齊再連線,避免反覆嘗試浪費時間;若公司網路不允許必要的輸出連線,請先申請調整存取政策。

  • 已安全儲存連線資訊:
    已從控制台確認執行個體位址、系統使用者名稱、驗證資訊與實際連接埠,並將資訊存放在安全的位置。
  • 已安裝用戶端:
    命令列可執行 SSH;若需要圖形介面,已備妥相容的螢幕共享或 VNC 用戶端。
  • 已上傳並驗證公鑰:
    使用公鑰驗證時,公鑰已加入正確使用者的帳戶,並已透過新的工作階段確認登入成功;私鑰仍只保留在本機。
  • 本機網路允許輸出連線:
    已確認實際 SSH 連接埠;直接連線至桌面時,也已確認 VNC 連接埠;使用通道時,則已檢查本機監聽連接埠。

首次連線確認完成後,記錄用戶端版本、連線方式與有效設定。團隊下一位成員可沿用操作步驟,但不應直接複製你的私人金鑰或密碼。

確認連線方式後,再開始移轉工作。

先測試桌面、命令列與實際工作需求。準備開始租用時,依工作負載選擇方案;已有執行個體,則直接在控制台查看連線資訊。