guides://search — 支持中心

遇到问题,先在这里自己修

> 输入问题,或从下方窗口开始。多数问题 5 分钟内可自助解决。

没有匹配的条目。换一个关键词试试,或直接发邮件到 support@opsmac.com,把报错原文贴给我们。

guides://quick-start

快速入门:从开机到接入的五篇指南

付款后约 4 分钟,凭据会送达你的邮箱。按下面五篇的顺序走一遍,从第一次登录到接入 CI,全程不需要找人。

首次开机

凭据邮件里有什么、拿到后先做哪三件事、如何确认机器已就绪。

查看步骤 →

修改凭据

首次登录后立刻改掉初始密码与 VNC 密码,并切换到密钥登录。

查看步骤 →

SSH 首连

一条命令登进你的独享物理机,指纹确认与免密配置。

查看步骤 →

VNC 远程桌面

打开 macOS 图形桌面:开启屏幕共享、客户端参数与分辨率建议。

查看步骤 →

接入 self-hosted runner

把 CI 构建任务派发到这台机器:注册、打标签、常驻守护三步。

查看步骤 →
guides://quick-start — 5 篇 · 展开即读
首次开机:拿到凭据邮件后的前 5 分钟

付款确认后,系统自动分配一台独享物理 Mac mini 并初始化 macOS,凭据邮件通常在 4 分钟左右送达,内含:节点 IP、系统账户名、初始密码、VNC 端口。收到后按顺序做三件事:

  1. 用邮件里的 IP 和账户 SSH 登录一次,确认机器在线、账户可用(命令见下方「SSH 首连」)。
  2. 立刻修改初始密码与 VNC 密码(步骤见「修改凭据」)——初始密码只用这一次。
  3. 在控制台确认实例状态为「运行中」,并核对节点与机型和订单一致。

机器交付时已预装 Xcode 与常用命令行工具,macOS 图形界面与命令行完整可用,不需要额外激活步骤。

修改凭据:改掉初始密码,换上密钥
  1. SSH 登录后执行 passwd,按提示输入旧密码与新密码,修改系统账户密码。
  2. VNC 密码单独改:图形桌面进入「系统设置 → 通用 → 共享 → 屏幕共享」,在选项里更新访问密码。
  3. 把本地公钥追加到机器的 ~/.ssh/authorized_keys,之后即可免密登录;确认密钥可用后,建议在 sshd_config 中关闭密码登录。
terminal — passwd
passwd
Changing password for opsmac.
Old Password: ********
New Password: ************
passwd: password updated successfully

此设备为独享物理机,凭据只发给你一个人;凭据保管责任在用户侧,泄露后请第一时间改密并提交工单。

SSH 首连:一条命令登进你的 Mac
  1. 打开本地终端(Windows 用 PowerShell 或 Windows Terminal 均可),执行 ssh 账户名@节点IP
  2. 首次连接会提示确认主机指纹,输入 yes 回车,指纹会记入本地 known_hosts,之后不再询问。
  3. 输入邮件里的初始密码,看到 shell 提示符即登录成功;随后按「修改凭据」换密钥。
terminal — ssh
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 图形界面
  1. 机器交付时屏幕共享默认已开启;若被关闭,可 SSH 登录后在「系统设置 → 通用 → 共享」重新打开。
  2. 本地装任意标准 VNC 客户端,地址填 节点IP:VNC端口(端口在凭据邮件里),密码用 VNC 密码。
  3. 建议分辨率 1920×1080、色彩质量「中」起步;跨境链路上先求流畅,再按需调高。
  4. macOS 用户也可直接在访达按 ⌘K,输入 vnc://节点IP 用系统自带屏幕共享连接。

图形桌面与命令行可以同时用:Xcode 界面操作走 VNC,构建脚本走 SSH,互不影响。

接入 self-hosted runner:三步进入 CI 池
  1. 在你的代码托管平台仓库设置里新建 self-hosted runner,拿到注册令牌。
  2. SSH 登录云端 Mac,下载 runner 包后执行 config.sh 注册,标签建议按「系统 + 芯片 + 用途」设计,方便工作流精确指派。
  3. svc.sh 装成常驻服务(底层是 launchd),机器重启后 runner 自动回到在线状态。
terminal — 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。守护配置详解见 「怎么连上」页 →

guides://glossary

术语小词典:7 个词,读懂产品页

产品页与账单里反复出现的词,每条两句话讲清。看懂它们,选型基本不会踩坑。

glossary://terms — 7 entries
物理节点 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 交给测试者安装。
troubleshoot://checklist

故障排查:先照单自查,再开工单

四类最常见的问题,每类给一张按顺序执行的自查清单。经验上,80% 的情况走不到最后一步就解决了。

troubleshoot://common — 4 类常见问题
SSH 连不上:超时或被拒绝
  1. ping 节点IP。四节点全年在线,ping 不通大概率是本地网络或出口限制,换网络环境再试。
  2. 测端口:nc -vz 节点IP 22。端口不通而 ping 通,检查你是否改过 sshd 端口或防火墙规则。
  3. 报 Permission denied:确认账户名拼写,检查本地私钥权限为 chmod 600,并确认公钥仍在机器的 authorized_keys 里。
  4. 登录控制台查看实例状态;若显示异常,直接在控制台执行重启,约 1 分钟内恢复。
  5. 以上全过,仍连不上:带上 ssh -v 节点IP 的完整输出提交工单,定位会快很多。
VNC 黑屏:连上了但看不到桌面
  1. 先确认 SSH 能登录——能登说明机器在线,问题只在显示服务这一层。
  2. SSH 执行 sudo launchctl kickstart -k system/com.apple.screensharing 重启屏幕共享服务,再重连。
  3. 黑屏但有鼠标:多半停在锁屏界面,直接键入账户密码回车即可进入桌面。
  4. 画面卡成杂色或刷新极慢:把客户端色彩质量调低、分辨率降到 1920×1080。
  5. 换一个客户端交叉验证(macOS 自带屏幕共享,或任意标准 VNC 客户端);两个都黑,提交工单并注明重启服务的执行结果。
runner 掉线:CI 平台显示 offline
  1. SSH 登录后在 runner 目录执行 ./svc.sh status,确认守护进程是否存活;停了就 ./svc.sh start
  2. _diag 目录里最新的日志文件,搜 error 关键字,多数掉线原因日志里写得很直白。
  3. 日志提示鉴权失败:注册令牌已失效,执行 ./config.sh remove 后用新令牌重新注册。
  4. 任务跑一半掉线:检查是不是并发任务把内存吃满。16GB 机型建议单并发;常驻多并发请用 64GB 的 M4 Pro Workstation。
  5. 确认是用 svc.sh 装的常驻服务而不是前台 run.sh——前台方式在 SSH 断开后进程会退出。
重装 macOS:把系统恢复到出厂状态
  1. 重装会擦除机内全部数据。先把构建产物、证书与配置备份到你自己的存储,备份责任在用户侧。
  2. 登录控制台提交「重装 macOS」工单,注明订单号与节点;不需要邮件重复提交。
  3. 重装期间实例暂不可用;完成后新凭据自动送达邮箱,按「首次开机」流程重新初始化即可。
  4. 重装属于用户主动操作,计费周期照常计算,不触发补时。
billing://faq

计费与账单:到账时间与账单怎么读

价格全部以美元列出,天/周/月/季四档周期,加购项随主周期同步计费。这里只讲支持侧最常被问到的两件事。

账单看不懂每一行?

「多少钱」页有一张逐行标注的示例账单(账单解剖块):周期、节点、加购行、合计,每一项对应什么、续费与到期口径如何,都标在行边。例如 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)结算;实际可用网关以下单时接口返回为准。

USDT·TRC20 VISA AMEX stripe
ticket://sla

工单与响应:找人之前,先带齐信息

自查清单走完还没解决,就该找人了。渠道只有两个,信息带齐一次,通常就不需要来回补充。

控制台工单(推荐)

登录控制台提交工单,自动关联你的订单与实例,处理最快。多数工单在数小时内首次响应,24 小时内给出处理方案。

登录控制台提交工单

邮箱 support@opsmac.com

适合售前咨询、账户无法登录等进不了控制台的情况,24 小时内回复。请写清主题,报错原文直接贴正文。

support@opsmac.com

提交前带齐四件事

节点(如东京)、机型(M4 Home / M4 Pro Workstation)、订单号、问题描述与复现步骤。有日志或 ssh -v 输出的,一并附上。

复杂问题?去「找谁聊」→
status://nodes

系统公告:节点状态与故障通报

与首页通知中心同一份口径:四个物理节点全部在线,全年不预留任何离线时段。

status://nodes — 4/4 online
新加坡SG-01 · Singapore
online
日本(东京)JP-01 · Tokyo
online
韩国(首尔)KR-01 · Seoul
online
香港HK-01 · Hong Kong
online

365 天全年可用。若发生硬件或网络故障,我们通过邮件与控制台横幅通报进度,并按「补时长」口径补偿受影响的租期——具体条款见 规则是什么