SSH 命令行
适合签出项目、检查依赖、执行 xcodebuild、查看日志，以及接入 macOS CI runner。
- 本地准备 SSH 客户端与获得授权的账户。
- 首次连接时核对主机指纹，不跳过身份验证。
连接指南
连接云端 Mac，按任务选择命令行或桌面。
要执行构建脚本，先看 SSH；要检查 Xcode 图形界面，再使用远程桌面。UDPMac 提供独享物理 Mac，连接地址、账户权限和可用方式均以控制台实际发放的信息为准。
已有实例？先在控制台确认设备状态与连接参数，再按下方步骤操作。
连接选择单
流程示意
01
执行命令与 CI 任务SSH · 终端、脚本、构建日志
02
查看 macOS 桌面VNC · 图形操作与显示检查
03
核对 Xcode 项目打开项目 → 检查工具链 → 测试构建
此单仅解释操作顺序，不展示实例状态或真实连接凭据。
先选访问方式
让连接方式跟任务走。
命令行与图形桌面各有用途；不必为了运行自动化脚本而保持桌面会话，也不必用终端替代需要目视确认的 Xcode 操作。
VNC 远程桌面
适合查看 macOS 图形界面、核对显示设置，以及处理必须在桌面完成的交互。
- 使用控制台提供的连接参数与获准的客户端。
- 共享设备上不保存连接地址以外的访问凭据。
Xcode 图形工作流
先通过远程桌面打开项目，再核对 Xcode 版本、工程设置与签名所需材料，最后执行测试构建。
- 项目兼容性取决于依赖、工具链和配置。
- 构建结果以实际输出与日志为准。
连接前检查
先核对四项条件，再输入连接参数。
不要把密码、私钥、签名证书或完整连接信息粘贴到公开页面、聊天记录和故障截图中。
01设备状态
在控制台确认实例已就绪，并核对当前订单对应的机型与节点；不要沿用另一台设备的旧地址。
02账户权限
确认使用的是该实例获授权的账户。若团队分工不同，先核对谁可以登录、谁可以修改工具链或项目文件。
03网络连通
检查本地网络与目标连接所需端口是否可达；遇到超时时，先区分网络问题和身份验证失败。
04本地客户端
SSH 任务准备终端客户端；桌面任务准备适用的 VNC 客户端，并确认本地设备允许建立相应连接。
SSH 操作顺序
建立会话，验证主机，再运行命令。
以下主机名和用户名只用于说明命令结构。实际地址、账户与验证信息必须从控制台取得。
01
取得参数并发起连接
从控制台核对主机、账户和所需认证方式，将示例中的占位内容替换为本实例信息；不要复用其他实例的连接记录。
02
完成首次身份核对
首次连接出现主机指纹提示时，通过可信的实例信息核对后再继续。若指纹与已核对的记录不符，停止连接并排查。
03
执行任务并退出
先确认所在目录、Xcode 工具链与磁盘空间，再执行项目命令；保存需要的产物和日志后用 exit 结束会话。
命令结构示例非真实凭据
ssh USER@HOST.example.invalid
xcode-select -p
xcodebuild -version
exit示例域名不可用于连接。项目构建命令、工作目录及签名配置应按自身工程核对，不能直接由这段示例推定。
图形桌面
四步完成远程桌面会话。
仅在需要图形操作时建立桌面会话。SSH 与 VNC 的连接参数可能不同，分别以控制台实际显示为准。
01获取连接参数
确认实例就绪后，在控制台查看当前设备的远程桌面地址、访问方式及账户要求。不要从旧邮件或他人的截图抄录凭据。
02建立会话
在本地 VNC 客户端输入对应参数。若需要验证身份，使用获授权的信息；不要关闭客户端的连接安全提示来绕过错误。
03调整显示
连接后按屏幕大小调整缩放或分辨率，先检查输入焦点和键盘布局，再对项目或系统设置进行修改。
04安全退出
保存工作、关闭涉及敏感数据的窗口，然后从客户端断开会话。在共享设备上不要保存访问凭据。
Xcode 检查清单
第一次图形构建，逐项留下可核对的结果。
云端 Mac 提供运行环境，不意味着项目无需调整即可通过。先做一次小范围测试，再决定如何接入日常构建。
打开正确的工程入口
签出或迁入项目后，确认分支、依赖文件与工程入口一致。记录缺失依赖和首次打开时出现的配置提示，不直接在主分支上试改。
完成检查：项目与预期分支均可识别。
核对版本与权限
检查 Xcode 版本、所选命令行工具及项目目标配置；若构建涉及签名材料，由团队按自身安全制度保管与授权，不把材料写入日志。
完成检查：工具链和构建目标已记录。
执行一次测试构建
从明确的目标开始构建，记录失败步骤、关键错误与产物位置。只有核对过输出，才能判断下一步是修复依赖、配置还是连接。
完成检查：结果和脱敏日志可复查。
连接异常排查
先定位失败发生在哪一层。
向团队反馈时，记录发生时间、所用连接方式、实例订单标识和脱敏后的报错；不要发送完整凭据或含项目机密的屏幕截图。
| 现象 | 优先检查 | 需要记录 |
|---|---|---|
| 认证失败 | 确认账户、认证方式和实例是否匹配；首次连接还应核对主机身份提示。 | 客户端报错原文、连接方式；遮盖用户名以外的敏感字段。 |
| 连接超时 | 确认实例状态、本地网络、目标地址及连接所需端口，区分超时与密码错误。 | 发生时间、所选节点、网络环境及超时发生的步骤。 |
| 画面延迟 | 检查本地网络稳定性，并尝试降低远程桌面显示负载；确认终端操作是否也受影响。 | 发生时间、客户端显示设置及可复现的操作。 |
| 会话中断 | 检查本地网络变化、客户端提示和实例状态；重新连接前先确认未完成的文件操作。 | 中断前最后一步、客户端提示及重新连接的结果。 |
安全收尾
断开连接不等于完成交接。
结束 SSH 或远程桌面会话后，再检查账户、工作文件与后续访问安排。租期结束前，主动导出团队需要保留的项目数据和构建产物。
核对账户
检查是否仍有不需要的活动会话或临时授权，并按团队流程处理。
整理文件
确认产物已归档；清理不再需要的临时文件前，先核对是否影响下一次构建。
保管凭据
撤下共享设备保存的连接信息，避免将私钥、签名材料和含敏感字段的日志留在公共位置。
了解站点与服务信息的处理方式，请阅读隐私政策。
准备开始
选定节点，再把构建任务接入云端 Mac。
先核对机型、租期与节点；开通后从控制台取得实际连接信息，按本指南选择 SSH 或图形桌面。