无法建立连接
先核对订单中的地址和接入方式，确认本地网络与客户端可用；再检查账号是否有该实例的授权。
如果客户端给出错误信息，保留原文与发生时间。不要反复修改多项设置，否则很难判断哪一步起作用。
准备排查记录
找到对应说明
搜索问题，或按主题进入
搜索会在本页说明中定位主题，不会查询你的订单或接入凭据。问题涉及具体实例时，请登录控制台核对。
连接之前
先确认四件事，再开始排查客户端
如果订单中的节点或接入方式与手头记录不一致，先以控制台当前显示的信息为准。不要把地址和凭据贴到公开讨论区。
- 01订单与节点确认正在查看目标实例的订单，核对所选物理节点及订单中的接入说明；不要使用另一台机器的旧记录。
- 02本地网络确认本机网络可用；如处于受限办公网络，检查其访问策略，再尝试从允许的网络发起连接。
- 03客户端设置选择订单说明适用的远程桌面客户端，并逐项核对连接方式、地址与输入格式。VNC 是桌面交互方式之一，并非所有订单的唯一方式。
- 04账号与权限确认当前使用的账号拥有该实例的访问权限；团队成员应由管理员核对授权范围，不要相互传递登录凭据。
缩小问题范围
连接异常，按现象分别检查
先记录问题从哪一步开始出现，再改变一个条件复测。网络路径、客户端和任务负载都会影响体验，本页不提供未经核实的固定延迟值。
开发环境
把系统、工具链与项目依赖分开核对
可用的 macOS 与软件版本以控制台中的物理节点信息为准。先记录现状，再按项目要求调整环境；不要把某个项目的依赖错误归因于远程连接。
macOS 版本
在桌面查看系统版本，并与项目及工具的最低要求核对。记录完整版本信息，避免只写「最新版」。
Xcode 版本
核对当前使用的 Xcode、项目要求和所需 SDK。多版本共存时，确认构建任务实际调用的是哪一个版本。
编译工具路径
运行 xcode-select -p 与 xcodebuild -version，对照预期路径和版本；修改选择前先评估对其它任务的影响。
依赖与缓存
检查锁定文件、包管理器版本与项目脚本。先用可复现的最小任务验证依赖，再决定是否清理缓存。
构建任务失败时，先找第一条有用的错误
区分代码检出、依赖安装、编译、签名和产物处理五个环节。使用 self-hosted runner 时，还要核对运行账号权限、工作目录及密钥的安全注入方式。
保留失败命令、退出状态和脱敏日志；不要把签名材料或环境变量原值写进工单。若桌面操作正常而构建失败，优先从项目日志定位。
术语对照
八个词，先把讨论对象说清楚
描述问题时使用一致的名称，能帮助你区分机器、地区、连接方式和计费选择。
- 物理节点
- 承载云端 Mac 服务的实体设备。订单中的节点信息用于辨认你选择的运行位置。
- 独享物理机
- 一台由订单独享的物理 Mac，而不是与其他用户共享的虚拟机实例。
- 云端 Mac
- 运行在远端物理节点、可按授权方式连接的 macOS 工作环境。
- VNC
- 用于查看和操作远程图形桌面的连接方式之一；具体可用方式看订单说明。
- self-hosted runner
- 由团队自行配置和管理、用于执行自动化构建任务的运行器。
- 租期
- 下单时选择的计费周期，可选天、周、月、季；以确认的订单为准。
- 节点
- 订购时选择的地区位置，不等同于固定网络速度或客户端连接地址。
- 附加存储
- 在基础配置之外选购的存储选项；规格与对应周期金额见方案页。
订单与付款
金额、周期与支付方式如何核对？
先看订单选中的租期和附加项，再核对最终显示的 USD 金额。完整周期价格与附加项目录在方案页，不用其它周期的金额推测当前订单。
订单用什么币种结算？
所有订单以美元（USD）结算。查看订单时，应将机型、租期、附加项和最终金额放在同一笔订单中核对；不同租期的目录价格分别列示，并非由日价简单相乘。
可以使用哪些付款方式？
支持 USDT-TRC20，以及经 Stripe 处理的 Visa / Mastercard / Amex。结账时实际可选的网关以后端返回为准；如支付未完成，先核对该笔订单状态，避免重复提交。
在哪里核对租期和附加项？
先在方案与价格页查看目录，再在控制台订单中核对实际所选周期、节点与附加项。订单确认信息是判断本次购买内容的依据。
提交工单前
给出可复现的信息，不发送秘密
已有订单的问题请从控制台提交工单。把已完成的检查一起写上，支持人员就能从尚未排除的环节继续查。
- 01标识与位置提供订单标识、所选节点及受影响的实例；无需复制接入凭据。
- 02时间与现象写明发生时间、时区、客户端环境、看到的错误信息，以及问题是否每次都出现。
- 03复现与检查按顺序写出操作步骤，并列出已核对的网络、权限、客户端或项目日志，避免只有「连不上」三个字。
- 04脱敏附件截图或日志只保留定位所需区域；遮盖密码、密钥、令牌、签名材料及不相关的个人信息。
请勿发送密码或密钥。需要补充材料时，只通过控制台工单继续沟通；购买前的普通问题也可发至 support@vpspush.com。