任务式排障指南

从错误信息到可执行检查点。

按开通、连接、开发工具链、存储和账单任务定位问题。每条路径都给出核对顺序、验证命令与需要保留的诊断信息，适用于 HireAMac 独享 Apple Silicon 物理节点。

登录控制台提交工单 查看远程访问指南
五个云端 Mac 节点组成的连接网络示意图
DIAGNOSTIC FLOW READY
01 确认问题范围 连接 / 构建 / 存储 / 账单
02 记录验证结果 节点、时间、命令与脱敏日志
03 执行单变量复测 一次只调整一个条件
快速检索

输入错误信息、命令或账单字段。

可搜索连接超时、凭据、Xcode、Swift、CI Runner、SSD、订单周期等关键词。搜索仅筛选本页指南，不会上传输入内容。

当前显示 6 个帮助主题。

热门任务 首次开通 连接超时 验证 Xcode 数据导出 核对账单 准备工单
首次使用

用四个检查点完成第一次构建。

先确认节点与访问条件，再验证系统和构建工具。不要在连接尚未稳定时同时修改凭据、客户端和工具链。

  1. 01

    在控制台核对节点信息

    打开订单对应的实例详情，记录机型、区域、连接地址与当前会话状态。三档在售配置分别是 HireAMac M4 S（M4、16GB、256GB）、HireAMac M4 M（M4、24GB、512GB）和 HireAMac M4 Pro L（M4 Pro、64GB、2TB）。区域应为新加坡、日本（东京）、韩国（首尔）、香港或美国东部之一。

    • 订单标识与实例详情一致。
    • 连接地址取自当前实例，不沿用旧订单记录。
    • 需要提交支持请求时，只记录必要字段，不复制访问密钥。
  2. 02

    设置并单独验证访问凭据

    使用控制台提供的方式设置强凭据，将凭据保存在受控的密码管理工具或密钥存储中。首次连接先只验证登录，不急于上传项目、安装依赖或启动长时间任务。团队协作时为成员划分最小必要权限，成员退出项目后及时撤销访问。

  3. 03

    验证 macOS 与命令行环境

    图形桌面可正常进入后，在终端执行以下只读命令。保留文本输出即可，不需要截取包含敏感目录或凭据的完整桌面。

    sw_vers
uname -m
xcode-select -p
xcrun swift --version
xcodebuild -version

    预期架构为 Apple Silicon 对应的 arm64。若 xcode-select -p 未返回有效开发者目录，先完成命令行工具路径配置，再继续构建验证。

  4. 04

    运行一个可丢弃的最小构建任务

    选择不含生产凭据的小型工程，先执行依赖解析，再运行一次干净构建。检查退出码、产物目录、剩余磁盘空间和构建日志。最小任务成功后，再迁移大型仓库、缓存与自动化流程，便于把环境问题和项目问题分开。

    df -h /
xcodebuild -project Sample.xcodeproj -scheme Sample -showBuildSettings
xcodebuild -project Sample.xcodeproj -scheme Sample clean build
完成标准：节点信息已核对、凭据可用、系统与工具版本可读取、最小构建返回明确结果。任一步失败，就停在该层排查，不同时改动后续配置。
连接诊断

按网络、节点、凭据、会话、客户端的顺序核对。

顺序很重要。先证明链路可达，再处理认证和客户端显示问题，可避免把网络故障误判为凭据错误。

01

本地网络

确认本地网络没有代理规则、企业防火墙或临时热点限制。分别在当前网络与另一条可信网络复测，记录是否只有某一路径失败。

验证点 DNS 解析、路由可达、端口策略、丢包表现
02

目标节点

回到控制台核对实例地址、区域和状态，避免使用旧会话保存的地址。跨区域团队应确认成员连接的是同一订单对应的物理节点。

验证点 订单标识、节点区域、连接地址、状态更新时间
03

访问凭据

检查用户名、密钥文件权限和最近一次凭据轮换。认证失败时不要连续尝试多个未知凭据，应先确认唯一可信来源。

验证点 用户名、密钥权限、凭据版本、认证错误原文
04

会话状态

确认没有遗留全屏会话、未退出的远程桌面或占用中的自动化任务。重新建立会话前先安全退出旧连接，不直接终止正在写入数据的进程。

验证点 已有会话、活动进程、桌面锁定、最近断开时间
05

客户端设置

核对客户端版本、分辨率、色彩和剪贴板策略。若终端可达但图形桌面异常，问题范围通常已缩小到会话或客户端层。

验证点 客户端版本、显示设置、输入法、文件传输策略
可复制诊断清单

提交支持请求前填完整这些字段。

时间应包含时区。日志只保留错误前后必要行，并替换用户名、私有路径、令牌、密钥和项目机密。

问题类型：
订单标识：
机型：
节点区域：
发生时间与时区：
本地网络类型：
连接方式与客户端版本：
错误信息原文：
首次发生或可重复发生：
已完成的检查：
脱敏日志片段：
开发工具链

分别验证安装、路径、版本与任务执行。

工具存在不等于任务可用。验证时同时记录可执行文件路径、实际版本、选中的开发者目录和最小任务退出码。

Xcode 与开发者目录

先读取 Xcode 版本与当前开发者目录，再通过 xcrun 验证工具解析。多版本环境切换后重新打开终端，并用同一用户运行构建任务，避免交互会话和自动化任务指向不同路径。

xcodebuild -version
xcode-select -p
xcrun --find xcodebuild
xcrun simctl list runtimes

Swift 与命令行工具

分别检查 Swift 编译器、系统架构与基础构建工具。若交互终端成功而自动化任务失败，应比较两者的 PATH、工作目录、用户身份和环境变量，而不是直接重复安装工具。

xcrun swift --version
clang --version
uname -m
pwd
printf '%s\n' "$PATH"

证书文件与敏感材料

证书文件应通过受控路径传入，限制文件权限，并在导入前核对用途和有效状态。诊断时只记录文件名、用途、权限和校验结果，不在截图、构建日志或工单附件中发送密码、私钥或有效访问令牌。

ls -l /path/to/certificate
file /path/to/certificate
security find-identity -v -p codesigning

CI Runner 状态验证

不论使用哪种仓库平台，都应验证 Runner 进程用户、工作目录、磁盘余量、工具链路径和任务退出码。先运行不访问生产资源的探针任务，再接入完整流水线。失败日志应包含阶段名称和命令结果。

whoami
pwd
df -h /
xcode-select -p
xcodebuild -version
xcrun swift --version

工具链状态应能回答五个问题

  • 装在哪里：可执行文件和开发者目录路径明确。
  • 运行什么版本：Xcode、Swift 与命令行工具版本已记录。
  • 由谁运行：交互用户和自动化进程用户已区分。
  • 从哪里运行：工作目录、项目文件和输出目录可确认。
  • 如何判定结果：退出码、产物位置和错误日志可核对。
存储与数据

容量选择取决于峰值工作集，不只看仓库大小。

评估源码、依赖缓存、构建中间文件、归档产物、实验数据和导出副本的同时占用，并为清理操作保留可用空间。

基础 SSD

随机型提供的基础容量

HireAMac M4 S
256GB
HireAMac M4 M
512GB
HireAMac M4 Pro L
2TB

适合容量可预测、依赖可重复下载、产物能及时导出的工作流。大型模拟器运行时、归档和缓存可能显著高于源码本身，应按峰值而非初始占用判断。

+1TB SSD

为持续构建和多分支缓存留余量

按天
$2.9
按周
$7.7
按月
$14.3
按季
$38.9

适合并行维护多个分支、保留依赖缓存或处理持续增长的构建产物。下单前确认新增容量是否能覆盖工作集与导出副本同时存在的阶段。

+2TB SSD

面向大型数据集与多任务并行

按天
$5.8
按周
$15.4
按月
$28.6
按季
$77.8

适合高容量实验数据、多个大型工程或需要保留较多中间产物的任务。容量扩展不能替代备份策略，关键数据仍应在租期结束前完成独立导出与校验。

INPUT

上传

先传最小可运行集合，验证权限、文件完整性和目录结构，再分批上传大型资源。不要把密钥混入仓库压缩包或通用数据包。

MOVE

迁移

记录源路径、目标路径、文件数量和校验结果。迁移期间暂停会持续改写同一目录的任务，避免源数据和目标数据状态不一致。

CLEAN

清理

优先删除可重新生成的缓存和临时产物。清理前确认活跃任务未引用目标目录，并保留删除范围与释放容量记录。

EXPORT

导出

在租期结束前导出源码、配置、产物和必要日志，完成文件数量或校验值核对。确认外部副本可打开后，再处理节点上的工作数据。

df -h /
du -sh ~/Projects
du -sh ~/Library/Developer/Xcode/DerivedData
find ~/Projects -type f | wc -l
计费问题索引

先看周期，再核对机型、节点和附加项。

所有订单均以美元（USD）结算。实际可用网关以控制台实时返回为准，支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe）。

三档机型的日、周、月、季价格
机型 配置 按天 按周 按月 按季
HireAMac M4 S M4 / 16GB / 256GB $20.9 $56.4 $104.4 $284
HireAMac M4 M M4 / 24GB / 512GB $41.2 $111.2 $205.9 $560
HireAMac M4 Pro L M4 Pro / 64GB / 2TB $59.9 $161.8 $299.6 $814.9
存储扩展与 Thunderbolt 5 并联价格
附加项 按天 按周 按月 按季
+1TB SSD $2.9 $7.7 $14.3 $38.9
+2TB SSD $5.8 $15.4 $28.6 $77.8
Thunderbolt 5 并联（每台） $1.3 $3.6 $6.7 $18.2
DAY

按天订单

适合临时构建、故障复现和短任务验证。核对订单中的天数、机型日价、附加项日价和节点字段。

WEEK

按周订单

适合版本冲刺或连续测试。账单应显示所选机型周价，以及按周计费的存储或并联附加项。

MONTH

按月订单

适合日常开发和稳定 CI 工作流。核对月度周期边界、机型月价、节点和每项月度附加费用。

QUARTER

按季订单

适合需求较稳定的连续任务。确认机型季价、附加项季价和订单周期均按同一周期记录。

账单金额应按什么顺序核对？
先确认机型和计费周期，再确认节点、存储扩展与 Thunderbolt 5 并联数量，最后核对美元（USD）结算字段和支付处理结果。不要把不同周期的单价混合计算。
支持哪些支付方式？
仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe），全部订单以美元（USD）结算。实际可用网关以控制台实时返回为准。
节点与机型组合如何确认？
三档机型均可选择新加坡、日本（东京）、韩国（首尔）、香港或美国东部。下单时的实际可用性以控制台实时返回为准。
人工支持准备单

让支持请求能够被直接复现。

可通过控制台提交工单，或发送邮件至 support@hireamac.com。不要发送访问密钥、密码、有效令牌或未脱敏的项目数据。

节点与机型

写明新加坡、日本（东京）、韩国（首尔）、香港或美国东部，以及对应的 HireAMac 在售机型名称。

订单标识与发生时间

提供控制台中的订单标识。问题发生时间应包含日期、时刻和时区，连续发生时给出起止范围。

最短复现步骤

从已知正常状态开始，逐条列出操作、输入、预期结果和实际结果。注明问题是否每次发生。

脱敏日志与已尝试操作

保留错误原文、命令退出码和必要上下文。替换用户名、私有路径、密钥、令牌、证书内容及业务数据。

下一步

问题已定位，就回到工作流。

需要新节点时可比较三档配置与四种租期；已有实例问题请登录控制台提交包含诊断结果的工单。

查看三档租用方案 立即租用云端 Mac