订单与设备
确认订单对应的 Mac、机型和实例标识。管理多台设备时，先分清要操作的是哪一台，避免把项目文件传到错误的设备。
连接与构建支持
从订单资料出发，连上你的云端 Mac。
先确认设备、区域与访问权限，再建立 SSH 连接并验证构建环境。这份清单适用于首次接入和故障定位；连接地址、用户名与密钥以你自己的订单资料为准。
已经下单？先在控制台打开对应订单，再按右侧的核对顺序操作。
连接核对单
01 / 03
先核对，再连接
一份订单，对应一台设备。
- 设备
- 核对订单中的机型与实例标识
- 区域
- 确认所选节点与访问路径
- 权限
- 使用该订单提供的连接资料
公开示例不包含真实地址、私钥或访问令牌。实际可用信息以控制台返回为准。
区域与连接资料
确认订单所选区域，并从该设备的管理信息中读取连接地址、端口和用户名。不要把本页的演示地址当作实际入口。
账户与访问权限
核对当前账户能否查看该订单及其连接资料。将私钥留在受控的本地环境，不要发到工单、仓库或公开页面。
不要提交敏感凭据。排查问题时可以提供脱敏错误信息，但不要发送私钥、完整令牌、证书内容或含个人信息的原始日志。
连接流程
按三个环节建立可信连接。
先取得本次订单的真实参数，再处理本地密钥和首次主机身份确认。网络连通、账户授权与主机身份是三个不同检查项，不要只凭出现登录提示就跳过核对。
-
01
读取连接信息
登录控制台，打开目标订单，记录该设备提供的地址、端口、用户名和连接说明。若订单尚未显示可用连接资料，先确认订单状态，不猜测地址。
-
02
准备 SSH 密钥
在本地确认私钥文件的访问权限，并按订单说明配置对应公钥。为 CI 单独规划受限凭据；不要把个人开发机的私钥直接复制到构建仓库。
-
03
验证主机身份
首次连接时核对主机指纹与可信的设备资料。指纹不符或突然变化时先停止连接，核查是否选错设备、地址或访问路径，不要直接忽略警告。
命令示例
连接后，用最小命令验证环境。
下方输出仅用于说明检查顺序，不代表某台设备的实际系统版本、构建结果或已配置的项目。演示用的 192.0.2.10 不是订单连接地址；运行前应替换为控制台提供的资料。
先确认能进入目标设备，再查看 Xcode 命令行工具指向，最后在项目目录内执行自己的构建任务。每一步失败都可以单独定位，不必把整条 CI 流水线一次性搬上去测试。
连接与构建检查 · 示例
$ ssh -i ~/.ssh/id_ed25519 operator@192.0.2.10
示例输出：已进入目标设备，请核对主机身份
$ xcodebuild -version
示例输出：显示设备当前安装的 Xcode 版本
$ fastlane build
示例输出：检查项目配置后返回构建结果示例命令不包含真实凭据。fastlane build 仅适用于项目已定义对应任务的情况；实际命令以项目配置为准。
首次构建
先记录版本与依赖，再比较构建结果。
“连接成功”只证明进入了设备，不证明开发环境已经与项目匹配。以下检查应在部署 Runner 或上传大批量项目文件之前完成；具体系统与工具版本以所租设备的实际环境为准。
系统与 Xcode
记录 macOS 版本、当前 Xcode 版本，以及 xcode-select -p 指向的开发者目录。项目要求特定 SDK 时，核对可用版本后再开始构建。
检查点：系统版本、Xcode 版本、命令行工具路径。
项目依赖
按仓库锁定文件安装依赖，核对包管理工具、脚本运行环境与项目所需插件。把工具安装、项目配置和签名材料分开管理，避免用一次构建失败推断设备故障。
检查点：锁定文件、安装日志、依赖版本。
最小构建
先在项目目录运行一条可复现的检查或构建命令，保存命令、退出状态与首个错误位置。确认本地手动构建可行后，再将同一任务接入 CI。
检查点：执行目录、完整命令、首个失败步骤。
自动化接入
让 Runner 重现已验证的手动构建。
CI/CD 接入的目标不是换一套无法追溯的环境，而是把已成功的命令、依赖与权限要求记录成可重复执行的作业。注册方式和执行器设置取决于你的 CI 系统；不要在公开配置里粘贴真实注册令牌。
A
注册与隔离
在所用 CI 系统里为目标设备注册 Runner，确认它接收的是预期项目和作业。检查执行用户、工作目录与同时运行任务的安排。
B
密钥与签名材料
把访问密钥和签名材料交给 CI 系统提供的受控机密存储机制，不写进仓库、构建脚本输出或缓存。只授予任务所需权限。
C
缓存与产物
明确依赖缓存的路径和清理条件，将构建产物保存到团队指定位置。遇到无法复现的错误，先运行一次不使用旧缓存的构建作对照。
D
会话结束
作业结束后检查临时文件、后台进程和会话状态。交接设备或调整权限时，撤销不再需要的访问，并确认没有把凭据留在工作目录。
故障定位
从第一个失败环节开始排查。
先记下故障发生在哪一步，再保留对应命令、退出状态和脱敏日志。不要只发送一张显示“失败”的末屏截图：最早出现的错误通常比最后一行摘要更有用。
SSH 无法连接
先确认订单和目标设备，再核对地址、端口及本地网络能否到达；随后检查用户名、密钥权限与主机身份提示。连接超时与权限拒绝应分开记录，前者先查路径，后者先查授权。
签名配置异常
检查项目使用的签名配置、构建目标与 CI 执行用户是否一致。不要把证书或私钥内容贴进支持请求；提供脱敏后的错误行和触发它的构建步骤即可。
构建失败
比较手动运行与 CI 作业的 Xcode 路径、依赖版本、工作目录和环境变量来源。先找第一条实际编译或脚本错误，再判断是否需要清理缓存并复跑。
磁盘空间不足
查看可用空间，并区分项目文件、构建产物、依赖缓存与临时文件。清理前确认文件归属；如果工作负载持续需要更多容量，可在方案页核对存储附加选项。
提交支持请求时：附上订单对应的设备型号与区域、问题发生时间、执行的命令、首个错误位置，以及已尝试的步骤。发送前移除令牌、证书、私钥和个人信息。
准备好开始
选好设备，再按清单接入。
三档 Apple Silicon 独享物理机可按日、周、月或季选择。先核对机型与租期，订购后从控制台取得你的连接资料。