使用系统自带的屏幕共享
打开「屏幕共享」，输入交付的 VNC 地址与端口；如果你已经建立下方的 SSH 隧道，就改连本机地址和本地端口。按交付信息完成认证，而不是输入 SSH 私钥。
适合直接操作 Xcode、Simulator 和系统设置。
连接指南 · 从交付凭据开始
拿到凭据后，三种方式连上你的 Mac mini
先用 SSH 验证命令行，再打开 VNC 桌面；需要减少公网暴露时，把 VNC 放进 SSH 隧道。你租到的是独享物理机，不是虚拟机。实际地址、端口和账户以控制台交付的信息为准。
还没有机器？先选机型与节点。已有订单？登录控制台，找到实例的连接信息后从下方第一步开始。
连接交接单SSH → VNC → CI
从控制台抄下这四项，再开始连接。不要把密码或私钥发进工单。
- 主机地址
- 实例连接信息中的地址
- SSH 端口
- 实例连接信息中的端口
- 登录账户
- 交付给你的用户名
- 桌面连接
- VNC 地址与认证信息
先验证 SSH 登录再配置桌面与构建
01 / 命令行
先连 SSH，再切换到密钥登录
SSH 是加密的命令行连接。macOS、Linux 可在终端运行；Windows 可在 PowerShell 运行。把示例中的地址、端口和用户名替换为控制台交付的值。
首次登录的顺序
- 01核对实例与端口。在控制台确认机器已经交付，再复制 SSH 地址、端口和用户名。首次出现主机指纹时，先与交付信息核对。
- 02准备公钥。在你自己的电脑生成 Ed25519 密钥对；私钥留在本机，只把以
ssh-ed25519开头的公钥加入远端账户的~/.ssh/authorized_keys。 - 03开第二个终端验证。保持第一次会话不断开，用新终端确认公钥能登录。验证成功后，再按你的安全策略关闭该账户的密码登录；不要先关密码、后测试密钥。
本机终端按交付信息替换尖括号内容
ssh -p <SSH端口> <用户名>@<主机地址>
ssh-keygen -t ed25519 -C "cloud-mac"
cat ~/.ssh/id_ed25519.pub
ssh -i ~/.ssh/id_ed25519 \
-p <SSH端口> <用户名>@<主机地址>如果本机已有密钥，先检查文件名，不要覆盖现有私钥。粘贴公钥时保留完整单行，并将远端 ~/.ssh 和 authorized_keys 的权限分别设为 700 与 600。
02 / 图形桌面
需要 Xcode 图形界面时，打开 VNC
VNC 是把 Mac 桌面画面传到你电脑上的远程控制方式。先确认控制台交付的桌面连接地址、端口与认证方式；它们不一定与 SSH 相同。
在 VNC 客户端填写连接参数
在客户端分别填写主机、端口及交付的认证信息；客户端要求单个地址时，按其说明使用「主机:端口」格式。优先使用 SSH 隧道，连接目标改为本机回环地址。
客户端协议选 VNC；不要把 SSH 端口当作桌面端口。
画面卡顿先调这两项
把画质从最高档降至适中，并降低客户端请求的帧率；先用单显示器和合适的桌面分辨率确认连接稳定。若键盘输入比画面顺畅，优先检查你到节点的网络路径，而不是立即重装开发环境。
03 / 安全连接
用 SSH 隧道转发 VNC
SSH 隧道会把你电脑上的本地端口安全地转发到远端桌面端口。客户端只连本机，不需要为方便连接而额外向公网开放 VNC。运行前确认交付信息允许该连接方式。
三步完成转发
- 01确认端口。分别核对 SSH 端口与远端 VNC 端口；示例里的
5901是你本机选用的空闲端口，不代表服务端固定使用这个端口。 - 02保持隧道运行。在本机终端执行转发命令，终端保持打开。
-N表示只建立转发，不启动远端命令。 - 03连接本机。在屏幕共享或 VNC 客户端连接
127.0.0.1:5901。结束使用后退出客户端，再关闭隧道终端。
本机终端远端端口以交付信息为准
ssh -N \
-L 127.0.0.1:5901:127.0.0.1:<远端VNC端口> \
-p <SSH端口> \
<用户名>@<主机地址>如果本机 5901 已被占用，只修改 -L 中第一个端口，并在 VNC 客户端使用相同的新端口。不要修改远端端口来解决本机端口冲突。
04 / 自动构建
把这台 Mac 注册为 self-hosted runner
self-hosted runner 是装在你自己机器上的 CI 任务执行器。先通过 SSH 登录并确认 Xcode 命令行工具可用，再到你的 CI 项目设置中创建注册凭据；不要把一次性令牌写进仓库或构建日志。
按仓库或组织登记机器
在项目的 runner 设置中选择 macOS 执行器，照页面给出的当前安装与配置命令在云端 Mac 上完成注册。使用能识别机型、节点和用途的标签，例如 macos、m4、ios-build；工作流的 runs-on 要与实际标签匹配。
注册后先跑一次仅执行 xcodebuild -version 的小任务，再接入正式构建。
在项目设置中登记执行器
获取当前项目的注册指引，在云端 Mac 安装匹配版本的 runner，并按项目需要选择 shell 执行方式。给 runner 设置清晰的节点与构建标签；检查受保护任务是否允许该 runner 执行，再提交测试流水线。
先确认任务能访问 Xcode、签名材料和项目依赖，再扩大并发量。
开机自启前，先做一次重启验证
按所用 runner 的官方服务安装方式将进程注册为 macOS 后台服务，并明确它以哪个账户运行。重启后检查服务状态和一条测试任务；交互式终端能构建，不代表后台服务也能读取相同的环境变量或钥匙串。租期结束前撤销注册令牌并备份需要保留的产物。
05 / 选择节点
远程桌面的体感，先看距离
四个在售节点是新加坡、日本（东京）、韩国（首尔）、香港。选离主要操作人员更近的节点，再从实际办公网络测试 SSH 响应与桌面交互；跨境链路、丢包和本地网络也会影响结果，不能只看地名推断延迟。
| 节点 | 优先考虑的团队位置 | 连接时先检查 |
|---|---|---|
| 新加坡 | 东南亚的开发与构建团队 | 办公网络到节点的实际往返延迟 |
| 日本（东京） | 日本及周边的开发团队 | 桌面操作与构建产物传输是否稳定 |
| 韩国（首尔） | 韩国及东北亚的开发团队 | 高峰时段是否出现丢包 |
| 香港 | 华南与东南亚的协作团队 | 团队成员各自的访问路径 |
两档机型在四个节点均可选择；下单时的实际可用状态以控制台实时返回为准。团队分布在多地时，优先按日常使用桌面的成员选址，CI 任务再考虑源码与产物传输路径。
06 / 多机协作
需要多台时，再考虑 Thunderbolt 5 并联
Thunderbolt 5 并联适合需要在同一节点协调多台机器的构建任务，或需要频繁交换大文件的工作流。附加项按每台机器计费：$1/天。是否选用应由任务的传输与并发需求决定，不是连接 VNC 或运行单台 CI 的前提。
任务能拆到多台执行
例如把多个 App target、测试分片或不同版本的构建安排到独立 runner。先给每台机器设置不同标签，确保任务不会误投到未安装所需工具的节点。
先测单机耗时，再估算并行后的收益。
传输收益是否覆盖配置成本
如果构建主要等待签名、下载依赖或外部接口，并联链路未必是瓶颈。列出待传文件大小、传输频次和机器台数，再在下单配置中核对附加项。
跨节点协作不能仅靠本地并联链路完成。
07 / 故障排查
连不上时，按现象缩小范围
先确认控制台中的实例状态、地址和端口，再区分是 SSH、VNC 还是本地网络的问题。不要在尚未备份构建产物时反复重置环境。
VNC 已连接，但画面是黑的
先确认 SSH 仍可登录，随后断开并重连桌面会话。核对 VNC 认证信息、隧道是否仍在运行，以及客户端连接的是本地转发端口还是交付的直连端口。如果 SSH 正常、多个客户端持续黑屏，请在控制台提交工单，附实例编号、出现时间和截图。
画面太小、被裁切或分辨率不合适
先在客户端关闭固定缩放，再检查 macOS 显示设置。远程桌面先用单显示器和常见分辨率验证；变更后重新连接一次，区分服务端显示设置与客户端缩放造成的问题。
键盘符号或快捷键映射错位
检查本机与远端的键盘布局是否一致，特别是标点、Option 与 Command 键。在客户端设置中查看修饰键映射；先用文本编辑器测试少量字符，再输入命令或修改签名配置。
会话断开后，怎样恢复工作
先重新建立 SSH 连接；若使用隧道，重新运行转发命令，再连接本机 VNC 端口。构建任务尽量交给后台 runner，而不是依赖不断开的桌面终端。若 SSH 与 VNC 都无法恢复，携订单号、节点编号和报错截图通过控制台提交工单。
准备开始
先租一天，把连接和构建跑通
从 SSH 小任务开始，确认桌面与 CI 都满足需求后，再决定是否延长租期或增加机器。需要排查现有实例？登录控制台提交工单。