从 macOS 连接
- 打开“终端”，使用控制台给出的用户名、地址与 SSH 端口建立连接。首次出现指纹提示时先核验，不要直接确认。
- 需要桌面时，打开“屏幕共享”，输入实例的屏幕共享地址；使用隧道时，改填本地监听地址与端口。
- 输入系统用户名与密码。进入桌面后检查键盘布局、显示分辨率和时区，再打开工作工程。
- 结束桌面会话前，确认构建日志已落盘。断开屏幕共享并不等于停止租用，也不等于结束后台任务。
首次验收：终端能读到系统信息，桌面能打开 Finder，工程目录可写。
远程连接纪要
开机后十分钟内
开机后十分钟内
连上你的 Mac
先用 SSH 验证连通性，再打开屏幕共享。你拿到的是独享物理 Mac mini，macOS 图形界面与命令行完整可用，适合远程办公、构建与测试。
这里的十分钟是收到凭据、客户端与网络均已准备后的操作目标，不代表订单交付时限。连接地址、端口与认证方式均以控制台显示为准。
已有实例：从控制台实例详情核对连接信息。请勿把密码、私钥或完整凭据贴进公开讨论。
先选访问方式
桌面操作走屏幕共享，自动化任务走 SSH
日常配置可以使用图形界面；编译、日志与文件传输优先使用命令行。两条连接路径互为补充，不需要为每次构建持续打开桌面。
| 连接方式 | 适用任务 | 所需端口 | 认证与注意事项 |
|---|---|---|---|
| macOS 屏幕共享 | 配置 Xcode、操作模拟器、检查图形界面与远程办公 | VNC 默认 TCP 5900；隧道模式另需 SSH 端口 | 使用交付的系统用户认证。桌面连接不替代 SSH 公钥认证。 |
| 第三方 VNC 客户端 | 从 Windows 或 Linux 访问 macOS 桌面 | VNC 默认 TCP 5900，或客户端连接本地隧道端口 | 需兼容服务端认证方式。不要为解决兼容问题关闭认证或开放所有来源。 |
| SSH 命令行 | 执行构建、查看日志、注册 runner，以及通过 SFTP 传输文件 | SSH 默认 TCP 22；公网映射以控制台为准 | 优先公钥登录。首次连接先核对主机指纹，再确认信任。 |
先确认端口，再排查客户端。连接超时通常应从地址、出站策略和目标端口查起；已经出现认证提示，说明网络路径通常已打通，此时应检查用户名、密码或密钥。
按本地系统执行
三种客户端，一套验证顺序
先建立 SSH 会话，确认实例身份与工作目录，再连接桌面。下面的步骤不要求关闭本地防火墙，也不要求把云端 Mac 暴露给任意来源。
从 Windows 连接
- 在 PowerShell 中检查 OpenSSH 客户端是否可用；企业设备若不允许安装组件，先与本地管理员确认。
- 用 SSH 命令验证地址与端口。密码输入时不回显字符是正常行为，不要因此重复粘贴。
- 安装兼容 macOS 屏幕共享认证的 VNC 客户端，分别填写主机与端口；各客户端的地址格式可能不同。
- 建议通过 SSH 隧道访问桌面。若握手失败，先核对认证兼容性，再检查服务状态，不要反复猜密码。
首次验收：能建立 SSH 会话，VNC 能完成认证，快捷键映射满足日常操作。
从 Linux 连接
- 使用发行版提供的 OpenSSH 客户端；检查本地密钥权限，确保私钥没有对其他用户开放。
- 按交付信息连接 SSH。需要传输工程或产物时，可复用同一 SSH 入口使用 SFTP。
- 选择兼容服务端认证的 VNC 客户端，优先连接经 SSH 转发的本地端口，而不是直接暴露桌面服务。
- 首次进入桌面后检查剪贴板与输入法。文件批量传输走 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，先把设备型号、系统版本、配对路径与测试目的发给团队，验证可行后再安排正式工作。只需要安装包验证时，可将签名产物交给测试人员在本地设备上测试，无需始终维持远程调试会话。
连接成功后继续做
先收紧访问，再放入工程与密钥
独享物理机避免与其他租户共享计算资源，但不能替代账户安全。完成以下三项，再部署构建证书、业务代码与自动化凭据。
-
启用公钥登录
在可信的本地设备生成密钥，将公钥写入远端对应用户的授权文件。私钥保留在本地，不上传到机器或工单。新开一个终端验证公钥登录成功，保留原会话作为恢复入口，再调整密码认证策略。
-
更换交付密码
首次登录后更换系统密码，并保存到可信的密码管理工具。不要把密码写在 runner 配置、命令历史或工程仓库里。团队协作应分配可追踪的访问身份，避免多人长期共用一份凭据。
-
只开放必要端口
仅保留实际使用的 SSH 与桌面访问路径，能使用隧道时优先使用隧道。变更防火墙或访问规则前，先核对当前管理入口，准备恢复方式。不要为排查连接问题一次性关闭全部防护。
发生异常时，工单里写什么
提供实例标识、客户端系统与版本、连接方式、发生时间及其时区、错误原文，以及“超时 / 拒绝连接 / 认证失败”中的具体表现。可附脱敏截图，不要附密码、私钥或完整连接凭据。
连接前自查
四项准备齐全，再开始首次登录
按顺序核对。遇到缺项先补齐，不要靠重复尝试消耗时间；企业网络不允许必要出站连接时，应先申请访问策略。
- 凭据已保存
实例地址、系统用户名、认证信息和实际端口均已从控制台核对，并存放在安全位置。 - 客户端已安装
命令行可运行 SSH；需要图形界面时，已准备兼容的屏幕共享或 VNC 客户端。 - 公钥已上传并验证
使用公钥认证时，公钥已写入正确用户，且已通过新会话验证；私钥仍只保留在本地。 - 本地网络允许出站端口
已核对实际 SSH 端口；直接连接桌面时另核对 VNC 端口，使用隧道时检查本地监听端口。
首次验收完成后，记录客户端版本、连接方式与有效设置。下一位团队成员可以复用步骤，但不应直接复制你的私人密钥或密码。
连接路径确认好，再把工作迁上来。
先验证桌面、命令行与实际任务。需要开始租用，按工作负载选择档位；已有实例，直接从控制台检查凭据。