VNC 图形桌面
适合首次配置、查看 Xcode 界面、检查构建结果，以及需要鼠标操作的任务。Windows 与 Linux 用户可优先从这里开始。
需要：兼容的 VNC 客户端，以及控制台提供的桌面地址、端口和认证信息。连接时留意客户端对加密方式的提示。
需要看见 macOS 桌面时选它
先连通，再调顺
拿到凭据后，三种方式连上你的 M4
看桌面用 VNC，在 Mac 上可用系统屏幕共享；跑命令、传文件或接 CI，用 SSH。先从控制台取出当前节点的连接信息，再按你的电脑系统操作。
已经下单？本页不需要你填写密码。连接地址、端口与用户名，以登录后实例详情显示的内容为准。
先选连接方式，不必三种都装
图形桌面负责交互，命令行负责自动化。它们连接的是同一台独享物理机，不是另外创建的虚拟机。
macOS 屏幕共享
适合本地也是 Mac 的用户。通过访达打开系统连接入口，不必先安装另一套桌面客户端。
需要：控制台提供的 VNC 连接信息。系统屏幕共享与第三方客户端的认证提示可能不同，按实际界面填写。
本地 Mac 的直接入口SSH 命令行
适合 Git 操作、依赖安装、文件同步与 self-hosted runner。后台构建不需要持续传输桌面画面。
需要：SSH 地址、用户名、端口和密码或密钥。首次连接先核验主机指纹，成功后再设置密钥登录。
自动化与低带宽任务优先跟着你的系统，走完首次连接
下面的界面块是操作位置示意，不包含真实地址、账号或密码。不同系统版本的按钮名称可能略有差异，字段值始终取自控制台。
macOS：访达 → 连接服务器
使用系统屏幕共享，完成从地址到桌面的交接。
-
01
取出桌面地址
登录控制台，打开目标实例详情。复制 VNC 地址与端口，同时记下对应认证方式。不要把 SSH 端口填进桌面连接字段。
操作位置示意 · 实例连接信息 - 图形桌面
- 复制 VNC 地址与端口
- 认证
- 查看桌面连接说明
-
02
打开系统入口
在访达选择「前往」→「连接服务器」，或按 ⌘ + 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 接入：注册 self-hosted runner，核对工具链与工作目录，先手动跑通一次，再切换流水线标签。还没有节点？先租一台独享物理 M4。