首次连接
先核对地址、端口与账户
确认使用订单内的主机地址、连接端口和账户名。首次 SSH 连接应人工核对指纹；VNC 则先使用默认分辨率和中等画质建立基线。
进入连接排查
技术支持入口
从错误现象出发，定位云端 Mac 问题
输入报错片段、工具名称、连接方式或订单主题。本文档覆盖首次连接、权限、macOS 操作、Xcode 构建、节点网络、存储扩展、账单与支付。
HELP ROUTER
先判断问题发生在哪一层
01
连接层凭据、端口、SSH、VNC、本地网络
02
构建层xcodebuild、fastlane、签名环境、缓存
03
节点层地区选择、延迟、抖动、传输任务
04
订单层周期、节点、附加项、支付与服务状态
建议先记录原始报错
不要先清空全部环境；保留可复现证据更容易定位根因。
按发生阶段选择入口
七组主题同时展开，不需要逐个筛选。先从最接近现象的主题进入，再按检查顺序缩小范围。
账号权限
区分登录失败与操作权限不足
能登录但无法写入目录，通常应检查文件所有者、目录权限和命令执行身份；完全无法登录，则优先检查凭据、密钥权限和连接目标。
查看判断路径
macOS 操作
先检查资源，再修改系统设置
查看磁盘余量、内存压力、占用 CPU 的进程和系统时区。涉及版本或工具链调整时，先记录当前状态，避免一次修改多个变量。
查看首次配置
Xcode 构建
保留完整命令与首个失败点
记录 Xcode 版本、scheme、configuration、目标平台和原始命令。日志应从第一个明确错误开始分析，而不是只截取最后一行失败摘要。
打开构建手册
网络延迟
分别判断时延、抖动与传输占用
单次 ping 不能代表交互体验。连续采样并观察中位数、抖动和丢包，同时排除本地 Wi-Fi、代理、上传任务与高画质远程桌面的影响。
比较节点方向
存储扩展
先确认工作集与缓存增长速度
区分源代码、依赖缓存、构建产物和素材文件。扩展前记录当前可用空间与每日增长量，再决定是否选择 +1TB SSD 或 +2TB SSD。
查看附加选项
订单账单
逐项核对周期、节点与附加项
账单问题不要只提供总额。应同时记录订单标识、机型、计费周期、所选节点、SSD 扩展和 Thunderbolt 5 并联项。
查看订单说明先定位失败发生在认证、网络还是画面层
不要同时更换客户端、网络和凭据。每次只改变一个条件，并保留对应时间点与错误文本。
01
凭据错误
出现 Permission denied 或密钥认证失败时，核对用户名、私钥文件、密钥权限和是否选错主机。不要反复猜测凭据。
检查结果
主机可达，认证未通过
02
端口不可达
出现超时或拒绝连接时，先确认地址和端口，再从另一条网络测试。超时通常表示路径不通；立即拒绝则表示目标可达但端口未接受连接。
检查结果
认证尚未开始
03
远程桌面画面异常
能建立会话但黑屏、花屏或严重卡顿时，先降低分辨率与画质，关闭后台大文件传输，再断开并重新建立会话。
检查结果
连接已建立，显示链路异常
04
本地网络限制
同一节点在手机热点可用、办公网络不可用时，优先检查本地防火墙、代理策略、出口限制和 Wi-Fi 丢包，而不是立即更换云端节点。
检查结果
服务侧正常，本地路径需排查
保留环境事实，再处理构建失败
构建日志的价值取决于上下文。至少同时提供工具版本、执行命令、工作目录、目标与首个失败点。
| 问题类型 | 先检查 | 建议动作 | 保留信息 |
|---|---|---|---|
| xcodebuild | scheme、configuration、destination、SDK 与工作目录 | 使用同一条完整命令重跑，并从第一个明确错误开始定位 | 命令、退出码、Xcode 版本、失败上下文 |
| fastlane | Ruby 环境、依赖锁定文件、lane 参数与工作目录 | 优先使用项目锁定的依赖运行，避免临时升级整套工具 | lane 名、调用参数、依赖版本、原始输出 |
| 签名环境 | 证书有效性、描述文件匹配关系、钥匙串访问权限 | 核对 bundle identifier、团队设置与目标配置，不上传未脱敏签名材料 | 目标名称、签名方式、脱敏后的错误文本 |
| 缓存清理 | DerivedData、包管理器缓存与磁盘余量 | 只清理与失败目标相关的缓存，避免把全部环境同时重置 | 清理前后命令、磁盘余量、依赖解析结果 |
| 日志采集 | 时间范围、时区、命令退出码与结果包 | 保存文本日志和必要的结果包，截图只作为补充 | 发生时间、复现步骤、首个错误及其前后输出 |
最小复现
先证明同一命令能稳定失败
如果失败只在自动化任务中出现，使用相同工作目录、环境变量和依赖版本手动执行一次。手动成功而队列失败时，再比较执行身份、工作目录和环境注入差异。
xcodebuild -scheme App -configuration Release build
echo $?
sw_vers
xcodebuild -version五个在售节点，按主要访问方向选择
当前目录仅包含新加坡、东京、首尔、香港、美国西部。两档机型在这五个节点均可订，实际可用状态以控制台实时返回为准。
新加坡
适合主要访问者位于东南亚的工作流。比较节点时，应使用实际办公网络连续测试，而不是仅参考地理距离。
东南亚方向东京
适合日本及东亚方向的交互任务。需要长时间使用 VNC 时，应同时观察延迟、抖动与画面码率。
日本与东亚方向首尔
适合韩国及东北亚方向。若 SSH 响应正常但画面卡顿，应先降低远程桌面画质并暂停后台传输。
韩国与东北亚方向香港
适合华南与部分东南亚方向。企业网络与家庭网络的出口路径可能不同，选型前应在真实使用网络中测试。
华南方向美国西部
适合北美西岸方向以及需要靠近当地协作链路的任务。跨洲访问应优先评估交互延迟，再评估大文件传输。
北美西岸方向
就近不等于只看地图
先从地理上较近的节点开始，再在同一网络、同一时段完成连续采样。比较中位延迟、抖动、丢包和 VNC 操作反馈；如果多个成员跨地区协作，应以主要交互者和大文件传输方向共同决定节点。
把订单内容与支付记录分开核对
订单配置决定交付内容，支付记录决定结算状态。提交问题时应分别提供两组信息，避免只发送付款截图而缺少订单标识。
订单问题：先打开控制台核对当前配置
依次检查订单标识、Lemon M4 或 Lemon M4 Pro、日/周/月/季周期、所选节点、SSD 扩展、Thunderbolt 5 并联项与当前服务状态。
- 机型规格应与订单摘要一致。
- 节点应为新加坡、东京、首尔、香港、美国西部之一。
- 附加项应与账单明细逐项对应。
- 可用性以控制台实时返回为准。
支付帮助：只核对支持的两类渠道
所有订单均以美元（USD）结算。实际可用网关以后端返回为准，支持范围仅包括以下两类：
- USDT-TRC20：核对网络类型、收款信息、金额与交易标识，转账前逐字确认。
- 银行卡：Visa / Mastercard / Amex，经 Stripe 处理；按结账页提示完成验证。
若支付状态与订单状态不一致，请保留订单标识、支付时间、金额和脱敏后的交易凭证，不要提交完整卡片信息或访问令牌。
六项信息可以显著缩短往返确认
请删除私钥、助记词、完整访问令牌和未脱敏签名材料。支持团队需要可复现信息，不需要敏感凭据。
01
订单标识
提供控制台中可见的订单标识，不要只写机型名称或付款金额。
02
发生时间
写明问题发生的时间和时区；间歇性问题还应记录最近一次正常时间。
03
所选节点
注明新加坡、东京、首尔、香港或美国西部，并说明主要访问者所在方向。
04
复现步骤
从已知正常状态开始，按实际操作顺序列出命令、界面动作与失败位置。
05
截图或脱敏日志
优先提供可复制的错误文本；截图应包含必要上下文，日志应保留首个错误前后的输出。
06
预期与实际结果
分别说明你预期发生什么、实际发生什么，以及问题是否可以稳定复现。
支持渠道只有两种
登录控制台提交工单，适合关联现有订单与服务状态；或发送邮件至 support@lemonvm.com，适合售前选型和无法登录控制台的情况。
准备开始
确认用途、节点与周期，再选择物理节点
两档机型、五个节点、日周月季四种周期均在下单流程中明确展示。购买后可在控制台查看配置和服务状态。