按急迫程度,选最快的那条路
自助文档最快,工单最全,邮件适合留档,状态页帮你先排除「是不是平台的问题」。
拿到凭据后的前十分钟
开通后 2 分钟你会在控制台和邮箱收到 SSH/VNC 凭据,照下面三步,十分钟内就能进到桌面开始干活。
1. 首次 SSH 登录
凭据里的主机名形如 jp1-1024.hirevps.com,用系统自带终端即可连接:
# replace host and user with your credentials
ssh omac@jp1-1024.hirevps.com
# first login: change your password
passwd建议登录后立即改密码,并在控制台上传 SSH 公钥、关闭密码登录,更安全也更省事。
2. 开启 VNC / 屏幕共享
交付时屏幕共享默认开启;若你手动关闭过,SSH 进去一条命令即可重新打开:
# enable macOS remote management (screen sharing)
sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Resources/kickstart \
-activate -configure -access -on -restart -agentMac 上用「屏幕共享」App,Windows/Linux 用任意 VNC 客户端,地址填主机名、端口 5900。
3. 开发环境自查清单
- 交付镜像已预装 Homebrew、Git 与 Xcode Command Line Tools,终端里跑
xcodebuild -version与brew --version确认版本。 - CI/CD 场景先跑一次完整构建当基线:记录冷启动与增量耗时,后续排查性能问题有对照。
- 证书与密钥建议放进独立 keychain,并在构建脚本里显式解锁,避免图形会话锁屏后签名失败。
- 退租前把代码与产物同步回你的仓库或对象存储——擦除后数据不可恢复(见服务条款的数据边界)。
重装、换版本、迁数据,都在控制台点几下
这三件事全部自助完成,不需要提工单;重装与换版本免费、不限次数。
重装 macOS
控制台 → 你的实例 → 「重装系统」,选择版本后确认,全程约 15~25 分钟(以实测为准)。
重装会清空整块 SSD,请先把代码推到远端仓库、把产物拷贝走,再点确认。
更换系统版本
可选当前正式版与上一个大版本(如 Sequoia / Sonoma),部分节点提供 beta 镜像,以控制台列表为准。
换版本走的也是重装流程,同样会清盘;做多版本兼容测试时,更推荐按天再开一台,跑完即退。
快照与数据迁移
重装前可用 APFS 本地快照兜底,跨机迁移推荐 rsync:
# create a local snapshot before risky changes
tmutil localsnapshot
# sync your workspace to the new machine
rsync -avz ~/work/ omac@new-host:~/work/我们不读取、也不备份你机器内的数据(见隐私政策),所以重要数据请你自己定期同步到远端仓库或对象存储——本地快照在重装后同样会被清除。
把这台 Mac 变成你的构建节点
独享物理机 + root 权限,接入主流 CI 就是标准官方流程,没有任何私有魔改。选你在用的那套:
接入 self-hosted runner
在仓库或组织的 Actions 设置页选择「新建 self-hosted runner(macOS / ARM64)」,把页面给出的下载与配置命令粘到云 Mac 终端执行:
# run these on your cloud Mac (values come from your Actions settings page)
./config.sh --url <your-repo-url> --token <runner-token> \
--labels macos,arm64,hirevps
# install as a service so it survives reboots
./svc.sh install && ./svc.sh start工作流里把 runs-on 改成 [self-hosted, macos, arm64] 即可。M4 物理机跑 xcodebuild 通常比托管 runner 快不少,具体差距以你的项目实测为准。
接入 Jenkins 节点
在 Jenkins 「节点管理」新建一个 agent(启动方式选 inbound),然后在云 Mac 上启动 agent 进程:
# download agent.jar from your Jenkins controller first
java -jar agent.jar \
-url <your-jenkins-url> \
-name hirevps-m4 \
-secret <agent-secret> \
-workDir ~/jenkins-agent建议用 launchd 把 agent 注册成开机自启服务,并给节点打上 macos-arm64 标签,方便流水线按标签调度。需要示例 plist 的话,提个工单我们直接发你。
三个高频问题,先照单自查
提工单前花两分钟走一遍对应清单——超过一半的报障在第 2 步就解决了。
连不上机器(SSH 超时 / VNC 黑屏)
- 打开状态页确认你所在节点是否正常——正常就说明问题大概率在你这一侧。
- 本地 ping 主机名看是否可达;换手机热点再试一次,排除公司网络或运营商对 22/5900 端口的拦截。
- 登录控制台看实例状态:若显示「运行中」,先用控制台里的「远程重启」;若卡在启动,等 3 分钟再刷新。
- 检查是否改过 SSH 端口或防火墙规则(pfctl)——这是自锁门外最常见的原因,控制台的「救援终端」可以绕过网络直接进系统改回来。
- 以上都试过仍连不上,直接提工单并勾选「无法连接」,我们按 P1 处理。
构建变慢(xcodebuild 耗时明显上涨)
- 先确认不是任务本身变了:依赖升级、Xcode 大版本更新后首次构建要重建索引与缓存,慢一次属正常。
- top -o cpu 看有没有失控进程;Spotlight 首次建索引会吃满 CPU,可用 mdutil -a -i off 关闭。
- 检查 DerivedData 是否被 CI 每次清空——保留缓存目录通常能把增量构建时间砍掉一大截。
- df -h 看磁盘剩余:SSD 占用超过 90% 时写入性能会下降,先清盘再对比。
- 你的机器是独享物理机,不存在邻居抢资源;若排除以上因素仍持续变慢,提工单附上前后两次构建日志,我们帮你查硬件层。
磁盘满了(No space left on device)
- 先找大头:du -sh ~/Library/Developer/*——Xcode 的 DerivedData、旧模拟器运行时和 Archives 通常占最多。
- 安全清理:rm -rf ~/Library/Developer/Xcode/DerivedData;删除不用的模拟器运行时用 xcrun simctl runtime delete。
- APFS 本地快照也占空间:tmutil listlocalsnapshots / 查看,tmutil deletelocalsnapshots 删除旧快照。
- CI 机器建议在流水线里加定期清理步骤,别等满了才处理。
- 清完还是紧张?说明该升配了——升级 SSD 只补差价,数据迁移方法见上方手册,或直接在方案页选更大的档位。
白纸黑字的响应承诺
工单按影响面分三级,分级由你提单时选择、我们复核确认;承诺只写做得到的。
| 级别 | 典型场景 | 首次响应 | 服务时段 |
|---|---|---|---|
| P1 紧急 | 机器无法连接、硬件故障、节点不可用 | ≤ 30 分钟 | 7×24 全年 |
| P2 受损 | 性能异常、重装卡住、网络间歇抖动 | ≤ 4 小时 | 7×24 全年 |
| P3 一般 | 使用咨询、账单疑问、配置建议 | ≤ 12 小时 | 工作日 |
可用性与赔付规则
- 单实例月度可用性承诺 99.9%,所有节点全年 365 天持续运行,没有计划内的停摆时段。
- 实测可用性每低于承诺 0.1%,赔付当月费用 5% 的等额代金券,单月赔付上限为当月该实例费用的 100%。
- 赔付在控制台提交申请,附上故障时间段即可,我们对照监控数据核算,7 个工作日内到账。
- 因不可抗力或你自身操作(如误删系统文件、改坏网络配置)导致的不可用,不计入赔付范围——但我们照样帮你修。
服务状态与公告,一页看全
新加坡、东京、韩国、香港、美西五个节点的实时可用性、历史数据和事件公告都在状态页公开;有任何影响服务的事件,进展也会在同一页面持续更新。报障之前先看它,能帮你立刻分清「平台的问题」还是「本地的问题」。
-
JP 东京实时可用性与历史曲线见状态页
-
SG 新加坡实时可用性与历史曲线见状态页
-
US-W 美西实时可用性与历史曲线见状态页