SUPPORT PATH

先定位问题，再提交足够的诊断证据

这里提供从首次连接到构建与性能排查的固定检查顺序。先确认本地网络、目标地址、认证信息和节点状态，再进入工具链或资源指标检查，可以避免反复试错，也能让支持人员更快复现问题。

进入控制台提交工单 查看远程连接指南 立即租用云端 Mac
diagnostic-path
01 检查本地网络 基础层
02 核对地址与认证 连接层
03 确认节点状态 控制层
04 采集任务与资源指标 任务层

FIND THE PATH

按现象检索排查路径

输入错误文本、连接方式、系统任务或节点状态。检索仅匹配本页可见文档，不会上传输入内容。

显示 7 条支持路径

FIRST SESSION

首次使用清单：先建立可复现的连接基线

不要同时修改多个连接参数。每完成一步记录结果，失败时才能判断问题位于本地、网络、认证还是节点侧。

  1. 01

    确认节点状态

    在控制台查看目标节点是否显示已就绪，并核对节点标识、区域和所选机型。节点仍在准备阶段时，不应以客户端报错判断连接故障。

    完成标准：节点标识与订单一致，状态允许连接。
  2. 02

    复制登录信息

    从控制台当前节点详情复制地址、端口和用户名，避免使用旧工单、旧截图或其他节点保存的记录。粘贴密码时注意前后空格和输入法全角字符。

    完成标准：地址、端口、用户名来自同一个节点详情。
  3. 03

    验证本地网络

    先确认普通 HTTPS 访问正常，再分别测试办公网络与可信的备用网络。企业出口、防火墙或代理可能只拦截特定端口，因此“网页能打开”不等于远程连接一定可达。

    完成标准：记录所用网络、出口类型和失败时间。
  4. 04

    校准键盘布局

    进入 macOS 图形界面后，先测试字母、数字、符号、Command 与 Option 映射。若符号位置不一致，同时记录本地键盘布局和远端所选布局。

    完成标准：终端可准确输入命令中的引号、斜杠和连字符。
  5. 05

    统一时区与时间

    将任务日志、CI 记录和工单时间统一标明时区。排查间歇性错误时，“14:20”没有时区就无法与节点事件对应，建议使用带时区的完整日期时间。

    完成标准：本地、节点和自动化日志的时间可互相换算。
建议第一次成功连接后保存一份不含敏感凭据的基线记录：节点标识、区域、连接方式、客户端版本、键盘布局、时区和一次成功连接时间。后续异常可以直接与这份基线比较。

DECISION TREE

连接故障决策树：每次只排除一层

连接超时通常指向网络或地址，认证失败通常指向用户名、密码、密钥或客户端配置。先按错误类型分流，再执行五层检查。

1

本地网络是否稳定

LOCAL

关闭会改变路由的临时代理后重试，并使用可信备用网络做一次对照。若办公网络失败而备用网络成功，记录出口策略和受影响端口，问题应优先交给本地网络管理员。

继续条件：同一目标在至少一个可信网络上完成连接尝试。

2

目标地址与端口是否属于当前节点

TARGET

回到控制台重新复制目标信息，不从命令历史中复用地址。浏览器远程桌面使用控制台提供的入口；SSH 则核对主机、端口和用户名是否处于同一条连接记录。

停止条件：地址已变化或记录来自其他节点，更新后重新测试。

3

认证信息是否完整且未被输入法改写

AUTH

检查用户名大小写、密码前后空格、密钥文件权限和所选身份文件。SSH 主机指纹首次出现时应与控制台信息核对；指纹意外变化时暂停连接，并通过工单确认原因。

证据要求：保留错误原文，但遮盖密码、密钥内容和完整访问地址。

4

控制台中的节点状态是否允许连接

NODE

刷新节点详情，确认状态、节点标识和最后变更时间。如果状态异常，不要连续执行重启类操作；记录操作前状态、已执行动作和每次动作时间，避免覆盖故障现场。

升级条件：节点状态异常，或状态正常但两种可信网络均不可达。

5

客户端设置是否造成显示或会话问题

CLIENT

浏览器页面空白时，使用当前稳定版浏览器并清除该站点的会话数据后重试；键盘错位时降低到单一布局；SSH 会话频繁中断时，先关闭终端插件并使用基础命令建立对照会话。

完成条件：记录客户端名称、版本、连接方式和可复现步骤。

错误为“超时”或“无法到达”

优先提交网络类型、失败时间、目标区域、两种网络的对照结果，以及控制台节点状态。不要只提交一张没有时间和节点标识的截图。

错误为“认证失败”

优先核对当前节点的用户名、认证方式和客户端身份文件。工单中只写认证方式与错误原文，不发送密码、私钥或可直接使用的访问凭据。

BUILD PIPELINE

构建任务排查：从工具版本向外检查

构建错误应以第一次失败的明确错误为起点，而不是最后一行汇总信息。先固定工具链，再检查签名、依赖、磁盘和自动化进程。

Xcode 工具链

记录 macOS 版本、Xcode 版本、命令行工具路径和构建命令。图形界面与自动化任务若调用了不同工具路径，可能在同一节点产生不同结果。

  • 确认任务实际调用的 Xcode 路径
  • 保留完整构建命令与工作目录
  • 比较成功任务与失败任务的版本差异

证书与签名

区分证书缺失、配置文件不匹配、授权范围不符和钥匙串访问失败。提交诊断时保留证书名称、有效期与错误文本，但遮盖证书文件、密码及项目敏感标识。

  • 确认自动化进程可访问所需签名材料
  • 检查目标、构建配置与签名设置是否一致
  • 记录错误发生在归档、导出还是上传阶段

依赖与缓存

先判断失败是否可由锁定文件稳定复现，再清理最小范围的缓存。一次性删除所有依赖与构建缓存会扩大变量，也可能让原始问题暂时消失而无法定位。

  • 保存依赖锁定文件与包管理器版本
  • 仅清理与失败目标直接相关的缓存
  • 记录清理前后首次构建耗时与错误差异

磁盘与自动化日志

归档、依赖解压和临时产物需要额外空间。仅查看项目目录大小不够，还要检查可用容量、临时目录、构建缓存与自动化进程是否因资源不足被终止。

  • 在失败前后记录可用磁盘容量
  • 保留任务开始、结束和退出码
  • 截取首次错误前后至少 50 行日志

PERFORMANCE SAMPLE

性能排查：记录同一时间段的四类指标

单个 CPU 截图无法解释磁盘等待、内存压力或网络波动。建议在问题发生前后连续采样 5–10 分钟，并标记任务开始与失败时间。

指标 至少记录 需要关注的现象 与任务对照
CPU 总使用率、主要进程、采样时间 单进程持续占用、负载突增、任务结束后仍不回落 标记编译、链接、测试或推理开始时间
内存 已用内存、内存压力、交换空间 压力持续升高、交换频繁、进程被系统终止 记录并行任务数量与输入规模
磁盘 可用空间、读写吞吐、I/O 等待 空间接近耗尽、解压或归档阶段等待明显 区分依赖下载、编译缓存与产物写入
网络 本地网络类型、往返延迟、丢包现象 仅特定出口异常、交互卡顿但节点任务正常 区分远程画面、依赖下载和代码拉取
SAMPLE

采样要覆盖异常前后

从任务开始前记录基线，直到异常后至少 1 分钟。只有异常瞬间的数据，无法判断资源是原因还是结果。

COMPARE

保留一次正常任务对照

使用相同项目、依赖和并行度记录一次正常任务，比较耗时阶段与资源曲线，而不是只比较总耗时。

BOUNDARY

先区分交互慢与计算慢

远程画面卡顿但节点内任务耗时稳定，通常应优先检查网络；任务本身耗时上升则继续检查 CPU、内存与磁盘。

MINIMUM EVIDENCE

最小诊断信息：让问题可以被复现

支持请求不需要上传整个项目。以下字段通常足以完成第一次判断，缺失时支持人员会要求补充。

  1. 01

    节点与环境

    节点标识、节点区域、macOS 版本、Xcode 或客户端版本。不要填写密码、私钥或完整访问凭据。

  2. 02

    准确时间范围

    使用“日期 + 时分秒 + 时区”，并标明第一次出现、最后一次出现和最近一次复现的时间。

  3. 03

    错误原文与退出码

    复制可检索的文本，不只上传截图。保留错误码、失败阶段和首次错误前后的日志上下文。

  4. 04

    最短复现步骤

    从已知正常状态开始，按顺序列出操作、命令、预期结果和实际结果，并说明复现概率。

  5. 05

    已经尝试的动作

    列出切换网络、更新地址、清理缓存或重启任务的时间与结果，避免重复操作覆盖现场。

ESCALATION RULES

工单升级规则：按影响对象分类

一个工单只描述一个主要问题。若账户访问与节点故障同时发生，分别建立记录，避免处理状态互相覆盖。

分类 适用情况 建议证据 优先渠道
账户问题 无法进入控制台、账户资料或访问验证异常 注册邮箱、发生时间、页面错误原文、浏览器版本 支持邮箱
节点不可达 节点显示允许连接，但浏览器远程桌面和 SSH 均无法建立会话 节点标识、区域、两种网络测试结果、错误时间与原文 控制台工单
硬件异常 持续出现异常重启、存储错误或无法由单个任务解释的资源异常 节点标识、系统日志时间范围、异常前任务、复现频率 控制台工单
数据相关请求 节点释放、数据导出流程或隐私权利相关请求 订单标识、请求范围、期望动作、必要的身份核验信息 控制台工单
影响等级 A

整个节点不可达

节点状态允许连接，但经过两种可信网络测试后，浏览器远程桌面与 SSH 均不可达。提交节点标识、区域和最近一次成功连接时间。

影响等级 B

主要任务阻塞

节点可连接，但固定工具链下的构建或自动化任务稳定失败。提交首次错误、完整命令、退出码和一次最短复现流程。

影响等级 C

配置与使用咨询

节点可用，问题涉及键盘、分辨率、依赖缓存或工作流优化。说明当前配置、目标结果与已经验证的方案。

SERVICE CONTINUITY

服务连续性与状态判断

所有节点按全年 365 天正常运行设计，不设置周期性服务中断。出现异常时，应根据影响范围区分区域网络波动、单节点故障或本地连接问题。

REGION

区域网络波动

同一地区的多个连接来源在接近时间出现延迟上升、丢包或会话中断，但节点内任务可能继续运行。

  • 记录来源城市、运营商和网络类型
  • 使用可信备用网络完成对照
  • 提供开始时间、持续时长和目标区域
NODE

单节点故障

本地网络与同区域其他服务正常，但目标节点状态异常、重复失联或出现无法由用户任务解释的系统错误。

  • 保存节点标识和控制台状态
  • 停止反复执行可能改变现场的动作
  • 通过控制台工单关联订单记录
LOCAL

本地或客户端问题

目标节点在备用网络或其他客户端可正常访问，仅某一办公出口、浏览器配置或 SSH 客户端失败。

  • 比较失败与成功环境的差异
  • 检查代理、防火墙和客户端版本
  • 将网络策略问题交给本地管理员

状态描述要使用可验证事实

推荐写法

“节点 SG-示例在 2026-08-08 14:20 +0800 起无法通过 SSH 连接；家庭网络与办公网络均超时，控制台状态仍显示允许连接。”

避免模糊描述

不要只写“服务器坏了”“网络很慢”或“偶尔断开”。缺少节点、时间、网络来源与错误原文时，无法确定影响范围。

QUICK ANSWERS

提交支持请求前的常见问题

节点无法连接时，第一步应该做什么？

先在控制台确认节点标识与状态，再从当前节点详情重新复制地址、端口和用户名。随后使用可信备用网络做一次对照。不要在尚未记录状态时连续执行多个改变节点状态的动作。

构建失败需要提交完整日志吗？

优先提交首次错误前后至少 50 行、完整构建命令、退出码、Xcode 版本和发生时间。若完整日志包含项目路径、仓库地址或签名信息，应先脱敏。不要删除错误码和时间戳。

为什么单张性能截图通常不够？

截图只能表示一个瞬间，无法判断资源变化发生在任务之前还是之后。建议连续记录 5–10 分钟的 CPU、内存、磁盘和网络指标，并标记任务开始、异常和结束时间。

应该发送邮件还是提交控制台工单？

现有订单、节点、硬件和数据相关请求优先提交控制台工单，以便关联订单与节点记录。无法进入控制台的账户问题，可发送邮件至 support@macworker.com。本站只使用这两种联系渠道。

哪些内容不能放进工单或邮件？

不要提交密码、私钥、支付凭据、完整访问地址或项目源代码。日志中的敏感值可以遮盖，但应保留字段名称、版本、错误码、时间戳和调用顺序。

READY TO ESCALATE

已有节点标识、时间和错误原文？

通过控制台工单关联现有订单，提交最短复现步骤与脱敏日志。若尚未租用节点，可先进入门户选择独享物理机配置、区域和周期。

进入控制台提交工单 查看云端 Mac 租用方案