任务式支持手册

从首次连接到构建排障，按任务找到下一步

DebugMac 交付的是独享 Apple Silicon 物理节点，非虚拟机。本页先核对凭据、区域与工具链，再用命令输出定位连接、构建、存储或链路问题。

立即租用云端 Mac 查看首次上手流程
交付对象
Debug M4 独享物理节点
连接方式
SSH 与 macOS 图形界面
支持入口
控制台工单与支持邮箱
BREAKPOINT REVIEW DESK 诊断任务单
逐项核验
CASE / BUILD-042 待复现

先固定输入，再检查执行环境

节点
JP · Debug M4
任务
Xcode Archive
入口
SSH 公钥
证据
命令、时间、脱敏日志
排查路径
  1. 01核对主机指纹确认连接目标没有变化
  2. 02记录工具链版本固定 Xcode 与依赖输入
  3. 03缩小问题范围区分本地、链路与节点会话
输入订单与区域 执行复现与采样 产物可核验工单
支持索引

六类任务同时展开，不把关键步骤藏进筛选器

选择分类会定位并高亮对应章节，其余指南仍保持可见，便于跨任务核对上下游条件。

首次连接

验证凭据与主机指纹

准备地址、用户名和 SSH 公钥，先确认指纹，再建立命令行与图形会话。

日常构建

固定 Xcode 与归档输入

从仓库状态、工具链、签名检查到归档导出，保留能复现结果的版本信息。

CI 自动化

让 runner 可追踪、可清理

限制并发，显式管理缓存和临时目录，并把关键构建输出带回流水线。

存储扩展

验证容量、挂载与并联单位

开通前确认附加项，交付后核对磁盘容量、挂载点、文件系统与读写目标。

网络诊断

分开检查本地、链路与会话

用延迟、路径、端口和传输测试逐层缩小范围，避免只凭一次 ping 下结论。

账号管理

把问题整理成可执行工单

附上订单标识、区域、发生时间、复现步骤和脱敏日志，减少重复确认。

SSH 与图形会话

首次连接先验证目标，再保存可信基线

交付回执中的地址、用户名、主机指纹和访问签发状态应属于同一订单。任何字段不一致时，先停止连接并通过控制台工单核对。

连接前准备

准备本机 SSH 私钥、公钥对应关系、交付回执和稳定网络。不要把私钥、完整凭据或未脱敏配置粘贴到工单。

  • 检查本地私钥权限是否仅限当前用户读取。
  • 确认订单区域为新加坡、日本（东京）、韩国（首尔）、香港或美国西部之一。
  • 首次连接前独立核对回执中的主机指纹。
  • 记录首次成功连接的时间、系统版本与默认磁盘容量。
查看完整上手步骤
  1. 01 准备凭据

    读取交付回执中的主机地址、用户名和指纹；把私钥保留在本机受控路径，不通过聊天或工单传输。

  2. 02 核验指纹

    首次 SSH 连接显示的指纹必须与回执一致。已连接过但指纹突然变化时，不要直接删除本地记录后重试。

  3. 03 测试密钥登录

    先执行只读命令确认身份、Apple Silicon 架构、系统时间和可用磁盘，再进入仓库或构建目录。

  4. 04 启动图形会话

    核对图形会话凭据、显示分辨率与键盘布局；首次进入后进行一次安全断开与重新连接测试。

  5. 05 处理断线

    先区分本地网络中断、SSH 端口不可达和图形会话中断。命令行仍可用时，优先保存日志与任务状态。

连接失败时先保留三项证据

记录本地时间、完整错误文本和从同一网络执行的端口检查结果。不要连续重置凭据，这会覆盖问题发生时的状态。

Xcode 工作流

把仓库、工具链和归档参数一起固定

同一提交在不同 Xcode、依赖锁文件或签名输入下可能产生不同结果。排障时先固定输入，不要同时升级多个依赖。

01

拉取仓库

记录提交哈希、分支、子模块状态和依赖锁文件。确认工作区没有未提交修改后再开始基线构建。

02

选择工具链

用 xcode-select -p 和 xcodebuild -version 记录当前开发者目录与 Xcode 版本。

03

检查签名输入

核对项目的团队、Bundle 标识、配置名称和签名模式。日志中涉及证书细节时先做脱敏处理。

04

执行归档

显式指定 workspace 或 project、scheme、configuration 与 archivePath，并保存完整退出码和日志。

05

下载产物

归档完成后校验文件大小、校验值与导出目录，再把产物复制到团队约定的安全位置。

构建基线命令 敏感值使用示例代称 
git rev-parse HEAD
xcode-select -p
xcodebuild -version
xcodebuild -workspace "<WORKSPACE>" \
  -scheme "<SCHEME>" \
  -configuration Release \
  -archivePath "<OUTPUT>/App.xcarchive" \
  archive | tee "<LOG_DIR>/archive.log"

成功验收

退出码为 0，归档目录存在，产物大小符合预期，日志中没有被忽略的签名或脚本错误。

失败分流

依次判断依赖解析、编译、链接、签名、脚本阶段或导出失败，不把所有问题概括为“Xcode 构建失败”。

提交证据

提供提交哈希、Xcode 版本、执行命令、退出码、失败阶段和脱敏日志片段，不上传私钥或完整凭据。

CI/CD 自动化

让 self-hosted runner 的每次执行都有边界

GitHub、GitLab 等流水线可以把 macOS 任务路由到独享节点。节点不与其他租户共享运行环境，但同一团队的任务仍需管理并发、缓存和清理。

并发

从单任务基线开始

先验证一条流水线完整通过，再逐步提高并发。多个构建同时写入相同 DerivedData、钥匙串或输出目录时容易相互污染。

  • 每个任务使用独立工作目录。
  • 为模拟器和归档路径加入任务标识。
  • 记录 CPU、内存、磁盘峰值和排队时间。
缓存

缓存必须带可验证的键

依赖缓存键至少包含锁文件摘要、工具链版本和架构。缓存命中后仍要核对依赖完整性，不能把旧缓存当作正确结果。

  • 分开管理依赖缓存与构建中间产物。
  • 工具链切换后主动生成新缓存键。
  • 记录命中、回退和重建耗时。
清理

任务结束时回收临时状态

无论成功或失败，都执行清理阶段。保留需要回传的日志和产物，删除临时密钥、工作目录与不再使用的模拟器状态。

  • 清理步骤使用 finally 或等价机制。
  • 失败日志先归档，再删除工作目录。
  • 定期检查磁盘占用和陈旧缓存。
  1. 01 注册执行器

    使用团队控制的短期注册信息完成 runner 接入，标签应明确表示 Apple Silicon、区域和预期工作流。

  2. 02 建立基线任务

    只运行环境检查与最小构建，确认仓库权限、Xcode 路径、依赖下载和产物回传均正常。

  3. 03 增加缓存

    先测无缓存时间，再按锁文件与工具链建立缓存键，避免无法判断缓存是否真正有效。

  4. 04 验证清理

    主动制造一次失败，确认日志仍能回传、临时信息被撤销、后续任务不会继承上次状态。

存储与 Thunderbolt 5

附加项先在订单中确认，交付后再验证容量与链路

基础配置为 Debug M4：M4、16GB RAM、256GB SSD。+1TB SSD、+2TB SSD 与 Thunderbolt 5 并联均为独立附加项，不能从系统显示推测订单内容。

附加存储

+1TB SSD

按订单计费
按天$2.3
按周$6.1
按月$11.3
按季$30.7

启用前确认目标工作流、预计峰值和数据迁移方式；交付后核对总容量、卷名、文件系统和挂载路径。

附加存储

+2TB SSD

按订单计费
按天$4.6
按周$12.2
按月$22.6
按季$61.4

适合需要保留较多归档、媒体素材或模型文件的任务。容量验收仍应以系统磁盘信息和实际挂载结果为准。

每台计费

Thunderbolt 5 并联

每台独立计算
按天$1.7
按周$4.6
按月$8.5
按季$23.1

提交前明确并联台数、任务分配方式和产物汇总位置。该选项按每台计费，不能用一台的价格推算整组订单。

  1. 01 核对订单

    确认附加项名称、数量、租期与 USD 金额。实际可用状态和结算网关以控制台实时返回为准。

  2. 02 核对系统

    使用 diskutil list 与 df -h 记录磁盘、卷和可用空间，避免只看桌面图标。

  3. 03 验证读写

    在目标工作目录执行小规模读写测试，确认权限、路径和实际产物位置，不用一次极端测试代表长期表现。

  4. 04 记录映射

    多盘或多机协作时记录“任务—卷—产物目录”对应关系，避免清理任务删除仍需保留的数据。

网络诊断手册

四组测试区分本地网络、跨区链路和节点会话

单次延迟或一次断线不能直接证明问题所在。请在相同网络、相近时间重复采样，并保留命令、目标、时间和原始输出。

网络诊断命令、观察项与判断边界
测试 示例命令 重点观察 可帮助区分
基础延迟 ping -c 20 <HOST> 丢包、波动、连续超时位置 本地接入异常与持续链路异常
路径追踪 traceroute <HOST> 路径变化、异常跃点、超时是否持续 本地出口、跨区路径与目标附近链路
端口检查 nc -vz <HOST> 22 连接成功、拒绝或超时 主机可达但 SSH 端口不可达的情况
传输测试 scp <FILE> <USER>@<HOST>:<PATH> 持续速率、重试、文件校验值 交互延迟与大文件传输问题
会话检查 ssh -vv <USER>@<HOST> 解析、握手、密钥选择、认证阶段 网络、指纹、密钥与用户配置问题

本地网络问题

同一设备访问多个目标都异常，切换受控网络后恢复，或本地出口前几跳已出现持续丢包。提交时说明网络类型与复测结果。

跨区链路问题

本地接入正常，但特定路径出现持续波动。应提供多次路径追踪，不把中间跃点不响应直接等同于真实丢包。

节点会话问题

主机和端口可达，但认证、Shell 或图形会话失败。此时重点保留 SSH 详细输出、会话错误和最近操作。

测试口径

网络结果受本地运营商、接入方式、跨区路径和采样时段影响，只用于定位问题范围，不构成性能承诺。所有节点全年 365 天正常运行，可用性按实际服务记录核验。

工单准备清单

把支持请求整理成一次可复现的交接

在用节点问题优先通过控制台提交工单。售前或无法登录时，可发送邮件至 support@debugmac.com；两种渠道使用同一份信息清单。

  1. 01 订单标识

    提供控制台显示的订单标识和机型 Debug M4，不发送付款凭据、私钥或完整访问密码。

  2. 02 节点区域

    写明新加坡、日本（东京）、韩国（首尔）、香港或美国西部，并说明问题是否只在该区域出现。

  3. 03 发生时间

    提供带时区的首次发生时间、最近一次复现时间和持续时长，避免只写“刚才”或“偶尔”。

  4. 04 复现步骤

    按输入、执行命令、预期结果和实际结果排列。若无法稳定复现，说明出现频率与已观察到的共同条件。

  5. 05 脱敏日志

    保留时间戳、退出码和错误上下文；移除密钥、令牌、密码、内部仓库地址和其他敏感值。

  6. 06 已做排查

    列出已经执行的命令、重试次数、网络切换和结果，避免支持人员要求重复同一组基础检查。

在用节点与账号

登录控制台提交工单

工单可与订单、节点和历史处理记录关联，适合连接、构建、存储、账单和账号访问问题。

进入控制台
售前或无法登录

发送结构化支持邮件

主题写明任务类型与节点区域，正文按本页清单排列。对外支持邮箱仅为 support@debugmac.com。

发送支持邮件
准备开始

需要一台可核验配置的云端 Mac？

选择 Debug M4、租期和五地节点，提交前再次核对基础配置、附加项、区域与 USD 应付金额。实际可用状态以控制台实时返回为准。

立即租用云端 Mac 查看配置与价格