连接与登录
拿到凭据后，先核对地址、端口与登录用户，再检查本地网络和客户端。
按问题找入口
把问题分成四类，少走一步弯路
先确认问题发生在哪一环。连接失败不一定是节点异常，支付未确认也不等于需要再付一次。
计费与续租
从订单状态开始检查。核对租期、支付方式与交易记录，不凭客户端提示判断到账。
系统与环境
把连接层与工具层分开。能登录但构建失败，优先记录工具版本和完整错误输出。
网络与节点
城市距离只是选点起步。实际路由、客户端画质和文件大小也会影响远程体验。
连接排障
先核对凭据，再检查网络
不要一上来就重装机器。记录错误原文，区分超时、拒绝连接与认证失败，支持团队才能判断问题所在。
SSH 超时：连接没有到达登录阶段
若提示连接超时，优先检查网络路径，而不是反复输入密码。若提示连接被拒绝，则需要确认端口与服务状态；若提示认证失败，转到下方凭据检查。
- 01重新复制地址
打开控制台实例详情，复制当前主机地址和 SSH 端口。清除粘贴时的空格，不沿用旧订单或旧节点的连接记录。
- 02检查本地出口
确认本地网络允许访问该端口。公司网络、代理或安全软件可能限制出站连接；可换到你有权限使用的另一网络做对照。
- 03查看实例与规则
在控制台核对实例状态，并检查你设置的防火墙与来源 IP 限制。不要为排障直接开放所有端口；先确认当前出口 IP 是否在允许范围。
在自己的终端查看详细连接日志，替换大写字段后执行：
ssh -vv -p SSH_PORT USER@HOST提交日志前，遮盖主机地址、用户名和本地路径等敏感信息。不要上传私钥或密码。
屏幕共享黑屏：先确认会话，再降低画质
图形界面黑屏与 SSH 不通是两类问题。先尝试 SSH，判断机器是否可以访问；若命令行正常，排查重点转到图形会话与客户端配置。
- 01核对连接方式
按实例详情显示的信息连接，不把 SSH 端口当作屏幕共享端口。确认客户端使用的协议、主机和认证方式一致。
- 02重连当前会话
断开客户端后重新连接，检查是否停在锁屏或登录界面。避免多个客户端同时调整显示设置，让问题更难复现。
- 03降低传输负担
先降低分辨率与画质，停止大文件上传后再试。若只有特定客户端黑屏，记录客户端版本及设置，连同截图提交工单。
凭据失效：不要把认证失败当成断网
出现认证失败通常说明连接已到达服务端。核对登录用户和认证方式，比反复更换节点更有帮助。
- 01核对当前用户
使用当前实例的登录用户名。重装系统或迁移后重新读取连接信息；你自行修改过密码时，使用修改后的密码。
- 02确认密钥对应
指定与机器上公钥对应的私钥，检查本地私钥文件权限。不要把公钥文件作为私钥传给 SSH，也不要把私钥发给支持团队。
- 03保留错误原文
记下失败发生的时间、认证方式和错误信息。如果重装后出现主机密钥变化，先通过控制台确认实例身份，再更新本地记录。
计费与支付
先看订单状态，不重复付款
仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe），全部以美元结算。实际可用网关以控制台返回为准。
USDT-TRC20 已转出，订单为什么还未确认？
钱包显示转出，不代表订单已完成确认。核对支付页给出的网络、收款地址与应付金额，再查看交易在链上的状态。USDT-TRC20 的到账确认取决于链上进度，不承诺固定确认分钟数。
回到控制台查看订单支付状态，不要向已关闭或不属于当前订单的支付信息转账。若交易已确认而订单仍未更新，提交订单编号、交易哈希、转账金额与转账时间，并标明时区。不要提交钱包私钥、助记词或密码，也不要因为等待而重复转账。
Visa / Mastercard / Amex 支付失败怎么办？
先看支付页错误信息。常见检查项包括卡片是否允许线上与美元交易、可用额度是否足够、账单信息是否一致，以及发卡行要求的验证是否完成。必要时联系发卡行确认拒绝原因，不要连续高频重试。
如果浏览器中断、验证页关闭或页面返回异常，先检查控制台订单状态，再决定是否重试。提交工单时只提供订单编号、错误提示和发生时间；截图应遮盖敏感信息。完整卡号与安全码不需要发给我们，卡片支付信息由 Stripe 处理。
怎样续租、核对美元金额与下载账单？
在控制台核对当前订阅的到期时间，选择续租并确认报价。付款前检查机型、周期、节点与附加项，付款后再确认新的租期是否显示。服务按天、周、月、季预付，不按小时计费；续租金额与生效时间以订单确认信息为准。
所有目录价格均为美元。XN Core M4 按天 $21.4、按周 $57.7、按月 $106.8、按季 $290.5；XN Pro M4P 按天 $59.3、按周 $160.1、按月 $296.4、按季 $806.2。核对账单时，分别查看基础租金与已选择的附加项。账单与可下载文件从控制台账单记录中查看；若下载失败，附上账单编号提工单。
到期前会有续租提醒，但不要把提醒当作备份计划。设置自己的日历提醒，提前确认付款与租期，重要产物持续同步到你自己的存储。
系统与环境
先保留工作，再调整环境
独享物理机、非虚拟机；macOS 图形界面与命令行可用。工具安装、版本切换与重装之前，先确认备份和项目依赖。
重装 macOS 前需要准备什么？
先停止正在运行的构建、传输与实验任务，再备份代码、产物、环境配置和需要保留的证书文件。重装会改变系统环境，也可能清除本地数据，不应作为连接排障的第一步。
登录控制台查看当前实例的重装选项与确认说明；需要协助时，从该订单提交工单，说明希望重装的实例及已完成的备份。完成后重新读取连接凭据，检查 macOS 版本、工具路径与磁盘，再恢复项目。不要凭旧连接记录判断新环境是否异常。
怎样确认和切换 Xcode 与命令行工具？
先确认项目要求的 Xcode、SDK 与 macOS 版本，再检查当前选择的开发者目录。机器上有多个 Xcode 版本时，图形界面打开的版本不一定与命令行构建使用的版本一致。
xcode-select -p
xcodebuild -version
uname -m
df -h前三条分别查看开发者目录、Xcode 版本与架构，最后一条检查磁盘空间。Apple Silicon 原生架构输出应为 arm64。需要切换时，先确认目标应用路径真实存在，再用 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 选择对应目录；该命令会影响后续命令行构建。
使用 Homebrew 前，检查 command -v brew 与 brew --version，确认命令来自你预期的环境。安装依赖时按项目锁定版本执行，不要同时改动工具链、依赖与构建脚本。若失败，提交工具版本、执行命令与错误末段，比只写“编译不了”更容易定位。
到期前该备份哪些文件，怎样验证？
至少整理三类内容：未推送的代码与项目配置、构建产物与实验结果、恢复环境所需的依赖清单和授权文件。证书与密钥应加密保存，按团队权限分发，不要混进公开仓库或工单附件。
可通过 scp 或 rsync 将文件同步到你自己的存储。先传一小份文件验证路径、权限与可读性，再传完整目录；完成后比对文件数量、大小或校验值，并实际打开关键产物。附加 SSD 是外接扩展，不是独立备份，也不代表数据会自动跨节点同步。
不要依赖到期后的数据恢复。具体保留与清除安排以控制台提示及适用规则为准；有特殊迁移需求，应在租期结束前提交工单并完成备份。
网络与节点
先选接近工作流的节点，再做实际验证
六个节点都提供两档机型。选择时同时考虑操作者的位置、代码与产物的传输方向，以及日常使用 SSH 还是图形界面。
六个节点怎样选，延迟该怎样判断？
先按地理位置缩小范围，再用自己的网络验证。下表是选点方向，不是实测延迟承诺；运营商路由与本地网络会改变体验。SSH 对连续画面传输的需求较低，屏幕共享则更容易受到往返延迟与带宽影响。
| 节点 | 优先考虑的用户区域 | 连接时先检查什么 |
|---|---|---|
| 新加坡 | 东南亚 | 对比日常网络下的交互响应与代码同步速度。 |
| 日本（东京） | 东亚 | 用常用屏幕共享客户端，先从较低画质开始验证。 |
| 韩国（首尔） | 东北亚 | 对比本地出口路由，不只依据地图上的距离。 |
| 香港 | 华南与东南亚 | 检查本地网络限制与大文件上传时的响应变化。 |
| 美国东部 | 北美东部与西欧 | 同时观察构建产物回传与交互连接表现。 |
| 美国西部 | 北美西岸 | 核对团队、代码存储与产物接收端的位置。 |
若操作时卡顿，先暂停大文件传输、降低屏幕共享分辨率，再做对照。仍然明显异常时，记录本地网络类型、节点、客户端版本和问题时段；不要仅凭一次测试就判断整个节点不可用。
怎样跨区迁移到另一节点？
先在原实例备份数据，记录工具版本、环境变量、任务配置与网络允许规则。然后在控制台确认目标节点的订单安排；涉及现有订阅调整时，先提交工单确认费用与生效方式，不假定城市切换会自动迁移磁盘。
目标实例可连接后，再恢复文件并验证编译、签名、产物上传和定时任务。更新团队使用的主机地址与来源 IP 规则，确认新实例工作正常后处理原实例。迁移期间不要让两端同时执行会产生重复结果的发布任务。
六个节点分别提供哪些机型？
新加坡、日本（东京）、韩国（首尔）、香港、美国东部、美国西部均提供 XN Core M4（M4 / 16GB / 256GB SSD）与 XN Pro M4P（M4 Pro / 64GB / 2TB SSD），目录内组合均为充足，实际可用状态以控制台实时返回为准。
常规 App 编译与 CI 可先选 XN Core M4；重型并行构建与需要较大统一内存的实验可考虑 XN Pro M4P。额外存储可选外接 +1TB SSD 或 +2TB SSD，不改变机型本身的主盘规格。节点全年 365 天正常运行；连接异常时仍应按网络、认证与系统三个层次逐项定位。
工单准备
把已经检查的结果，一次说清楚
登录控制台，在工单区选择相关订单并描述问题。订单信息留在工单里，公开咨询不发送连接密码或完整支付信息。
提交前准备这四项
- 01订单与实例
提供订单编号、节点城市与机型名称。多台实例时明确是哪一台，避免把另一台机器的日志混进来。
- 02时间与现象
写出首次发生时间和时区，是持续失败还是偶发。说明最后一次正常操作，以及问题出现前改过哪些设置。
- 03复现与检查
列出执行步骤、客户端或工具版本、错误原文，以及已完成的检查。可说明另一网络、另一客户端的对照结果。
- 04脱敏附件
附必要截图或日志片段。移除密码、私钥、证书敏感内容和支付安全信息；保留与问题相关的错误码。
可以按这个顺序写
节点与机型 → 订单编号 → 问题时间及其时区 → 预期结果 → 实际错误 → 已尝试的检查。若影响构建或发布，补充当前受影响的任务，不要只写“很急”。
提交后，在同一工单补充新结果，保留完整上下文。响应时段、处理进度与预计回复以控制台显示及工单回复为准；这里不承诺未经确认的固定响应小时数。节点运行时间与人工回复时间是两回事。
还没找到答案？
选型发邮件，实例问题提工单
还没下单，可以说明用途、预计租期与所在区域，咨询机型和节点。已有订单，请从控制台提交工单，方便把问题与实例对应起来。
售前、团队采购与其他咨询统一联系 support@xcodenet.com。不需要通过邮件发送密码、私钥或完整卡片信息。