订单与主机状态
核对订单标识、租期、主机状态和交付信息。新购、续租与主机管理在控制台完成，实际可用状态以控制台实时返回为准。
从状态确认开始
先定位问题，再提交能直接处理的材料。
适用于 MiniDebug 云端 Mac 的开通、连接、系统登录、Xcode 构建、存储附加项、续租与释放流程。先完成页面中的本地检查，再通过控制台工单提交订单上下文和脱敏日志。
支持范围
先判断问题落在哪一层。
远程连接失败、构建失败与订单状态异常可能呈现相似结果，但检查入口不同。以下六类问题均可通过控制台工单反馈。
节点与远程连接
覆盖新加坡、日本（东京）、韩国（首尔）、香港、美国东部五个节点的地址、端口、网络路径和远程会话排查。
系统登录与权限
检查首次登录、凭据更新、SSH 密钥、图形会话权限与账户访问范围。多人协作时应使用可追踪的独立凭据。
构建环境
按 Xcode 版本、命令行工具、依赖缓存、签名材料、磁盘空间与构建日志定位 xcodebuild 或 fastlane 任务。
存储附加项
确认订单选择的存储容量、挂载状态、剩余空间和任务目录。磁盘不足时先清理可再生成缓存，再判断是否需要调整配置。
续租与释放
续租前核对周期和附加项；释放前完成代码、证书、模型、素材与构建产物备份，并确认自动化任务已停止写入。
首次开通路径
用五步完成首次连接验证。
不要从保存过的旧地址开始尝试。每份订单都应以控制台显示的主机状态与连接信息为准。
-
01
输入：订单标识
查看订单与主机状态
登录控制台，打开对应订单，确认机型为 MiniDebug M4，配置为 M4、16GB RAM、256GB SSD，并记录所选节点。主机状态未达到可连接阶段时，不反复尝试远程登录。
-
02
输出：连接参数
获取本次订单的连接信息
复制目标地址、端口、账户和支持的连接方式。地址与端口应作为一组保存，不要把 SSH 参数与 VNC 或屏幕共享参数混用。
-
03
验证：主机身份
完成首次系统登录
优先从受信任的本地设备发起连接。首次 SSH 连接应核对主机指纹；图形连接应确认目标节点与订单一致，不在共享设备上保存凭据。
-
04
动作：更新凭据
更新凭据与访问范围
登录后立即更新初始凭据，SSH 自动化优先使用密钥。团队使用时限制授权成员范围，避免多人长期共用同一账户或在脚本中写入明文密码。
-
05
结果：基础环境可用
验证网络与构建基础环境
检查代码仓库访问、DNS 解析、磁盘空间、Xcode 路径与命令行工具。先执行轻量验证命令，再拉取完整依赖或启动耗时构建。
构建故障分流
从第一条稳定复现的错误开始。
日志末尾通常只是任务终止结果。应向上查找第一条稳定出现的错误，并将问题归入以下六类，再决定修改项目还是提交基础设施工单。
先区分身份、目标与导出阶段
- 确认构建目标、Bundle Identifier 与签名配置一致。
- 检查 archive 成功后是否在 export 阶段失败。
- 记录首条签名错误及其前后各 20 行日志。
处理方向：项目签名设置由用户核对；若签名材料无法读取，再检查文件权限与自动化注入路径。
核对有效性、匹配关系与读取权限
- 确认所需文件已放入当前任务实际使用的位置。
- 检查证书、描述文件与目标环境是否匹配。
- 避免把密码、证书原文件或完整密钥写入工单。
处理方向：先在交互会话中验证读取，再复现自动化任务，比较两者环境变量和执行账户。
让图形界面与命令行使用同一工具链
- 记录 Xcode 版本、SDK 版本和目标平台。
- 执行
xcode-select -p核对当前路径。 - 检查 CI 进程是否继承了预期的开发者目录。
处理方向：先固定版本和路径，再清理与新版本不兼容的派生数据，不同时改动多个变量。
先验证锁文件，再判断是否清缓存
- 保留依赖锁文件并记录包管理工具版本。
- 比较干净目录构建与缓存命中构建的差异。
- 仅清理可再生成目录，不删除未备份的项目文件。
处理方向：缓存问题应能通过空缓存复现对照确认；网络下载失败则另行记录目标、时间与错误码。
同时看总容量、可用空间与大目录
- 检查工作目录、派生数据、归档与依赖缓存占用。
- 确认日志和临时文件是否持续增长。
- 清理前先确认产物已归档并可从其他位置恢复。
处理方向：优先删除可再生成缓存；长期容量需求应在后续订单中核对存储附加项。
保留命令、时间与第一条错误
- 附触发方式、执行目录和已脱敏的完整命令。
- 记录问题发生时间并注明时区。
- 同时提供预期结果、实际结果与复现频率。
处理方向：优先提交文本日志，不只提交截图；移除仓库令牌、上传密钥、密码和源码片段。
连接排查树
按顺序检查，不跳过上游条件。
以下七项形成一条依赖链。上游未通过时，下游客户端设置往往不会改变结果。
-
01
通过后继续
主机状态
在控制台确认订单和主机状态。若状态与预期不一致，记录订单标识与页面显示结果后提交工单。
-
02
确认目标一致
目标地址
逐字复制当前订单的连接地址，排除多余空格、旧地址和本地 hosts 覆盖，并确认没有连接到另一份订单。
-
03
记录错误类型
端口与连接方式
确认 SSH、VNC 或屏幕共享使用对应端口与客户端。连接超时、拒绝连接和认证失败应分别记录。
-
04
完成网络对照
本地网络
使用同一参数从另一条可信网络测试，判断公司出口、代理或运营商链路是否影响连接，不在测试中暴露凭据。
-
05
确认出站规则
防火墙规则
检查本地设备与组织网络是否允许目标端口出站。不要为排障关闭全部防护，应按最小范围验证。
-
06
认证结果明确
账户权限
区分网络连接成功与账户认证成功。确认账户名、密钥权限、图形登录权限以及凭据是否已更新。
-
07
保留重试结果
会话占用
检查是否存在未结束的图形会话、重复自动化任务或资源占用。先安全退出旧会话，再发起一次受控重试。
工单材料模板
一次提交足够的可复现上下文。
控制台工单适合已有订单的问题。无法登录控制台时，可使用唯一支持邮箱 support@minidebug.com，并提供必要的账户验证信息。
建议工单结构
复制字段名称并逐项填写
- 订单标识
- 控制台中的订单标识，不提交支付凭据。
- 节点
- 新加坡、日本（东京）、韩国（首尔）、香港或美国东部。
- 发生时间
- 写明日期、时间和时区，并注明是首次发生还是持续复现。
- 复现步骤
- 从打开控制台、执行命令或启动客户端开始，按实际顺序编号。
- 脱敏日志
- 包含第一条错误及上下文，移除密码、令牌、私钥和项目敏感内容。
- 预期与实际
- 分别描述应出现的结果、实际结果和是否可稳定复现。
已有订单
创建控制台工单
使用控制台工单
工单会保留订单上下文，适合主机状态、节点连接、附加项、续租与释放问题。提交前先完成对应排查步骤。
无法登录
support@minidebug.com
发送支持邮件
邮件主题写明问题类型与订单标识，正文使用左侧字段结构。邮箱地址较长时可直接复制。
响应边界
问题归属决定处理方向。
我们会根据工单材料判断问题位于物理节点、macOS 使用、项目代码还是外部依赖，并给出下一步验证方向。
节点基础设施问题
包括控制台显示的主机状态异常、连接信息与订单不一致、节点网络可达性异常，以及订单配置未按所选内容呈现。
- 提供订单标识、节点与发生时间。
- 附不同本地网络的连接对照结果。
- 记录控制台状态与客户端错误类型。
macOS 使用问题
包括系统设置、文件权限、Shell 环境、磁盘清理、远程客户端参数和本地账户权限等操作层问题。
- 先在受控会话中复现操作。
- 记录系统版本、执行账户与目标路径。
- 提交错误文本，不只提交界面截图。
项目代码与构建配置
包括编译错误、测试失败、签名配置、依赖版本冲突、脚本路径、环境变量和应用运行逻辑。
- 用最小改动复现第一条错误。
- 比较本地与云端 Mac 的工具链差异。
- 由项目维护者修改代码或流水线配置。
第三方服务问题
包括代码托管、依赖镜像、软件包源、通知系统和上传目标返回的认证、限流或服务端错误。
- 确认目标服务状态与账户权限。
- 记录响应码、请求时间与重试结果。
- 向对应服务提供方提交已脱敏日志。
自助资源
先读取对应指南，避免重复提交。
连接参数、价格、数据保护与常见构建问题已有独立说明。若指南中的检查项未解决问题，再将结果写入工单。