工程支持台

先按顺序定位，再把问题交给正确的人

这里处理云端 Mac 的交付、远程连接、SSH、Xcode、CI/CD、存储与账单问题。先完成五项基础核对，通常能在一个检查回合内判断问题位于本地网络、访问资料、macOS 会话还是构建环境。

需要工程人员介入时，请在控制台工单中附上订单编号、目标节点、发生时间、截图和已执行步骤。不要提交密码、私钥或恢复凭据。

立即租用云端 Mac 登录控制台提交工单
7 类
问题入口
5 项
基础诊断
2 种
联系渠道
OVPS / INCIDENT ROUTE 快速诊断登记板
建议核对顺序 节点 → 网络 → 凭据 → 会话 → 客户端
  1. 01
    确认节点资料 订单编号、节点地址、端口与账户名对应同一台主机。
    基础
  2. 02
    验证网络路径 切换网络后复测，区分本地出口与目标节点问题。
    网络
  3. 03
    核对访问资料 检查凭据更新时间、SSH 密钥与主机指纹。
    身份
  4. 04
    检查 macOS 会话 确认图形会话、锁屏状态与后台任务是否仍在运行。
    会话
  5. 05
    排除客户端差异 记录客户端版本、显示参数、代理和报错原文。
    本地
全年 365 天正常运行 无法定位时转入控制台工单
先选问题类型

七个入口，避免从错误方向开始排查

选择最接近当前现象的入口。每张卡都给出第一步检查和需要保留的证据，不会隐藏其他问题类型。

交付

订单已提交，但访问资料尚未确认

先核对订单状态、所选机型和目标节点，再确认控制台是否已经生成节点地址、端口、账户名和连接说明。

  • 记录订单编号与提交时间
  • 确认所选节点与订单一致
  • 不要反复创建相同订单
远程连接

图形界面打不开、黑屏或频繁断开

先确认节点地址和端口，再用另一条网络复测。保留客户端名称、版本、显示设置与完整报错截图。

  • 确认会话没有停在锁屏界面
  • 降低显示分辨率后复测
  • 检查本地代理与防火墙规则
SSH

密钥被拒绝、指纹变化或连接超时

分别检查本地私钥权限、公钥内容、目标账户、端口和主机指纹。不要把私钥粘贴到工单或邮件。

  • 保留带时间的错误原文
  • 确认公钥没有换行损坏
  • 替换密钥后先保留旧会话
Xcode

版本不匹配、构建失败或缓存异常

记录 macOS、Xcode、项目提交与依赖版本。先做一次不改代码的环境确认，再决定是否清理缓存。

  • 保存第一条真实失败日志
  • 区分环境错误与代码错误
  • 清理前记录缓存目录占用
CI/CD

runner 离线、任务卡住或工作目录漂移

确认 runner 服务进程、注册范围、工作目录、并发任务和网络出口。先跑最小测试任务，再恢复完整流水线。

  • 记录失败任务编号
  • 检查 runner 最后在线时间
  • 确认磁盘没有被缓存占满
存储

磁盘空间下降、缓存过大或写入失败

先按目录统计占用，区分项目文件、依赖缓存、构建产物、日志与临时文件。不要直接删除来源不明的系统目录。

  • 记录可用空间与异常目录
  • 检查持续增长的日志文件
  • 清理后重新运行最小构建
账单

周期、节点、扩展项或付款记录需要核对

以美元账单中的机型、租期、节点、存储扩展和 Thunderbolt 5 并联数量逐项检查，再核对付款渠道记录。

  • 确认天、周、月或季周期
  • 核对扩展项数量与单价
  • 附订单编号，不提交支付密钥
先保留现场，再执行清理或替换。

构建日志、错误原文、客户端版本、磁盘占用和发生时间能显著减少往返确认。涉及凭据时只描述状态，不发送密码、私钥或恢复凭据。

五项基础核对

把“连不上”拆成可以验证的五个环节

每完成一步都记录结果。不要同时更换网络、密钥和客户端，否则问题恢复后也无法确定真正原因。

CHECKLIST / 05

快速诊断面板

按顺序执行
  1. 01
    节点信息

    在控制台确认订单编号、节点代码、节点地址、端口与账户名。复制信息时检查前后空格，不要凭记忆输入。

    输出：节点记录
  2. 02
    网络可达性

    记录当前网络、代理和出口环境，分别用原网络与另一条可信网络复测。若只有某一网络失败，优先检查本地出口限制。

    输出：网络对照
  3. 03
    凭据状态

    确认临时凭据是否已更新、SSH 公钥是否完整、私钥权限是否合理，并核对主机指纹是否与首次记录一致。

    输出：状态描述
  4. 04
    macOS 会话状态

    判断是整台主机不可达，还是只有图形会话无响应。若 SSH 仍可连接，先检查会话、锁屏和相关进程。

    输出：会话边界
  5. 05
    本地客户端设置

    记录客户端名称、版本、显示分辨率、色彩设置、代理和报错原文。使用另一兼容客户端复测时保持其他条件不变。

    输出：客户端对照
可以自行继续

已定位到单一环节

例如只有某个本地网络失败、只有旧密钥被拒绝，或仅某个客户端显示异常。一次只改一个变量并重新验证。

查看连接指南
需要工程支持

跨网络与客户端仍可复现

把五项核对结果、发生时间和错误截图放进同一张工单。工程人员可直接按证据继续检查节点与会话。

打开控制台工单
术语小词典

先统一对象，避免把协议、会话和主机混在一起

这些词会出现在交付资料、连接说明与工单回复中。描述问题时尽量使用对应术语。

云端 Mac
通过网络访问的 macOS 工作环境，可用于 Xcode 构建、自动化测试、脚本任务和本地模型推理。它描述的是使用方式，不代表虚拟化。
物理节点
实际承载订单的 Apple Silicon 主机及其所在网络位置。节点资料通常包括地址、端口和区域代码。
独享
一笔有效租用对应一台专用物理主机，不与其他租户共享同一台主机的计算资源。
非虚拟机
交付对象是独享物理机，不是从共享宿主机切分出的虚拟实例。排障时应同时区分主机状态与远程会话状态。
VNC
用于访问 macOS 图形界面的远程桌面协议。适合操作 Xcode、查看图形化工具和验证桌面会话。
SSH
用于命令行登录、脚本执行、文件处理和 CI/CD 管理的安全连接方式。连接时需要核对地址、端口、账户、密钥与主机指纹。
self-hosted runner
部署在所租主机上的持续集成执行器。项目范围、工作目录、并发数和缓存策略由团队自行配置。
恢复会话
远程桌面断开后重新进入原有 macOS 会话。恢复的是图形会话，不等于重启主机或重新创建构建环境。
连接排障手册

首次登录、密钥替换与画面异常分别处理

展开与当前现象一致的条目，按顺序执行。每次只改变一个条件，复测后再进入下一步。

首次远程登录失败，应该先检查什么？

先从控制台重新复制节点地址、端口和账户名，确认这些资料来自同一笔订单。随后检查本地网络是否启用了代理、端口限制或额外防火墙规则。

  1. 记录客户端名称、版本和完整错误文字。
  2. 确认输入框中没有多余空格，账户名大小写保持不变。
  3. 换一条可信网络复测，但不要同时更换凭据。
  4. 若 SSH 可达而图形界面不可达，在工单中明确写出这一差异。
更新临时凭据后，旧连接为什么仍然失败？

先完全退出保存旧凭据的客户端，再重新建立连接。部分客户端会缓存账户名或认证信息，仅修改界面上的密码字段并不一定清除旧记录。

确认新凭据可以使用后，再删除旧记录。不要在工单、截图或邮件中展示密码内容，只需说明更新时间、使用的账户名以及错误类型。

如何安全替换 SSH 密钥而不锁住自己？

保持当前已连接的 SSH 会话开启，先添加并验证新公钥。使用第二个终端建立新连接，确认新密钥成功后，再移除旧公钥。

  1. 为这台主机生成独立密钥，不复用来源不明的密钥文件。
  2. 检查公钥单行内容是否完整，避免复制时换行或截断。
  3. 核对本地私钥权限和目标账户。
  4. 保存主机指纹记录；若指纹意外变化，暂停连接并提交工单核对。
VNC 出现黑屏、花屏或输入延迟时怎么处理？

先判断 SSH 是否仍然可用。若命令行连接正常，问题更可能位于图形会话或客户端显示参数，而不是整台物理节点离线。

降低客户端分辨率和色彩质量，关闭本地代理后复测，并记录问题是否只发生在全屏、缩放或多显示器模式。不要连续强制结束多个系统进程。

感觉延迟较高时，怎样得到可复测的结果？

记录本地网络类型、目标节点、测试时段、使用协议和客户端版本。分别在原网络与另一条可信网络上执行相同步骤，并保持分辨率、代理和任务负载一致。

不要只提供“很慢”的结论。工单中应注明输入响应、画面刷新、文件传输或命令回显中的哪一项变慢，以及问题是否持续出现。

构建问题处理

先固定环境，再分析 Xcode、runner 与磁盘

构建排障的目标不是立刻清空所有缓存，而是找出哪一层发生变化，并留下可复现记录。

步骤 01

确认 Xcode 与 macOS 版本

记录当前 Xcode 完整版本、命令行工具路径、macOS 版本和项目提交。若团队有固定基线，先与上一次成功构建记录对照。

xcodebuild -version
xcode-select -p
sw_vers
步骤 02

核对签名环境边界

确认项目设置、证书文件、描述文件和构建脚本的引用关系。工单可以提交被遮盖敏感字段后的错误截图，但不要上传签名私钥或密码。

  • 保留第一条签名错误原文
  • 记录失败 target 与构建配置
  • 区分本地脚本错误和项目配置错误
步骤 03

有证据地清理缓存

先记录 DerivedData、依赖缓存和工作目录占用，再只清理与失败项目相关的目录。清理后执行一次最小构建，避免并发任务覆盖结果。

du -sh ~/Library/Developer/Xcode/DerivedData
df -h
步骤 04

重新连接 CI runner

检查 runner 服务进程、注册范围、工作目录和最后在线时间。用不含发布动作的最小测试任务验证网络、权限和执行环境。

  • 记录失败任务编号和时间
  • 确认没有重复注册同一执行器
  • 检查工作目录所有权与剩余空间
步骤 05

检查磁盘增长来源

按项目文件、依赖、构建产物、日志与临时文件分类统计。若空间持续下降，记录增长目录和观察间隔，再提交工单。

df -h
du -sh ~/Library/Developer/*
du -sh ~/Library/Caches/*
不要把环境重置当作第一步。

先保留日志、版本、磁盘占用和失败任务编号。直接清空全部缓存或覆盖配置可能让问题暂时消失，却同时失去定位依据。

账单帮助

按周期、配置、节点与加购项逐行核对

所有订单均以美元计价和结算。实际可用网关以控制台实时返回为准。

美元计价

先确认租用周期

账单周期可能是天、周、月或季。不要用日价直接推算其他周期，订单应以所选机型对应的目录价格为准。

付款记录

只核对两类支付方式

支持 USDT-TRC20，以及 Visa / Mastercard / Amex（经 Stripe）。工单只需提供订单编号和交易记录中的非敏感标识。

节点与扩展

逐项检查账单组成

确认机型、租期、目标节点、附加存储类型与 Thunderbolt 5 并联数量。可用状态以控制台实时返回为准。

附加选项四种租用周期价格
附加选项 每天 每周 每月 每季
+1TB SSD $2.6 $7.1 $13.2 $35.9
+2TB SSD $5.2 $14.2 $26.4 $71.8
Thunderbolt 5 并联（每台） $2 $5.3 $9.9 $26.9
账单工单建议附带什么？

提供订单编号、机型、租用周期、目标节点、加购项名称与数量，以及付款记录中的非敏感交易标识。不要发送银行卡完整号码、验证码、钱包私钥或密码。

提交工单

让工程支持拿到可以直接开始排查的信息

使用中的节点问题优先通过控制台工单提交；无法登录控制台时，可发送邮件至 support@officevps.com。

SUPPORT PACKET

一张完整工单应包含六项内容

不含敏感凭据
01
订单编号

从控制台复制完整编号，避免只写机型名称或节点城市。

02
目标节点

注明新加坡、日本（东京）、韩国（首尔）、香港、美国东部或美国西部中的实际订单节点。

03
发生时间

写明本地时间与时区，并说明问题是持续出现还是间歇复现。

04
错误截图或日志

保留错误原文和上下文，遮盖账户凭据、私钥、签名材料与其他敏感内容。

05
已执行步骤

按顺序列出测试网络、客户端、命令和每一步结果，避免只写“已经全部试过”。

06
期望结果

说明希望恢复连接、确认账单、重连 runner，还是定位具体构建失败。

使用中问题

控制台工单

适合节点、连接、构建、存储和账单问题。订单上下文可与工单保持在同一账户中。

登录控制台
无法登录

支持邮箱

发送邮件时写明账户邮箱、订单编号和问题摘要。不要附带密码、私钥或恢复凭据。

联系 support@officevps.com
升级路径

知识条目无法解决时，按状态继续推进

工单状态用于说明当前责任方和下一步动作。回复时沿用原工单补充材料，不要为同一问题重复创建多张工单。

01
已提交

材料已进入队列

检查订单编号、节点、发生时间、错误记录和已执行步骤是否齐全。缺少信息时可在原工单继续补充。

02
处理中

工程人员正在复核

可能检查节点连通、会话状态、交付记录或账单组成。此时避免重复修改环境，以免新的变量覆盖现场。

03
待补充

需要更多可复测信息

按工单问题补充日志、截图、网络对照或客户端版本。只提交相关片段，并继续遮盖敏感字段。

04
已解决

验证恢复并记录结果

用原有工作流完成一次复测，记录真正原因、有效步骤和环境版本，为团队后续处理保留基线。

进入控制台工单 查看首次启用步骤
准备部署

选择独享物理机，把构建环境交付到合适节点

三档 Apple Silicon 配置覆盖轻量构建、日常开发、并行 CI 与本地模型推理。仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe），一律以美元（USD）结算。

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