设备状态
登录控制台核对订单对应设备是否可访问，并确认当前查看的是正确实例。不要复用旧订单截图中的地址。
远程接入运行单
从连接信息到稳定桌面，按顺序接入云端 Mac
本指南面向已经取得设备信息的开发者。先核对节点、主机地址和本地网络，再建立 VNC 会话；连接后继续校准显示、键盘和剪贴板，避免把网络问题误判为主机故障。
5 个
可选物理节点
1 订单
对应独享物理机
365 天
节点正常运行
连接运行单
VNC / DESKTOP ACCESS
准备就绪后执行
- 01 读取设备信息 节点、地址、账户
- 02 添加远程主机 保存正确地址
- 03 完成身份验证 仅在可信设备输入
- 04 验收桌面会话 检查显示与输入
连接异常时不要连续修改多个变量
一次只验证一项
连接前准备
先确认五类信息，再打开客户端
远程连接最常见的误区，是在设备状态、地址或本地网络尚未确认时反复更换客户端。按下面的顺序核对，可以把账号、网络与显示问题分开处理。
物理节点
确认设备位于新加坡、东京、首尔、香港或美国西部中的哪个节点。跨区域链路会直接影响输入响应与画面刷新。
主机地址
逐字符核对地址，不把端口、空格或说明文字一并复制。地址发生变化时，以控制台当前显示的信息为准。
账户信息
只在可信设备上输入连接账户和密码。连接凭据不得放进代码仓库、群聊截图、公开工单或多人共享文档。
本地网络
优先使用稳定有线网络或信号良好的 Wi-Fi，暂停占满上行带宽的同步任务，并确认本地网络没有拦截远程连接。
首次连接
四步完成 VNC 首次会话验收
以下流程以 macOS 客户端为例。每完成一步就确认结果，不要在地址、身份验证和显示设置之间来回跳转。
-
步骤 01
获取当前连接信息
在控制台打开对应设备详情，记录节点、主机地址和连接账户。若团队管理多台设备，先用订单号与设备标签完成一一对应。
验收：订单、节点与设备标签一致 -
步骤 02
添加远程主机
打开 macOS 的屏幕共享客户端，在地址栏输入控制台提供的主机地址。为条目设置可识别名称，例如项目名、节点和设备标签。
验收：客户端开始建立连接而非立即报地址错误 -
步骤 03
验证连接身份
输入设备对应的连接账户与密码。首次连接时核对主机信息；若信息与控制台记录不一致，停止操作并重新确认地址。
验收：身份验证通过且进入目标设备 -
步骤 04
进入桌面并完成验收
等待桌面元素完成加载，依次测试鼠标、键盘、窗口拖动和剪贴板。随后打开终端确认主机名，避免误在另一台设备上执行命令。
验收：画面、输入、剪贴板与主机名均正确
显示与输入优化
先稳定交互，再追求更高画质
高分辨率、跨语言键盘和多显示器都会增加远程桌面的变量。调整时每次只改一个设置，并记录修改前后的输入延迟与画面清晰度。
分辨率与缩放
首次连接先使用较低分辨率确认链路稳定，再逐级提高。若文字模糊，优先调整客户端缩放比例，不要同时改变远端分辨率和本地显示缩放。
键盘布局
确认本地输入源与远端布局一致。中日韩输入法重点检查中英文切换和候选窗；欧洲键盘重点验证 Option、AltGr、反斜杠与符号键映射。
剪贴板同步
先用一行纯文本测试双向复制，再测试多行命令。不要通过剪贴板传递密码、私钥或未脱敏配置；大文件应使用受控传输流程。
多显示器
先在单显示器模式完成连接验收，再扩展第二块屏幕。遇到黑边、缩放不一致或光标偏移时，回到单屏并重新确认主副屏排列。
链路延迟参考
主要访问城市到五个节点的 Ping 中位数
下表用于比较相对距离，不代表每条用户线路的固定结果。数值受本地运营商、跨境路由、Wi-Fi 质量和测试时段影响，订购前可在自己的实际网络中复测。
测试日期
2026-08-22
接入运营商
当地主要固网
测试时段
当地 14:00–17:00
样本次数
每路径 30 次
统计口径
ICMP 往返中位数
| 访问城市 | 新加坡 | 东京 | 首尔 | 香港 | 美国西部 |
|---|---|---|---|---|---|
| 上海 | 73 ms | 48 ms | 55 ms | 34 ms | 142 ms |
| 深圳 | 42 ms | 66 ms | 72 ms | 21 ms | 151 ms |
| 台北 | 58 ms | 31 ms | 46 ms | 37 ms | 126 ms |
| 大阪 | 78 ms | 18 ms | 35 ms | 61 ms | 113 ms |
| 首尔 | 89 ms | 37 ms | 9 ms | 67 ms | 128 ms |
| 新加坡 | 8 ms | 72 ms | 86 ms | 39 ms | 168 ms |
| 洛杉矶 | 176 ms | 112 ms | 128 ms | 151 ms | 24 ms |
高亮值表示该访问城市在本次样本中的最低中位数。VNC 交互还会受到抖动、丢包和上行带宽影响，不能只依据单次 Ping 选择节点。
安全连接习惯
把远程桌面当作生产入口管理
独享物理机提供资源隔离，但连接安全仍取决于账户、凭据和操作习惯。团队应为每位操作者建立可追踪的访问边界。
-
使用独立连接账户 不要多人长期共用同一账户，人员变动时及时调整授权。
-
设置高强度唯一密码 不要复用代码托管、邮箱或其他系统的密码，也不要写入脚本。
-
坚持最小权限 日常构建账户只获得任务所需权限，管理操作与自动化任务分开执行。
-
定期更新凭据 成员离组、设备遗失或发现异常登录迹象时，应立即更换相关凭据。
-
离开设备时锁定会话 短暂离席也应锁定远端桌面，并关闭不再需要的本地连接窗口。
可以记录
排查所需上下文
订单号、节点、发生时间、macOS 版本、客户端版本、复现步骤和脱敏错误日志。
禁止传播
任何连接秘密
密码、私钥、完整连接凭据、仓库密钥和未经脱敏的配置文件都不应进入公开沟通区域。
故障排查
按症状定位，不要同时改动全部设置
先记录发生时间和当前现象，再从最容易验证的条件开始。每完成一项检查就重试一次，以便确认是哪一个变量影响了连接。
无法建立连接
- 在控制台确认设备、节点和主机地址对应同一订单。
- 检查地址是否夹带空格、说明文字或过期记录。
- 切换到稳定网络，暂停占用上行带宽的同步任务。
- 记录客户端错误文本与发生时间，再提交脱敏信息。
连接后黑屏或桌面不刷新
- 等待桌面完成加载，避免连续断开和重连。
- 将客户端画质或分辨率降低一级后重新观察。
- 退出全屏并切回单显示器模式，排除显示布局问题。
- 若仍无画面，记录是否能看到光标及最后一次正常时间。
鼠标或键盘输入延迟明显
- 连续测试多次 Ping，区分稳定高延迟与偶发抖动。
- 关闭本地大文件上传、备份与视频会议后复测。
- 降低远程桌面分辨率和画面质量，观察输入响应。
- 确认构建任务是否正在持续占用处理器、内存或磁盘。
剪贴板无法同步
- 先复制一行纯文本，排除富文本和大体积内容影响。
- 分别测试本地到远端、远端到本地两个方向。
- 检查客户端是否关闭了剪贴板共享。
- 重新建立会话后复测，不通过剪贴板传递敏感信息。
分辨率、缩放或光标位置错误
- 退出全屏并恢复单显示器模式。
- 固定本地缩放比例，再单独调整远端分辨率。
- 断开后重新连接，确认客户端读取了新的显示配置。
- 记录本地显示器分辨率、缩放比例与客户端版本。
会话间歇中断
- 记录每次中断的准确时间和持续时长。
- 检查本地网络是否同时发生 Wi-Fi 漫游或线路切换。
- 对照自动化任务时间线，确认是否与高负载任务重合。
- 保留脱敏客户端日志，通过控制台提交工单。
CI 与桌面并行
让人工操作不干扰自动化构建
远程桌面和 self-hosted runner 可以同时使用，但两者会共享同一台独享物理 Mac 的处理器、内存、磁盘和网络。团队需要明确观察指标与操作边界。
并行工作运行单
桌面会话与构建队列共存规则
先看资源状态
在开始大文件复制、依赖安装或图形操作前，查看处理器、内存、磁盘空间和网络占用，确认是否存在正在运行的构建。
分开工作目录
人工调试不要直接修改 runner 正在使用的工作区。为临时验证建立独立目录，避免清理脚本删除另一任务的文件。
避免高影响操作
构建运行期间不要随意退出关键进程、批量清理缓存、切换工具链版本或重启设备。必要变更应先暂停新任务进入队列。
保存问题时间线
记录异常发生时间、对应仓库、runner 标签、任务编号和人工操作。时间线能帮助判断问题来自网络、资源竞争还是环境改动。
建议验收顺序
确认队列状态 → 查看资源 → 执行单项操作 → 记录时间 → 对照构建日志
连接后的下一步
桌面稳定后，再配置 Xcode 与 runner
先在支持指南中记录工具版本、工作目录和 runner 标签。若连接仍有异常，请保留发生时间、节点、客户端版本与脱敏日志，通过控制台工单或支持邮箱联系团队。
support@globemini.com