1. 云主机
  2. 使用支持
04 Support

SSH 连接、Xcode 构建与 Runner 配置:自助支持文档

先查文档再提工单。连接、签名、VNC 这三类高频问题,多数能在本页 10 分钟内自查解决;解决不了的,页尾告诉你怎么提一张让工程师一次看懂的工单。

快速上手

快速上手三步

下单后平均 5 分钟,凭据邮件到达。照下面三步走,第一次连接不超过 3 分钟。

01

收到凭据邮件

邮件包含节点地址(如 hk1.oncemini.com)、SSH 端口 22、初始账号 dev、初始密码与 VNC 密码。没收到先查垃圾箱,再到控制台实例详情页查看。

02

SSH 首次登录并改密

执行 ssh -p 22 dev@节点地址,登录后立刻运行 passwd 改掉初始密码;建议随后用 ssh-copy-id 上传公钥,再关闭密码登录。

03

VNC 连接图形界面

用 macOS 自带屏幕共享或任意 VNC 客户端连接 节点地址:5900,输入 VNC 密码即进入完整 macOS 桌面。首次配对 Xcode、批准弹窗都在这里完成。

交付即含 root 权限:sudo 全程可用,系统层配置随便改。改崩了也不怕——控制台可自助重装 macOS,见下方指南。
终端实录

从登录到上传:一条链路跑完

下面是一台香港节点 Mini M(M4 / 24GB)上的真实输出节选:SSH 登录、Xcode 构建、fastlane 上传 App Store Connect。右侧命令可直接复制。

dev@mini-hk1 — zsh — 96×28 
ssh -p 22 dev@hk1.oncemini.com
Last login: Mon Jul 27 09:12:33 2026 from 203.0.113.24
sw_vers
ProductName:    macOS
ProductVersion: 15.5
BuildVersion:   24F74
xcodebuild -scheme App -configuration Release -destination 'generic/platform=iOS' build
▸ Compiling AppDelegate.swift
▸ Linking App
▸ Signing App.app
** BUILD SUCCEEDED ** [128.4s]
bundle exec fastlane release
[10:24:08] Login to App Store Connect (API key)
[10:26:41] Upload progress: 100%
Successfully uploaded package to App Store Connect
dev@mini-hk1 ~ %

常用命令 · 点击复制

ssh -p 22 dev@hk1.oncemini.com
passwd
ssh-copy-id -i ~/.ssh/id_ed25519.pub dev@hk1.oncemini.com
sudo xcode-select -s /Applications/Xcode_16.4.app
xcodebuild -scheme App -configuration Release build
security unlock-keychain login.keychain-db

把 hk1 换成你的节点前缀即可,各节点域名见节点分布。你本地跑得通的 CI 脚本,搬上来原样可跑。

使用指南

常见任务指南

四个最常被问到的任务,按步骤照做即可。每条指南都在真实机器上验证过。

多版本 Xcode 与切换

  1. 交付镜像预装两个稳定版 Xcode,按版本号命名放在 /Applications/Xcode_16.4.app、/Applications/Xcode_15.4.app。
  2. 查看当前激活版本:xcodebuild -version。
  3. 全局切换:sudo xcode-select -s /Applications/Xcode_15.4.app。
  4. CI 里别改全局,用环境变量单次指定:DEVELOPER_DIR=/Applications/Xcode_16.4.app xcodebuild …。
  5. 需要其他版本(含 beta)提交工单说明版本号,预装库覆盖 15.0 起的全部正式版,工作时段内通常 2 小时推送到机器。

配置 GitHub Actions self-hosted runner

  1. 仓库 Settings → Actions → Runners → New self-hosted runner,系统选 macOS、架构选 ARM64。
  2. 照页面给出的命令下载解压 runner 包,执行 ./config.sh --url … --token … 完成注册。
  3. 注册为常驻服务:./svc.sh install && ./svc.sh start,机器重启后 launchd 自动拉起。
  4. workflow 里写 runs-on: [self-hosted, macOS, ARM64];多台机器建议加自定义 label 区分。
  5. 并发参考:Mini M(24GB)稳定跑 2 个并发 job;更高并发选 Mini Pro(64GB),见租用方案。

挂载真机远程调试

  1. 测试 iPhone 与云 Mac 不在同一局域网,先用 WireGuard 等组网工具把设备和主机拉进同一网段。
  2. 首次配对在 Xcode 的 Devices and Simulators 窗口完成,经 VNC 图形界面操作一次即可。
  3. 配对时勾选网络调试,之后 xcodebuild -destination 'platform=iOS,name=设备名' 可直接指定真机。
  4. 只跑单元测试和模拟器 UI 测试不需要真机,交付即可用,不用做任何组网。

重装 macOS

  1. 登录控制台 → 实例详情 → 重装系统,可选 macOS 14 / 15 两个大版本。
  2. 重装会清空整盘且不可恢复,先在控制台下载快照再操作。
  3. 全程自助,平均 10 分钟回到待登录状态,新凭据自动重置并邮件重发。
  4. 不限次数、不额外收费。系统被改崩、想换大版本、退租前想手动清盘,都走这条路。
术语速查

术语小词典

文档和工单沟通里高频出现的八个词,统一口径,避免鸡同鸭讲。

物理节点
整台物理 Mac mini 直接交付,操作系统跑在真实硬件上,没有虚拟化层,性能零折损。
独享
一台机器同一时间只属于一个租户。CPU、内存、SSD、1Gbps 带宽都不与任何人分摊。
VNC
远程图形界面协议。连上后看到的就是完整 macOS 桌面,配对设备、点系统弹窗全靠它。
self-hosted runner
注册在你自己机器上的 CI 执行器。GitHub Actions / GitLab CI 的 macOS 任务由这台 Mac 直接执行,不排官方队列。
统一内存
Apple Silicon 的 CPU 与 GPU 共享同一块内存池。64GB 机型可直接加载大体量量化模型,不受独立显存限制。
Apple Silicon
Apple 自研 ARM 架构芯片(本站为 M4 / M4 Pro)。iOS 真机构建、MLX 与 CoreML 实验都以它为原生目标。
快照
整盘数据的打包镜像。可在控制台随时创建并下载到本地,重装、退租、换节点前的保险丝。
SLA
服务可用率承诺,本站为 99.9%。不达标按口径赔付时长,细则见安全承诺。
故障排查

故障自查清单

三类问题占了工单总量约七成。按顺序逐条排查,大多数在第 2、3 步就能定位。

SSH 连不上

  1. 控制台确认实例状态为 running,电源指示正常。
  2. 本地 ping / mtr 节点域名,丢包高先换网络,或用节点分布页的测试 IP 复验线路。
  3. 核对端口 22 与用户名 dev;跑 ssh -v 看握手停在哪一步。
  4. 自己改过 sshd_config 被锁在门外:控制台强制重启,再走 VNC 进桌面改回配置。
  5. 仍失败:把 ssh -vvv 完整输出贴进工单。

构建签名报错

  1. errSecInternalComponent 或钥匙串访问失败:先执行 security unlock-keychain login.keychain-db。
  2. CI 会话默认不解锁钥匙串,在脚本开头加解锁命令,或改用 fastlane match 管理证书。
  3. 确认证书已导入:security find-identity -v -p codesigning 应列出你的签名身份。
  4. 报 unsupported SDK 多半是 Xcode 版本不匹配,按上文指南切换版本再试。

VNC 黑屏

  1. 先试 SSH——能登录说明系统正常,只是显示服务的问题,别急着重装。
  2. SSH 里重启屏幕共享服务:sudo launchctl kickstart -k system/com.apple.screensharing。
  3. 分辨率过高会导致黑屏或花屏,客户端降到 1920×1080 重连。
  4. 无效则控制台重启实例。主机自带虚拟显示器,重启后即恢复画面。
工单支持

工单与响应时效

支持团队覆盖 UTC+8 与 UTC-8 双时区轮值。渠道只有两个:控制台工单与支持邮箱,没有电话和在线聊天。

控制台工单(首选)

路径:登录控制台 → 工单 → 新建,选择关联实例。工单自动附带实例上下文,处理最快。适用:实例故障、Xcode 版本请求、升降配、重装协助。

  • 写清实例 ID、节点与问题发生时间点
  • 贴完整命令与报错输出,用文本别用截图
  • 列出已按本页清单排查过的步骤,避免来回问

支持邮箱

登录不了控制台、账务与发票问题、下单前的技术疑问,发邮件到 support@oncemini.com。标题写清主题,正文附注册邮箱,便于关联账号。

  • 用注册邮箱发送,免去身份核验往返
  • 更多联系场景与写信模板见联系我们
问题类型 首次响应 覆盖时段 建议渠道
紧急故障(实例宕机、完全无法连接) 30 分钟 7×24 控制台工单,标记紧急
一般技术问题(构建、配置、性能) 2 小时 工作时段(UTC+8 / UTC-8 轮值) 控制台工单
账务、发票与下单前咨询 1 个工作日 工作时段 support@oncemini.com
运行状态

运行状态与通知机制

常见问题

计费与账务常见问题

连接与构建问题看上面,这里回答钱和数据的问题。价格详情见租用方案。

计费从什么时候开始起算?

从凭据邮件送达那一刻起算,不是下单时刻。按天档以 24 小时为一天,交付平均 5 分钟,这段时间不计费。

怎么续费?会自动扣款吗?

控制台实例详情页可随时手动续费,也可打开自动续费开关。到期前 72 小时和 24 小时各发一封提醒邮件。自动续费失败(如卡片过期)会立即邮件告知,并保留 72 小时缓冲期。

到期没续费,数据会立刻删除吗?

不会。到期后实例先停止,数据保留 72 小时,期间续费即原样恢复。超过 72 小时执行 APFS 加密卷密钥销毁加全盘覆写,不可恢复,流程详见安全承诺。

怎么把旧机器的数据迁到新机器?

两台机器都在租期内时,直接机对机同步最快:rsync -avz -e "ssh -p 22" ~/work/ dev@新节点:~/work/,同区节点内网速率可跑满千兆。也可以先在控制台下载快照到本地,再恢复到新机。

支持哪些支付方式?

全站以美元计价结算。支持 USDT-TRC20 与 Visa / Mastercard / Amex(Stripe),具体以控制台结算页列出的方式为准。没有隐藏流量费,账单金额即方案标价。

能开发票吗?

每笔支付自动生成 PDF 账单收据,控制台账单页随时下载。需要指定企业抬头或补充税号信息,邮件 support@oncemini.com,1 个工作日内处理。

租用中途想升级配置,怎么算钱?

升级按剩余周期差价折算,只补差额不重复计费。在控制台提交升配请求,数据经快照迁移到新机型,期间旧机保持可用。降配需等当前周期结束后换档。

首单不满意能退款吗?

首单交付后 24 小时内可申请全额退款,续费周期不退。建议先按天租 $19.9 试 1 天,跑一遍自己的构建脚本再决定是否包月。

重装 macOS 收费吗?次数有限制吗?

免费,不限次数,全程控制台自助,平均 10 分钟完成。唯一要注意:重装清空整盘,先下载快照。

一个账号能租多台吗?能转租给别人吗?

一个账号可同时租多台,团队常见做法是按项目各租一台并用 label 区分 runner。转租、倒卖给第三方违反服务条款,查实会终止服务;团队内部多人共用同一台不受限。

$ oncemini ticket new --priority normal

文档没覆盖你的问题?

登录控制台提交工单,工作时段 2 小时内有人回你;还没有机器,先按天租一台试起。

登录控制台提交工单 查看租用方案与价格