连接与登录
SSH 超时、图形桌面黑屏、屏幕共享显示异常。先核对订单凭据与网络，再判断是连接层还是桌面会话。
按问题定位
先找对排查入口
这四类问题处理路径不同。付款未确认不等于节点故障，构建失败也不一定需要重启机器。
Xcode 与模拟器
命令行选中了错误的 Xcode、缓存占用磁盘、签名身份不可见。用版本和钥匙串检查结果定位环境差异。
CI runner
交互式终端能构建，但流水线失败。优先检查执行用户、PATH、钥匙串和模拟器状态，不先增加并发。
计费与续费
链上转账待核对、银行卡付款失败、到期时间不明确。订单状态和支付结果以控制台实时返回为准。
连接排障
先检查端口，再检查会话
主机地址、连接端口、用户名与密钥要求均从控制台订单详情获取。下列命令中的变量需要先按该订单设置，不要把示例别名当作真实节点地址。
SSH 连接超时
先区分超时与认证失败。超时通常发生在 TCP 连接建立之前，应核对地址、端口、本地网络出口和节点状态；出现 Permission denied 则说明已进入认证阶段，应检查用户名与密钥，而不是反复换端口。
nc -vz "$NODE_HOST" "$SSH_PORT"在本地终端执行。连接成功只说明该端口可达，不代表认证已经通过。若失败，换一个可用网络重复检查，并记录两次结果；若端口可达但登录失败，可用 ssh -vv 收集认证阶段日志。提交前删除日志中的用户名、地址和本地路径等敏感信息。
VNC 连接后黑屏
客户端已连上但没有画面，与端口完全不可达是两类问题。先断开重复的图形连接，再核对客户端画质和桌面会话。SSH 仍可用时，可以检查当前控制台用户，判断是否存在已登录的图形会话。
stat -f '%Su' /dev/console在节点的 SSH 会话中执行。输出只是一项线索，不能单独证明桌面服务正常。不要直接结束未知进程或重启正在构建的节点；把黑屏发生时间、客户端名称、SSH 是否可用和会话检查结果写入工单，由支持继续核对。
屏幕共享分辨率异常
先判断是远端分辨率改变，还是本地客户端缩放造成文字模糊。检查屏幕共享的缩放与自适应画质选项，再读取远端显示信息。切换客户端窗口大小不会等同于修改远端显示模式。
system_profiler SPDisplaysDataType在节点执行并查看显示信息。若预期模式没有出现，记录当前分辨率、客户端窗口尺寸和可选显示模式；截图只保留显示设置区域，不包含工程、凭据或业务数据。不要安装来源不明的显示驱动作为第一步处理。
如果 SSH 与图形连接同时不可达，且换网络后仍失败，请直接提交节点不可达工单。不要用反复重装客户端替代故障上报。
开发环境
让终端与构建用同一套工具链
先保留错误日志，再修改环境。以下操作针对你的独享物理节点；执行需要权限的命令前，确认没有其他团队任务正在使用该环境。
如何切换 Xcode 版本，并确认流水线实际使用的版本？
先运行 xcode-select -p 和 xcodebuild -version，记录当前开发者目录与版本。确认目标 Xcode 已安装后，再把开发者目录切到它的 Contents/Developer。下面的路径适用于应用名为 Xcode.app 的安装；如果节点上使用带版本号的应用名，应按实际路径替换。
xcode-select -p
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -versionCI 进程可能通过 DEVELOPER_DIR 覆盖系统选择。若终端和流水线版本不同，检查 job 的环境变量与 runner 服务用户，不要只看系统设置。单个任务需要另一版本时，优先在该任务中显式指定开发者目录，避免影响同一节点上的其他构建。
DerivedData 应该什么时候清理，怎样避免误删工程？
先检查占用，再决定是否清理。工具链切换后出现缓存相关错误、索引异常或磁盘空间不足时，可以处理 DerivedData；普通编译报错不应默认归因于缓存。关闭相关构建任务后，把缓存目录改名留作回退，比直接递归删除更容易核查。
du -sh "$HOME/Library/Developer/Xcode/DerivedData"
mv "$HOME/Library/Developer/Xcode/DerivedData" "$HOME/Library/Developer/Xcode/DerivedData.backup.$(date +%s)"目录存在时才执行改名，Xcode 会在下一次构建时重新创建缓存。改名不会释放磁盘空间；确认新构建正常后，再按实际备份路径删除旧缓存。保留需要的归档产物，不要把 Archives、工程目录或签名材料一并清空。若 CI 使用自定义 -derivedDataPath，需要检查的是该路径，而非当前用户的默认目录。
签名证书导入后，为什么构建仍找不到签名身份？
签名身份需要有效证书及其配对私钥。只有证书文件，通常不足以完成签名。通过钥匙串访问工具导入你有权使用的签名材料，然后在实际执行构建的用户下检查可用身份。不要把证书文件或导入密码写进工单。
security find-identity -v -p codesigning
security list-keychains -d user交互式用户能看到身份，不代表 runner 服务用户也能看到。继续核对服务运行账号、钥匙串搜索列表、解锁状态和访问权限。若需要调整钥匙串访问控制，应只授权必要的签名工具；不要为了消除一次报错而向所有应用开放私钥。提交工单时提供脱敏后的身份检查结果、错误码与执行用户类型即可。
本地终端能构建，CI runner 或模拟器任务却失败，先查什么？
把同一组环境检查写入失败的 job，而不是只在 SSH 终端运行。对照执行用户、开发者目录、Xcode 版本、PATH 与可用模拟器。服务进程不一定加载交互式 shell 的配置，所以手动执行成功不能证明服务环境一致。
whoami
xcode-select -p
xcodebuild -version
printf '%s\n' "$PATH"
xcrun simctl list devices available若模拟器列表没有目标设备，先检查所需运行时是否安装、测试任务的 destination 是否匹配。若 runner 显示离线，检查服务启动状态与任务日志，再检查网络连接和注册信息。没有基线数据时，先用一个构建任务验证流程，再逐步增加并发，并观察统一内存与磁盘占用。
独享意味着物理资源不与其他租户分摊，不意味着同一节点内的多个任务互不影响。GitHub Actions 与 GitLab CI 的完整接入步骤可在连接指南中查看。
支付与租期
先核对订单状态，再决定下一步
所有费用以美元结算。仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe）；实际可用网关以控制台实时返回为准。
USDT-TRC20 已转出，为什么订单还没有显示支付成功？
钱包显示转出、链上确认与订单核对是不同环节。确认时间受链上处理与支付网关状态影响，本页不提供固定分钟数。先核对付款页面要求的网络、收款地址与金额，再查看该笔交易是否成功，最后检查控制台订单状态。
不要因为订单尚未更新就重复付款。需要人工核对时，提交订单号、交易哈希、转账金额与转账时间，并注明时区。交易哈希用于定位交易；助记词、钱包私钥和密码均不需要，也不得发送。若使用的网络或金额与付款要求不同，请保留交易记录并在工单中如实说明。
银行卡付款失败，或者账单出现待处理记录，应该怎样核对？
先查看付款页面的错误提示和订单状态，再核对发卡行是否允许该笔美元交易、是否需要额外验证。发卡行的待处理授权不一定代表订单已经支付成功；不要仅凭银行卡通知判断交付状态。
多次失败时，先联系发卡行核对拒绝原因，不要连续快速重试。控制台仍未确认付款，但银行已显示扣款时，请提供订单号、付款时间、金额及脱敏后的错误提示；有支付交易标识时一并提供。不要发送完整卡号、安全码或验证短信。支持人员会按订单与支付记录核对，退款或授权解除状态仍需结合网关及发卡行结果确认。
续费提醒什么时候发出，如何避免项目在到期时中断？
先以控制台显示的到期时间为准。提醒的具体发送时间与通知状态，应在控制台核对；本页不承诺固定提前天数，也不应把收到提醒作为继续使用的唯一判断依据。建议团队在项目日历中单独登记到期时间，并指定一位负责人核对续费结果。
按天、周、月或季选择周期后，核对续费账单对应的机型、附加项与租期。付款完成后，再确认订单已更新，不要只依赖付款页面截图。到期未续费会影响节点使用；工程、产物与必要配置应在到期前完成备份。若控制台时间或金额与预期不符，先保留账单编号提交工单，再决定是否继续付款。
完整周期价与存储扩展费用请查看方案页。已有订单的计费争议请通过控制台工单核对，不要在邮件中附上机器密码。
工单准备
把能复现的问题，一次说明白
已租用户从控制台工单入口提交。支持按影响范围分流：节点不可达优先，环境配置与账务咨询按问题类型跟进。
一般咨询：描述预期与实际结果
开发环境、配置方法与续费核对可通过工单处理。沟通以 UTC+8 为时间参照，覆盖亚太工作时段；具体响应时段与进度以控制台工单提示和回复为准，本页不承诺固定小时数。
写明你想完成的操作、实际结果、已经尝试的步骤，并附最短可复现命令。若存在多人轮班使用节点，注明问题发生时是否有并行构建或图形会话，避免把任务冲突误判为节点异常。
紧急故障：节点不可达优先
SSH 与图形连接同时失败、节点无法用于正在进行的任务时，请在主题中注明“节点不可达”，并报告最后一次正常连接时间。换网络后的端口检查结果也应附上，帮助区分本地链路和节点侧问题。
紧急优先级用于安排排查，不等于承诺固定恢复时间。若仍能通过 SSH 访问，请说明哪项功能受影响；不要先执行擦盘、重装或反复断电，以免扩大影响并丢失诊断线索。
提交前准备这三组信息
-
订单与节点
提供订单号、机型与节点标识。可选节点为新加坡、东京、首尔、香港；不要发送机器密码、SSH 私钥或支付验证信息。
-
时间与影响
记录故障开始时间并注明时区，说明影响的是 SSH、图形桌面、构建任务还是付款核对，以及最后一次正常使用的时间。
-
结果与证据
粘贴脱敏后的命令输出、错误码和最短复现步骤。截图裁掉项目内容与凭据；同一个问题优先在原工单补充，保留完整处理上下文。
无法登录控制台，或需要售前、批量咨询及安全报告时，可发邮件至 support@xcodenode.com。邮件中同样不要包含密码、私钥、签名材料或完整银行卡信息。