VNC 圖形桌面
適合首次設定、檢視 Xcode 介面、確認建置結果，以及需要使用滑鼠的工作。Windows 和 Linux 使用者可優先從這裡開始。
需要：相容的 VNC 用戶端，以及控制台提供的桌面地址、連接埠與驗證資訊。連線時請留意用戶端顯示的加密方式提示。
需要查看 macOS 桌面時選用
先連上，再調順
取得憑證後，用三種方式連線 M4
檢視桌面可用 VNC；在 Mac 上也可使用系統螢幕共享。執行命令、傳送檔案或連接 CI，則可使用 SSH。先到控制台取得目前節點的連線資訊，再依照電腦作業系統操作。
已下單？本頁不會要求你輸入密碼。連線地址、連接埠與使用者名稱，請以登入後實例詳情頁顯示的資訊為準。
先選一種連線方式，不必三種都安裝
圖形桌面用於互動操作，命令列則適合自動化。兩者連線到同一台專屬實體機，不會另外建立虛擬機器。
macOS 螢幕共享
適合本機使用 Mac 的使用者。透過 Finder 開啟系統內建的連線功能，不必先安裝其他桌面用戶端。
需要：控制台提供的 VNC 連線資訊。macOS 螢幕共享與第三方用戶端的驗證提示可能不同，請依實際畫面輸入。
Mac 內建的快速連線方式SSH 命令列
適合 Git 操作、安裝相依套件、同步檔案及 self-hosted runner。背景建置不需要持續傳送桌面畫面。
需要：SSH 地址、使用者名稱、連接埠，以及密碼或金鑰。首次連線時先驗證主機指紋，成功後再設定金鑰登入。
自動化與低頻寬工作首選依照你的作業系統完成首次連線
以下畫面僅示意操作位置，不含實際地址、帳戶或密碼。不同作業系統版本的按鈕名稱可能略有不同，欄位內容一律以控制台資訊為準。
macOS：Finder → 連接伺服器
使用系統螢幕共享，從輸入地址到連上桌面。
-
01
取得桌面地址
登入控制台，開啟目標實例的詳細資料。複製 VNC 地址與連接埠，並記下對應的驗證方式。請勿將 SSH 連接埠填入桌面連線欄位。
操作位置示意 · 實例連線資訊 - 圖形桌面
- 複製 VNC 地址與連接埠
- 驗證
- 查看桌面連線說明
-
02
開啟系統連線功能
在 Finder 選擇「前往」→「連接伺服器」，或按下 ⌘ + K。輸入
vnc://地址:端口格式的地址；如果控制台已提供完整連線地址，直接使用，不要重複加上前綴。操作位置示意 · 連接伺服器 - 伺服器地址
vnc://地址:端口- 下一步
- 選擇「連線」
-
03
驗證並確認桌面
依提示輸入桌面驗證資訊。如果接著出現 macOS 登入畫面，再輸入系統使用者名稱與密碼。看到桌面後，先開啟一般應用程式，測試滑鼠和鍵盤是否正常，再調整解析度。
操作位置示意 · 登入後檢查 - 桌面驗證
- 依連線提示輸入
- 系統登入
- 視需要輸入節點帳戶
- 完成標準
- 能開啟應用程式並輸入文字
Windows：RealVNC / TigerVNC
使用符合節點驗證方式的 VNC 用戶端，不必為連線另外建立遠端裝置帳戶。
-
01
準備用戶端
安裝 RealVNC Viewer 或 TigerVNC Viewer，並確認用戶端版本支援目前的系統。返回控制台取得實例連線資訊，請勿將本指南中的示意內容當成實際憑證。
操作位置示意 · 準備用戶端 - 應用程式類型
- VNC Viewer
- 所需資訊
- 地址、連接埠、驗證方式
-
02
填寫連線目標
在地址欄或新增連線中填入目標。RealVNC 常用
地址:端口；TigerVNC 使用明確指定的 TCP 連接埠時，常用地址::端口。請依用戶端欄位說明填寫，避免把連接埠誤認為顯示編號。操作位置示意 · 新增 VNC 連線 - 目標地址
- 目前實例的主機地址
- 連接埠
- 使用控制台顯示的值
- 連線名稱
- 可自行命名，請勿填入密碼
-
03
登入並測試輸入
確認目標地址正確後再輸入驗證資訊。如果出現連線未加密的提示，請勿忽略；先核對節點連線說明，必要時使用 SSH 通道。進入桌面後，測試字母、符號和快速鍵對應是否正常。
操作位置示意 · 首次桌面檢查 - 安全提示
- 確認加密與驗證方式
- 輸入測試
- 檢查 Ctrl、Alt 與 Command 對應
Linux：Remmina
使用連線設定儲存地址與顯示偏好；是否儲存密碼，請依本機裝置的安全政策決定。
-
01
新增連線設定
安裝 Remmina 和對應的 VNC 協定外掛程式，然後新增連線。如果協定清單中沒有 VNC，請先確認外掛程式是否已完整安裝，不要改用 RDP 連線到同一個地址。
操作位置示意 · 連線設定 - 協定
- VNC
- 設定名稱
- 依專案或節點用途命名
-
02
填寫地址與驗證資訊
在伺服器欄位填入控制台提供的地址與連接埠。依節點連線說明選擇驗證方式；如果只需要 VNC 密碼，請勿將系統使用者名稱填入不相關欄位。
操作位置示意 · 伺服器與驗證 - 伺服器
- 節點地址與明確指定的連接埠
- 驗證欄位
- 只填寫連線說明要求的項目
-
03
連線後儲存偏好設定
先使用預設畫質登入一次，再調整縮放、色深或剪貼簿設定。如果本機已啟用遠端連線快速鍵攔截，請確認如何釋放按鍵，避免進入全螢幕後無法切回本機。
操作位置示意 · 顯示與互動 - 首次連線
- 先使用預設設定
- 後續調整
- 縮放、色深、快速鍵攔截
先降低畫面負載，再確認節點距離
遠端桌面效能會受到往返延遲、頻寬、封包遺失與編碼負載影響。以下是初步建議，不代表效能保證；每次只調整一個項目，用同一個視窗的拖曳或輸入操作比較前後差異。
| 工作類型 | 建議起始解析度 | 色深與壓縮 | 檢查重點 |
|---|---|---|---|
| 設定工具鏈、日常輸入 | 1440 × 900 | 用戶端支援時，先試 24 位元色彩，編碼維持自動。 | 確認文字清晰、游標操作流暢，再考慮放大桌面。 |
| 檢視 Xcode 與多個視窗 | 1920 × 1080 | 優先使用 24 位元色彩；頻寬不足時提高壓縮。 | 分清本機畫面縮放與遠端解析度，避免文字被縮小兩次。 |
| 行動網路或低頻寬 | 1280 × 800 | 支援時可試用 16 位元色彩與較高壓縮。 | 先關閉高影格率內容；需要判斷色彩時再恢復較高色深。 |
| 長時間建置與 CI | 不必持續開啟桌面 | 透過 SSH 查看日誌，讓建置在獨立工作或 runner 服務中執行。 | 確認工作不依賴目前的互動工作階段後，再中斷桌面連線。 |
依主要操作者的位置選擇節點
五個節點分別位於新加坡、日本（東京）、韓國（首爾）、香港和美國東部。優先選擇離實際操作者較近的節點；團隊分處不同時區時，以最常進行互動的成員為準。地理距離只是參考，還要依據你的網路業者線路和實際連線體驗判斷。
不要一次把所有參數調到最高
較高解析度會增加傳輸像素；較高壓縮可能減少流量，但會增加編碼負載或降低畫面細節。先關閉動態桌布、影片預覽和不相關的視窗，再逐步調整。單純縮放畫面通常不會減少遠端需要傳輸的像素。
連線後第一步：妥善管理存取權限
租用期間，整台 Mac mini 由你專屬使用。連線地址本身不是存取權限的防線，密碼、金鑰與本機裝置同樣需要妥善保護。
首次登入後立即更改密碼
進入 macOS 後，請更改系統帳戶密碼。如果桌面服務使用獨立的 VNC 密碼，也請檢查並更新相關設定；兩者不一定會自動同步。
更改後先保留目前工作階段，再用另一個連線確認新密碼有效，最後關閉舊工作階段。請勿同時更改密碼、網路和共享設定。
一次改一項，逐項驗證將 SSH 改為金鑰登入
在本機產生設有密語的金鑰組，只將公開金鑰加入遠端帳戶的授權清單。私密金鑰請留在本機，不要放入支援單或程式碼儲存庫。
先確認可從新的終端機使用金鑰登入，再決定是否限制密碼驗證。團隊成員各自使用自己的金鑰，離開團隊時個別撤銷。
先驗證，再收緊驗證設定關閉未使用的共享服務
檢查系統共享設定，只保留實際需要的螢幕共享、遠端登入或檔案共享。限制可登入的使用者，不要任意開放給所有帳戶。
關閉螢幕共享前，先確認 SSH 可用；修改 SSH 前，保留已驗證的桌面連線方式。不要同時關閉這兩種復原途徑。
至少保留一種可用的連線方式無法連線時，依症狀逐步排查
先確認控制台中的實例狀態與連線資訊，再判斷是「網路不通」、「驗證失敗」還是「桌面顯示異常」。反覆重試密碼無法解決連接埠或網路線路問題。
驗證成功，但 VNC 一直顯示黑畫面
先等目前的系統工作階段載入完成，再中斷連線並重新連線一次。試著關閉用戶端硬體加速或切換預設編碼，以排除用戶端顯示問題。如果 SSH 可用，代表節點並非完全無法存取，可繼續檢查系統工作階段與螢幕共享設定。
請勿立即強制重新啟動，以免中斷建置或遺失未儲存的檔案。如果仍無畫面，請提供用戶端名稱、版本、錯誤截圖與節點編號；截圖須遮蔽密碼和完整連線地址。
桌面可正常使用，但拖曳和輸入明顯卡頓
先將遠端解析度調低一級，停止播放影片和動態畫面，再檢查本機是否正在上傳大型檔案。可用 SSH 互動回應速度作為對照：命令列也很慢，優先檢查網路線路、封包遺失或本機網路；只有畫面反應慢，則優先調整編碼、色深和解析度。
記錄發生時段、所在地的網路類型，以及調整後的變化。需要更換節點時，請先詢問遷移安排；切換節點不會自動搬移所有專案與快取。
鍵盤配置不正確，快速鍵也與本機不同
先確認本機和遠端的鍵盤配置與輸入法一致，再用一般文字編輯器測試字母、數字和符號。接著檢查用戶端的快速鍵傳送、Command 對應及全螢幕按鍵攔截設定。
Windows 或 Linux 的 Ctrl、Alt 不一定會依本機習慣對應至 macOS。先確認單一按鍵，再測試組合鍵；不要在密碼欄位中反覆測試按鍵。
本機與遠端剪貼簿無法同步
確認用戶端允許雙向剪貼簿同步，再用一小段純文字測試。如果文字可同步，但圖片或檔案不行，通常是支援的格式不同，不代表整個連線失效。
傳輸檔案請改用 SFTP 或 rsync，不要依賴桌面複製貼上。重新連線後仍無法使用，可暫時關閉再啟用用戶端的剪貼簿選項；請勿為了測試而將金鑰、權杖或密碼複製到不相關的應用程式。
SSH 顯示連線遭拒，或主機指紋已變更
出現「連線遭拒」時，先確認 SSH 地址與連接埠，再檢查是否已開啟遠端登入；出現「逾時」時，應優先檢查網路連線；只有「驗證失敗」時，才檢查使用者名稱、密碼或公開金鑰是否相符。
主機指紋變更時，請先停止連線，並透過控制台提交支援單確認節點是否已重新交付。不要直接刪除已知主機記錄來略過警告，也不要關閉主機金鑰驗證。
桌面連線就緒，接著把建置交給 CI
接下來可前往指南了解 CI 整合：註冊 self-hosted runner、確認工具鏈與工作目錄，先手動成功執行一次，再切換流水線標籤。還沒有節點？立即租用專屬實體 M4。