遇到问题,先在这里自己修
> 输入问题,或从下方窗口开始。多数问题 5 分钟内可自助解决。
没有匹配的条目。换一个关键词试试,或直接发邮件到 support@opsmac.com,把报错原文贴给我们。
快速入门:从开机到接入的五篇指南
付款后约 4 分钟,凭据会送达你的邮箱。按下面五篇的顺序走一遍,从第一次登录到接入 CI,全程不需要找人。
首次开机:拿到凭据邮件后的前 5 分钟
付款确认后,系统自动分配一台独享物理 Mac mini 并初始化 macOS,凭据邮件通常在 4 分钟左右送达,内含:节点 IP、系统账户名、初始密码、VNC 端口。收到后按顺序做三件事:
- 用邮件里的 IP 和账户 SSH 登录一次,确认机器在线、账户可用(命令见下方「SSH 首连」)。
- 立刻修改初始密码与 VNC 密码(步骤见「修改凭据」)——初始密码只用这一次。
- 在控制台确认实例状态为「运行中」,并核对节点与机型和订单一致。
机器交付时已预装 Xcode 与常用命令行工具,macOS 图形界面与命令行完整可用,不需要额外激活步骤。
修改凭据:改掉初始密码,换上密钥
- SSH 登录后执行
passwd,按提示输入旧密码与新密码,修改系统账户密码。 - VNC 密码单独改:图形桌面进入「系统设置 → 通用 → 共享 → 屏幕共享」,在选项里更新访问密码。
- 把本地公钥追加到机器的
~/.ssh/authorized_keys,之后即可免密登录;确认密钥可用后,建议在sshd_config中关闭密码登录。
passwd Changing password for opsmac. Old Password: ******** New Password: ************ passwd: password updated successfully
此设备为独享物理机,凭据只发给你一个人;凭据保管责任在用户侧,泄露后请第一时间改密并提交工单。
SSH 首连:一条命令登进你的 Mac
- 打开本地终端(Windows 用 PowerShell 或 Windows Terminal 均可),执行
ssh 账户名@节点IP。 - 首次连接会提示确认主机指纹,输入
yes回车,指纹会记入本地 known_hosts,之后不再询问。 - 输入邮件里的初始密码,看到 shell 提示符即登录成功;随后按「修改凭据」换密钥。
ssh opsmac@203.0.113.24 The authenticity of host '203.0.113.24' can't be established. Are you sure you want to continue connecting (yes/no)? yes opsmac@mini-sg-01 ~ %
完整的密钥上传、安全加固与来源 IP 限制,见 「怎么连上」页的分步指南 →
VNC 远程桌面:打开 macOS 图形界面
- 机器交付时屏幕共享默认已开启;若被关闭,可 SSH 登录后在「系统设置 → 通用 → 共享」重新打开。
- 本地装任意标准 VNC 客户端,地址填
节点IP:VNC端口(端口在凭据邮件里),密码用 VNC 密码。 - 建议分辨率 1920×1080、色彩质量「中」起步;跨境链路上先求流畅,再按需调高。
- macOS 用户也可直接在访达按 ⌘K,输入
vnc://节点IP用系统自带屏幕共享连接。
图形桌面与命令行可以同时用:Xcode 界面操作走 VNC,构建脚本走 SSH,互不影响。
接入 self-hosted runner:三步进入 CI 池
- 在你的代码托管平台仓库设置里新建 self-hosted runner,拿到注册令牌。
- SSH 登录云端 Mac,下载 runner 包后执行
config.sh注册,标签建议按「系统 + 芯片 + 用途」设计,方便工作流精确指派。 - 用
svc.sh装成常驻服务(底层是 launchd),机器重启后 runner 自动回到在线状态。
./config.sh --url 你的仓库地址 --token 注册令牌 --labels macos,m4,selfhosted ./svc.sh install && ./svc.sh start √ Connected to server. Listening for Jobs
并发建议:M4 Home(16GB)跑单并发最稳;需要多任务并行,选 64GB 的 M4 Pro Workstation。守护配置详解见 「怎么连上」页 →
术语小词典:7 个词,读懂产品页
产品页与账单里反复出现的词,每条两句话讲清。看懂它们,选型基本不会踩坑。
- 物理节点 node
- 一台真实摆在机房机架上的 Mac mini 整机。你租到的就是这台机器本身,而不是从它切出来的一小块。
- 独享 dedicated
- 租期内整台机器的 CPU、统一内存、SSD 与带宽只归你一人,没有邻居抢占,构建耗时可预期。
- 非虚拟机 non-virtualized
- macOS 直接运行在 Apple Silicon 硬件上,中间没有虚拟化层。性能零折损,Xcode 的构建耗时就是真机耗时。
- VNC screen sharing
- macOS 原生支持的图形远程桌面协议。装任意标准 VNC 客户端,就能像坐在机器前一样操作整个桌面。
- self-hosted runner CI
- 自托管的 CI 执行器。注册到你的云端 Mac 后,GitHub Actions 等平台的构建任务就会派发到这台独享物理机上执行。
- 统一内存 unified memory
- Apple Silicon 的 CPU 与 GPU 共用同一块高带宽内存。64GB 机型可以直接装下中等规模的 MLX 推理模型。
- TestFlight beta 分发
- Apple 官方的测试版分发工具。在云端 Mac 上用 fastlane 出包后,可以直接上传 TestFlight 交给测试者安装。
故障排查:先照单自查,再开工单
四类最常见的问题,每类给一张按顺序执行的自查清单。经验上,80% 的情况走不到最后一步就解决了。
SSH 连不上:超时或被拒绝
- 先
ping 节点IP。四节点全年在线,ping 不通大概率是本地网络或出口限制,换网络环境再试。 - 测端口:
nc -vz 节点IP 22。端口不通而 ping 通,检查你是否改过 sshd 端口或防火墙规则。 - 报 Permission denied:确认账户名拼写,检查本地私钥权限为
chmod 600,并确认公钥仍在机器的 authorized_keys 里。 - 登录控制台查看实例状态;若显示异常,直接在控制台执行重启,约 1 分钟内恢复。
- 以上全过,仍连不上:带上
ssh -v 节点IP的完整输出提交工单,定位会快很多。
VNC 黑屏:连上了但看不到桌面
- 先确认 SSH 能登录——能登说明机器在线,问题只在显示服务这一层。
- SSH 执行
sudo launchctl kickstart -k system/com.apple.screensharing重启屏幕共享服务,再重连。 - 黑屏但有鼠标:多半停在锁屏界面,直接键入账户密码回车即可进入桌面。
- 画面卡成杂色或刷新极慢:把客户端色彩质量调低、分辨率降到 1920×1080。
- 换一个客户端交叉验证(macOS 自带屏幕共享,或任意标准 VNC 客户端);两个都黑,提交工单并注明重启服务的执行结果。
runner 掉线:CI 平台显示 offline
- SSH 登录后在 runner 目录执行
./svc.sh status,确认守护进程是否存活;停了就./svc.sh start。 - 翻
_diag目录里最新的日志文件,搜 error 关键字,多数掉线原因日志里写得很直白。 - 日志提示鉴权失败:注册令牌已失效,执行
./config.sh remove后用新令牌重新注册。 - 任务跑一半掉线:检查是不是并发任务把内存吃满。16GB 机型建议单并发;常驻多并发请用 64GB 的 M4 Pro Workstation。
- 确认是用
svc.sh装的常驻服务而不是前台run.sh——前台方式在 SSH 断开后进程会退出。
重装 macOS:把系统恢复到出厂状态
- 重装会擦除机内全部数据。先把构建产物、证书与配置备份到你自己的存储,备份责任在用户侧。
- 登录控制台提交「重装 macOS」工单,注明订单号与节点;不需要邮件重复提交。
- 重装期间实例暂不可用;完成后新凭据自动送达邮箱,按「首次开机」流程重新初始化即可。
- 重装属于用户主动操作,计费周期照常计算,不触发补时。
计费与账单:到账时间与账单怎么读
价格全部以美元列出,天/周/月/季四档周期,加购项随主周期同步计费。这里只讲支持侧最常被问到的两件事。
账单看不懂每一行?
「多少钱」页有一张逐行标注的示例账单(账单解剖块):周期、节点、加购行、合计,每一项对应什么、续费与到期口径如何,都标在行边。例如 M4 Home月付 $97.1,加购 1TB SSD 月付 $14.1,各自单独成行。
打开账单解剖块 →付了款,多久开机?
卡支付(Visa / Mastercard / Amex,经 Stripe)授权即时确认;USDT-TRC20 需等待链上确认,通常 1~3 分钟。两种方式确认到账后系统自动分配机器,从付款到凭据送达合计约 4 分钟。超过 15 分钟未开通,带交易哈希或支付回执提交工单。
查看完整报价 →本机仅接受 USDT-TRC20 与 Visa / Mastercard / Amex(经 Stripe),一律以美元(USD)结算;实际可用网关以下单时接口返回为准。
工单与响应:找人之前,先带齐信息
自查清单走完还没解决,就该找人了。渠道只有两个,信息带齐一次,通常就不需要来回补充。
系统公告:节点状态与故障通报
与首页通知中心同一份口径:四个物理节点全部在线,全年不预留任何离线时段。
365 天全年可用。若发生硬件或网络故障,我们通过邮件与控制台横幅通报进度,并按「补时长」口径补偿受影响的租期——具体条款见 规则是什么。
最近更新:实战教程与选型笔记
指南之外的长文都在博客:按月归档,教程附耗时实测。以下是最近三个月的更新。
账户隔离、屏幕共享排班、构建任务错峰,以及独享物理机为什么更适合这种用法。
iOS 新版本适配测试:租一周云端 Mac 的最短路径适配窗口期用按周计费的 M4 装最新 Xcode 跑完回归清单,不打断本地开发环境。
CI/CD 流水线接入云 Mac:self-hosted runner 完整走一遍标签设计、并发控制、缓存策略与守护进程配置,附与共享虚拟机方案的构建耗时对比。
从 match 管理证书到 gym 出包再上传 TestFlight,含常见签名报错的排查清单。
按天计费的云端 Mac,到底适合哪些团队四档周期与真实团队画像逐一对齐,附一张周期决策图,帮你判断哪一档最不浪费预算。