查看机器 IP 与凭据
登录控制台，进入对应订单或实例详情。逐项核对机型、节点、IP、用户名及连接端口，确认实例已经交付，再发起连接。团队有多台机器时，先用实例编号区分环境。
连接信息属于敏感数据。向工程师说明问题时提供实例编号即可，不要把完整凭据贴进邮件正文。
查看连接前准备开发者支持
先自己查，再找我们
先查连接、环境和账单，再提交可复现的问题。这里的步骤适用于独享物理 Mac；实例 IP、连接凭据和订单状态，请以登录后的控制台为准。
没有合适答案？可在页尾选择控制台工单或邮件联系。
尚未选机型？先核对内存、存储和计费周期，再付款开通。
首次连接
先做这三件事
把控制台里的实例信息当作唯一连接依据。不要从旧日志复制 IP，也不要在公开仓库保存密码或私钥。
完成首次 SSH 登录
按实例详情给出的地址和端口建立 SSH 会话。首次连接出现主机指纹时，先核对来源；如果曾经重装系统，旧指纹可能不再匹配，不要在未确认原因前直接忽略警告。
进入系统后先检查当前用户与工作目录，再配置密钥登录。保留当前会话，验证新会话成功后再调整认证设置，避免把自己锁在机器外。
查看 SSH 接入步骤连接 macOS 图形桌面
使用实例详情提供的 VNC 连接参数，在兼容客户端中填写地址和凭据。先用较低分辨率验证连通，再逐步提高画质；不要把图形桌面的卡顿直接等同于构建速度慢。
弱网时降低色深、关闭动态壁纸。只需跑测试或查看日志时优先使用 SSH，减少桌面图像传输带来的等待。
查看桌面连接与调优先统一术语
八个词，读懂机器与接入方式
区分物理资源、远程协议和开发工具。知道问题发生在哪一层，排查会更快。
- 物理节点
- 实际部署 Mac 的服务位置。MetalVNC 提供新加坡、东京、首尔、香港四个亚太节点。选择时考虑自己的网络路径；地理距离近，不代表每条线路的延迟都更低。
- 独享物理机
- 租期内独占整台机器的 CPU、内存与磁盘资源，不与其他租户共享这台主机。团队自行在机器上启动多个任务，仍会竞争同一台机器的资源，需要自行安排并发。
- 非虚拟机
- 工作环境运行在物理 Mac 上，而不是共享宿主上的虚拟实例。macOS 图形界面与命令行完整可用；实际构建表现仍取决于工程规模、工具链、缓存和任务并发。
- VNC
- 传输桌面画面并接收键鼠输入的远程接入方式，适合图形调试与界面检查。它不是文件同步工具；大体积源码与产物应通过合适的文件传输流程单独处理。
- SSH 密钥登录
- 用公钥与私钥完成身份验证。公钥放在远端授权列表，私钥留在受控的本地设备或流水线密钥库。不要把私钥提交进代码仓库，也不要通过工单发送。
- self-hosted runner
- 由你管理、接收持续集成任务的执行器。可以在独享节点上运行构建与测试，但注册令牌、任务权限、工作区清理和工具链版本需要由团队维护。
- 代码签名证书与描述文件
- 用于构建签名流程的敏感开发资产，不是远程登录凭据。使用前确认用途与权限，按团队安全流程导入、限制访问，并在任务结束后清理不再使用的材料。
- Thunderbolt 5 并联
- 用于多机协同的可选连接能力，不能把多台机器的内存自动变成一个统一内存池。下单前说明机器数量、数据流向与存储需求，具体可选项以配置页返回为准。
环境与生命周期
先确认边界，再修改环境
以下问题覆盖开通、系统、开发工具和数据。涉及重装、换档或到期处理时，先备份，再确认订单适用规则。
下单后多久可以连接机器？
先在控制台确认支付和订单状态，再查看实例是否已交付。交付完成后，连接参数会出现在实例详情中；不要把支付完成页面当成机器已可连接的凭据。
开通进度以控制台实时返回为准，不在这里承诺固定分钟数。如果支付状态已确认但实例仍未交付，请提交订单编号和状态截图，由工程师核查。
需要重装系统，应该先做什么？
先导出源码、构建产物和必要配置，确认备份可以在其他位置恢复。重装可能影响系统盘内容、连接凭据、主机指纹与已安装工具，不应作为普通连接故障的第一步。
通过控制台工单说明实例编号、重装原因和所需开发环境，确认支持的系统选项、数据处理范围及执行安排后再操作。页面不预设重装按钮或固定完成时间。
如何确认并切换 Xcode 版本？
先检查当前选中的开发者目录和工具版本，再核对工程所需 SDK 与模拟器运行时。安装多个版本时，可以为单次构建指定开发者目录，避免改变其他正在执行的任务。
xcode-select -p
xcodebuild -version
DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer" xcodebuild -version最后一条路径是示例，需要替换成机器上实际存在的 Xcode 目录。切换开发者目录不会自动补齐缺少的 SDK 或运行时；执行正式流水线前先跑一次小范围验证。
磁盘不够，可以增加存储吗？
可选附加项为 +1TB SSD 与 +2TB SSD。+1TB SSD 的目录价格为 $2.4/天、$6.5/周、$12.1/月、$32.9/季；+2TB SSD 为 $4.8/天、$13/周、$24.2/月、$65.8/季。
这些是附加项价格，不含机器租金。新订单在配置页选择；已交付实例请先提交工单，确认适用方式、挂载路径与数据迁移步骤。增加容量不等于自动迁移已有工作目录，操作前仍需备份。
到期后，机器里的数据保留多久？
不要把到期后的数据保留当作备份机制。请在到期前完成续费或导出数据，尤其是未推送的源码、测试结果和仅存于远端的配置。
具体保留与擦除期限，以订单适用条款和控制台通知为准；本页不另行设定天数。若实例已经到期，立即在原订单下提交工单，确认当前状态，不要假定数据仍可恢复。
团队报销需要账单凭证，怎么处理？
先在控制台查看对应订单的账单记录。需要进一步确认凭证格式或抬头信息时，在工单中提供订单编号、所需字段与用途，不要发送完整卡号。
能否提供符合你所在地区财税要求的文件，需要在付款前确认。美元账单记录与当地税务意义上的发票不是同一概念，不应直接等同。
服务可用率承诺
看承诺，也看统计口径
节点全年 365 天正常运行。这里展示服务承诺，不把尚未接入的监测记录包装成历史成绩。
月可用率目标
99.9%
月可用率低于 99.9%，按不可用时长 10 倍返还服务时长。
按月核算，不是构建成功率，也不是 VNC 画面流畅度指标。不可抗力与用户自身操作等除外项，按适用服务条款核实。
近 90 天监测记录
公开监测数据尚未接入，因此不展示正常天数、历史达标率或逐日状态。下方仅标明数据接入状态，不表示节点故障。
遇到疑似不可用，请尽早记录开始时间、时区、连接方式与错误信息，并从控制台提交工单。单次本地网络异常不能直接用于计算节点月可用率，工程师需要结合实例侧记录核查。
提交故障工单支付与对账
先核对网络与金额，再付款
全部以美元（USD）结算。支付网关是否可用，以结账时后端接口返回为准。
USDT-TRC20
只使用结账页面指定的 TRC20 网络、收款地址与应付金额。不要把其他订单的收款信息复用于当前订单，也不要凭转账截图认定订单已经完成付款。
到账需要链上确认及网关回传，耗时受网络与支付服务处理影响，没有固定分钟数。已转账但状态未更新时，先保存交易哈希，再通过工单提交订单编号和转账网络，避免重复付款。
确认依据：订单支付状态Visa / Mastercard / Amex
卡支付经 Stripe 处理，以结账页面的金额和支付结果为准。如发卡行要求验证，请完成对应步骤，再返回控制台检查账单状态。
出现失败提示时，记录错误文案与订单编号，不要在短时间内连续重复尝试。工单中只需描述卡种和失败步骤，不能发送完整卡号、安全码或验证信息。
结算币种：USD续费前检查两项
确认续费对象是正确实例，再核对账期与附加项。页面支持按天、周、月、季计费，但不应把不同周期的总价当成同一周期价格比较。付款后的实际到期时间，请回到控制台核对。
-
01
标明对象
提供订单或实例编号、节点、连接方式。不要提供密码、私钥或完整支付凭据；截图中应遮挡敏感字段。
-
02
写清现象
记录发生时间与时区、最后一次成功操作，以及当前影响范围。区分“只有 VNC 卡顿”“SSH 也无法连接”和“构建命令报错”。
-
03
附上复现步骤
按实际顺序写出命令、预期结果和错误摘要。说明是否更换过本地网络、修改过端口或切换过工具链，不必上传整个项目。
| 问题类别 | 提交时重点说明 | 目标响应口径 |
|---|---|---|
| 一般问题 | 选型、账单字段、工具链配置；说明期望完成的任务。 | 具体目标响应时间以工单内确认的信息为准，本页不承诺固定小时数。 |
| 实例故障 | 无法连接、运行异常；提供发生时间、影响范围和已完成的检查。 | 按业务影响与实例侧核查结果分流；首次回复不等于修复完成，后续进度在原工单跟踪。 |
还没找到答案
告诉我们你卡在哪一步
选型问题说用途，连接问题带错误信息。已有工单请在原线程补充，避免把同一个问题拆成多份上下文。