开发环境交接单

从下单到第一次构建

租一台独享物理机云端 Mac,把现有仓库、工具链和流水线接上去。本页按操作顺序写;若已有仓库和构建脚本,建议为环境迁移预留约 30–60 分钟,资料传输与 Xcode 下载另计。

已有实例?登录控制台查看连接信息。下文的命令与输出为操作示例,实际地址和凭据以控制台显示为准。

选择配置领取凭据迁移环境验证构建
开始之前

先开通,再记录连接信息

下单时确定三件事:机型决定编译与并行任务的资源预算,节点影响远程操作延迟,计费周期决定本次使用期限。三档机型均为整机独占、非虚拟机;实际可用状态以控制台实时返回为准。

01 / 配置

选择机型、节点和周期

ZSH 16 适合先验证单条构建链路;并行编译或常驻 runner 可评估 ZSH 24;需要更大的统一内存做 MLX 实验时,查看 ZSH Pro 64。再按团队主要连接位置选择节点。

核对项:机型、SSD 容量、节点及天/周/月/季周期。

02 / 付款

完成美元结算

支持 USDT-TRC20,或通过 Stripe 使用 Visa / Mastercard / Amex。USDT 转账前核对 TRC20 网络;银行卡付款按结账页显示的网关完成。

核对项:付款结果与控制台内的订单状态;实际可用网关以后端返回为准。

03 / 交付

领取 SSH 与屏幕共享凭据

实例交付后,在控制台记录连接地址、用户名、首次登录凭据及主机指纹。不要把这些信息写进仓库、构建日志或团队公共文档。

核对项:能通过 SSH 登录,且能打开 macOS 图形界面。

迁移顺序

按数据、工具链、CI 三段交接

先让一份仓库在新机器上独立构建成功,再接入自动化任务。这样出现报错时,可以区分是资料缺失、工具版本不一致,还是 runner 配置问题。

01资料

先迁移仓库和签名资料

用 rsync 传输仓库或从受控远端重新检出。证书、描述文件和钥匙串导出文件分别加密传输;不要把私钥放进普通同步目录。

  • 确认仓库分支、子模块和 Git LFS 文件齐全。
  • 导入签名资料后,在构建用户会话中验证钥匙串访问。
  • 比对构建所需的环境变量,不直接复制本地密钥明文。

人工检查参考:10–20 分钟;传输时间取决于数据量。

02工具链

锁定版本,再恢复缓存

通过 Homebrew 安装命令行依赖,用 xcodes 管理项目需要的 Xcode 版本。先核对 xcode-select 指向,再同步 fastlane、CocoaPods 和 SPM 所需依赖。

  • 记录 xcodebuild -version 与项目要求的版本。
  • 执行一次依赖解析,不把旧机器的绝对路径带进缓存。
  • 跑通单个 scheme 的本地构建,再处理并行测试。

人工检查参考:10–20 分钟;软件下载另计。

03流水线

最后注册专用 runner

把机器接入现有 GitHub Actions 或 GitLab Runner 流程。使用仓库或组织提供的注册步骤,令构建任务在专用系统账户下运行。

  • 为 runner 设置能明确识别机型与节点的标签。
  • 让测试任务验证 Xcode、签名与产物输出路径。
  • 限制并发,确认任务结束后不会留下敏感临时文件。

人工检查参考:10–20 分钟;首次任务另计。

这些时间仅用于安排人工检查,不是开通或下载时长承诺。若构建依赖大量缓存,先迁移可复现的配置,再决定是否传输缓存文件。

验证记录

用三段命令确认环境可用

下面是示例终端记录,不是实例的真实地址、指纹或构建结果。把示例地址和 scheme 换成控制台与项目中的实际值;首次 SSH 连接必须先逐字核对控制台展示的主机指纹。

zsh — mac@sg-node 示例输出

连接与指纹核对

zsh % ssh -o StrictHostKeyChecking=ask mac@203.0.113.10
The authenticity of host '203.0.113.10' can't be established.
Host key verification required before continuing.
暂停在确认提示处。将终端显示的 ED25519 指纹与控制台记录比对;不一致就停止连接并提交工单。

验证构建

zsh % xcodebuild -version
Xcode 16.2
zsh % xcodebuild -scheme App -configuration Release build
** BUILD SUCCEEDED **
先确认 Xcode 版本,再使用项目自己的 scheme 和配置执行构建;示例版本不代表实例的预装版本。

验证分发链路

zsh % fastlane beta
Running lane 'beta'
Archive complete
Upload to TestFlight complete
上传前确认团队的签名资料、权限和 fastlane lane 配置,避免把真实令牌打印到 CI 日志。
图形界面

需要桌面时,再连接屏幕共享

SSH 适合安装依赖、拉取代码和运行构建;Xcode 设置、模拟器及图形工具则使用 macOS 屏幕共享。在控制台查看该实例的屏幕共享地址和凭据,通过本机的屏幕共享客户端发起连接。

第一次进入桌面后,先检查显示分辨率与缩放是否适合当前网络。远程操作感觉迟滞时,优先降低分辨率、关闭不必要的图形动画,再比较不同网络的连接体验。剪贴板同步应只用于非敏感文本;传送证书或私钥请改用受控的加密路径。

DISPLAY / CONNECT连接前检查
地址与凭据
从当前实例的控制台页面读取,不沿用其他实例的记录。
画面设置
先选稳定可读的分辨率,再按带宽调整清晰度。
剪贴板
仅同步必要文本;敏感文件使用独立传输流程。
连接异常
核对实例状态与地址,再检查本地网络和防火墙规则。
交付后检查

完成首次安全初始化

连接成功不等于交接结束。下面四项完成后,再把实例接入常驻 CI。每项都应由实际使用这台机器的团队确认,不要只依赖一次登录成功的截图。

  1. 01 更换初始密码 在 macOS 中为交付账户设置新密码,并更新团队的受控凭据记录。不要在聊天记录或流水线变量说明里粘贴明文。
  2. 02 改用 SSH 密钥 先安装公钥并开启一个新终端验证可登录,再调整密码登录策略。保留现有会话,避免配置错误后失去连接。
  3. 03 检查防火墙 开启 macOS 防火墙,逐项核对开发与屏幕共享所需访问;改动前记录当前规则,确保管理连接仍可用。
  4. 04 安排系统更新 定期运行 softwareupdate -l 检查更新。执行会影响构建环境的升级前,先备份资料并验证 Xcode 与项目兼容性。
租期管理

续费前核对周期,释放前带走数据

当前周期的起止时间、账单与续费入口以控制台订单页面为准;到期提醒也请以控制台和实际收到的服务通知为准,不要仅凭本地日历推算。仍需使用时,在控制台核对机型、节点、周期与金额后完成续费。

准备结束使用时,先备份仓库中未推送的改动、签名资料、构建产物与必要的审计记录;在另一台设备上验证备份可读取,再从控制台发起释放。释放后设备将执行磁盘抹除与系统重装,不要把释放操作当成备份手段。

继续查阅

按当前卡点找下一份说明

需要细化 SSH、VNC 与日常开发环境,可从技术文章列表查找远程 Mac 开发环境搭建内容;构建参数、缓存与 runner 配置,可继续查找 Xcode 云端编译指南。实例异常和账单问题请走技术支持路径。

环境与连接

远程 Mac 开发环境搭建

继续了解 SSH 密钥、Homebrew 初始化、屏幕共享设置与编辑器远程接入。

构建与流水线

Xcode 云端编译完整指南

进一步检查 Xcode 版本、构建缓存、测试命令及 self-hosted runner 的接入方式。

实例与账单

技术支持中心

连接失败、构建环境异常或续费有疑问时,先按排查项定位,再通过控制台提交工单。

下一步 / 开始配置

把第一条构建跑起来

先选机型、节点和周期;拿到实例后,按本页清单完成连接、迁移与验证。