连接
找不到连接信息、主机身份提示变化、会话建立失败或初始凭据需要更新。
查看连接顺序
工程支持手册
先定位问题，再按顺序恢复云端 Mac
面向正在连接、配置或维护 RunAMac M4 的开发团队。这里给出可执行的检查顺序、完成标志与工单信息模板，不用在零散答案之间来回跳转。
- 覆盖范围
- 6 类常见问题
- 部署参考
- 约 4 分钟
- 支持对象
- 独享物理机
RUNAMAC SUPPORT RUN SHEET
问题定位运行单
先采集，后变更
INPUT
保留原始错误输出
先记录发生时间、节点、命令与完整报错，不要只保留最后一行。
CHECK
从本地链路向主机逐层排查
网络、端口、会话、环境依赖分别验证，每次只改变一个条件。
PROOF
用可重复步骤确认结果
记录成功标志或失败日志，让下一位处理者能复现同一结论。
首次连接
四次核对后再开始开发会话
连接信息以控制台交付记录为准。不要从聊天记录或旧文档复制地址，也不要跳过主机身份确认。
读取本次订单的连接信息
登录控制台，进入对应订单与实例详情，核对节点、主机地址、端口、用户名和连接方式。多个订单并存时，先确认订单编号与节点匹配。
完成标志：地址、端口与用户名均来自同一条交付记录。验证主机身份
首次建立加密连接时，客户端会显示主机指纹。将其与控制台记录核对；若已连接过却突然出现身份变化提示，先停止连接并提交工单确认。
完成标志：主机指纹与当前实例记录一致。建立命令行或图形会话
先用交付信息建立会话，再确认键盘输入、剪贴板策略与基础网络访问符合任务要求。高延迟网络下先减少画面质量，再判断是否为主机故障。
完成标志：能够稳定进入 macOS 图形界面或命令行。修改初始凭据并保存恢复信息
连接成功后立即修改初始凭据，使用团队认可的凭据管理方式保存。不要把密码、私钥或证书内容写入构建日志、工单正文与代码仓库。
完成标志：新凭据验证成功，旧凭据不再用于后续会话。
身份提示变化时不要直接覆盖本地记录
先保存提示截图、发生时间和订单编号，再通过控制台工单确认。贸然接受新的主机身份会失去一次重要的安全核验机会。
部署时间线
从订单确认到收到连接信息，约 4 分钟
每一步都对应一个可观察的完成标志。实际进度以控制台返回为准，页面刷新不会改变已经提交的订单。
-
01 约 1 分钟
订单确认
系统核对 RunAMac M4、租用周期、节点和附加选项，并生成本次订单记录。
完成标志：控制台显示订单编号与已确认配置。 -
02 约 1 分钟
分配物理节点
订单被映射到所选区域中的独享物理机，设备资源不与其他租用者共享。
完成标志：实例详情出现节点与设备标识。 -
03 约 1 分钟
系统初始化
系统准备基础访问环境并执行必要的实例检查。此时不要重复创建相同订单。
完成标志：实例状态进入可交付阶段。 -
04 约 1 分钟
交付连接信息
控制台写入主机地址、端口、用户名、主机身份信息和对应的连接说明。
完成标志：实例详情可以读取完整连接字段。
开发环境清单
先建立可重复的环境基线，再接入构建任务
RunAMac 提供独享 Mac mini 与完整 macOS 使用环境。具体软件、版本与项目依赖应由团队按构建基线确认，未在订单中列明的软件不视为已预装。
Xcode 与活动开发目录
记录项目要求的 Xcode 版本，确认活动开发目录与构建脚本一致。版本切换后重新验证 SDK、模拟器运行时和归档命令。
命令行工具
检查编译器、Git、Shell 与包管理命令是否可用。不要仅以图形界面能启动 Xcode 作为自动化构建已经就绪的依据。
证书与签名材料
确认签名证书、描述文件与钥匙串访问策略符合项目要求。敏感材料应通过受控流程导入，不进入仓库、普通日志或工单附件。
依赖与缓存
分别记录依赖锁文件、缓存目录和失效策略。首次构建先执行无缓存基线，再启用缓存比较耗时与命中结果。
持续集成执行器
核对执行器标签、工作目录、并发数量、启动方式和日志回收路径。一个执行器失败时，先确认任务是否被错误分配到其他环境。
网络排查手册
沿着连接路径逐层缩小故障范围
不要同时更换网络、客户端和连接参数。一次只改变一个条件，才能判断恢复来自哪一步。
检查本地链路
确认本地网络能稳定访问其他服务，分别测试有线、无线或备用链路。记录是否存在持续丢包、代理干预或企业网络限制。
证据：本地出口、测试时间、连续失败次数。确认目标节点
从控制台重新读取当前实例地址，避免继续使用旧订单或旧节点信息。RunAMac M4 可选择新加坡、日本（东京）、韩国（首尔）、香港、美国西部。
证据：订单编号、节点名称、目标地址。验证端口策略
确认连接端口与交付记录一致，并检查本地防火墙、公司出口策略和安全软件是否拦截。不要为了测试而永久关闭防护。
证据：端口、客户端错误码、策略变更结果。核对会话状态
判断问题发生在建立连接前、身份验证阶段，还是进入桌面后。若只有画面卡顿，分别记录输入延迟与连接中断情况。
证据：失败阶段、持续时间、是否可重复。收集诊断日志
保留客户端日志与完整错误输出，记录时区明确的时间戳。日志中若包含主机地址、用户名或路径，应在提交前做必要脱敏。
证据：日志片段、时间戳、复现步骤。
工单信息模板
让支持团队直接进入排查
按字段提供上下文，比“连接不上”更容易复现。密码、私钥、证书正文和支付凭据不要写入工单。
订单编号：
节点：
问题发生时间与时区：
连接方式与客户端版本：
完整错误输出：
已执行的检查：
最短复现步骤：
预期结果与实际结果：
存储与并联
按数据规模和设备协作方式选择附加项
先区分容量不足、读写路径不合理和多设备协作需求。附加项按所选租用周期计费，变更前应先核对数据迁移与任务中断风险。
容量扩展
+1TB SSD
适合依赖缓存、多个中型代码仓库、构建归档和测试产物需要长期保留的工作流。启用前先统计峰值占用与清理策略。
- 每天
- $2.3
- 每周
- $6.2
- 每月
- $11.4
- 每季
- $31
大容量扩展
+2TB SSD
适合大量构建产物、多项目缓存、小型 AI 实验数据和较长保留周期。容量增加不能替代备份，关键结果仍需保留独立副本。
- 每天
- $4.6
- 每周
- $12.4
- 每月
- $22.8
- 每季
- $62
设备并联
Thunderbolt 5 并联
按每台设备计费，适合明确需要设备间高速连接的协作任务。提交变更前写清设备数量、连接关系、数据方向和验收命令。
- 每天
- $1.9
- 每周
- $5
- 每月
- $9.3
- 每季
- $25.3
变更前完成三项确认
确认已用容量、运行任务和需要保留的数据路径。
核对附加项与当前租用周期，以及控制台返回的 USD 应付金额。
完成后重新检查挂载、可用容量、读写权限与任务路径。
账户与租期
用订单记录管理租期、配置与账单
控制台是查看交付、租期和应付金额的统一位置。处理多个实例时，任何变更都先核对订单编号与节点。
ORDER MANAGEMENT
控制台核对清单
ORDER
查看订单与实例
在订单详情核对 RunAMac M4、Mac Mini M4、16GB RAM、256GB SSD、节点、租期和交付记录。
TERM
确认续租
续租前检查当前周期结束时间、下一周期与 USD 应付金额，再按照控制台返回的步骤完成确认。
ADD-ON
调整附加选项
变更 +1TB SSD、+2TB SSD 或 Thunderbolt 5 并联前，先保存任务状态并确认对应计费周期。
INVOICE
下载账单
从账单记录核对基础主机、附加项、周期和总额。金额统一以 USD 结算。
仅核对两类网关
支持 USDT-TRC20，以及经 Stripe 处理的 Visa、Mastercard、Amex。实际可用网关以控制台返回为准。
已有订单优先进入控制台
交付信息、租期、账单和工单状态都与登录账户关联。
管理现有订单
升级人工支持
提交一份可以直接复现的上下文
技术问题优先通过控制台工单关联订单；售前、合作或无法登录账户时，可通过联系页整理邮件内容。
订单与节点
提供订单编号、RunAMac M4 配置与节点。若问题涉及多个实例，分别标注每台设备。
时间戳
写明问题发生时间与时区，并指出是持续发生、间歇发生，还是只出现过一次。
错误输出
粘贴完整错误文本或提供脱敏截图。不要提交密码、私钥、证书正文和其他私密凭据。
复现步骤
从一个已知初始状态开始，逐条写出命令、输入、预期结果和实际结果。
提交工单后如何继续补充信息？
在同一条控制台工单中追加新的时间戳、日志和验证结果，避免为同一问题重复创建多个工单。这样可以保留完整排查链路。
哪些内容不应放入工单或邮件？
不要提交密码、私钥、证书正文、支付凭据或未经脱敏的项目机密。需要说明路径或用户名时，只保留定位问题所需的最少信息。
无法登录控制台时如何联系团队？
前往联系页生成结构化邮件，或直接发送邮件至 support@runamac.com。请写明账户邮箱、关联订单编号和无法登录时看到的错误信息。