按任务开始排查

连接、配置、构建或网络问题,从对应检查单开始

BerryVM 提供整台独享的云端 Mac 物理节点。这里不让你在泛泛的帮助目录里兜圈:先确认故障发生在哪一层,再按顺序收集结果。多数环境问题可以在提交工单前定位到连接、系统、依赖、构建或网络中的一层。

服务形态
独享物理机,非虚拟机
节点范围
新加坡、东京、首尔、香港、美国东部
支持资料
订单标识、节点、时间、步骤、脱敏日志
首次接入

先完成四项核验,再开始安装项目环境

访问资料只用于建立初始会话。连接成功不等于交付核验完成;先更新凭据、确认设备配置和节点,再把代码、密钥或构建任务放入机器。

交付资料

核对订单与访问资料

确认订单标识、分配节点、设备名称、连接方式和资料更新时间一致。不要把访问资料转发到公开频道,也不要把凭据写进项目仓库。

  • 订单标识与控制台记录一致
  • 节点属于本次订单选择范围
  • 设备名称与交付记录一致
访问控制

首次进入后更新凭据

使用交付资料建立会话后,立即换成团队自管的高强度凭据。不同成员使用各自受控的访问方式,避免长期共享同一份秘密。

  • 更新初始登录凭据
  • 移除不再使用的访问授权
  • 将恢复资料放入受控保管系统
设备核验

确认物理设备与系统信息

检查芯片、内存、存储容量、macOS 版本、时区和剩余磁盘。基础档应为 M4、16GB、256GB;高内存档应为 M4 Pro、64GB、2TB。

  • 规格与所选机型逐项一致
  • 时区符合团队任务安排
  • 系统盘留有构建和缓存空间
会话验证

建立可恢复的安全会话

分别验证图形界面和命令行路径,记录本地网络、连接协议与测试时段。长时间任务应放进可恢复的会话或 Runner,不要依赖单一前台窗口持续在线。

  • 验证图形界面与命令行均可用
  • 确认睡眠与电源策略符合任务需求
  • 断开并重新连接一次,验证恢复路径
环境初始化

让工具链可复现,而不是只在当前会话里能跑

先固定系统与工具版本,再恢复依赖、缓存和 Runner。每一步都留下可重复执行的清单,后续迁移、重建或扩展设备时不必从个人记忆重新拼装。

INITIALIZATION SHEET

开发环境基线

MAC / BASELINE
Xcode

确认项目要求的主版本、命令行工具选择路径、可用 SDK 与构建目标。升级前先检查现有流水线和依赖兼容性。

先固定版本
命令行工具

检查编译器、Git、Shell、Ruby、Python 与 Node.js 的实际路径,避免交互会话和 Runner 读取到不同环境。

核对路径
Homebrew

导出公式、图形应用和私有源清单,按项目需要分批恢复。迁移后逐项验证版本,不直接复制不明来源的整个目录。

清单恢复
Swift

对照项目声明检查 Swift 与 SDK 组合,使用一个最小工程验证编译、测试与归档路径,再运行完整项目。

最小验证
CI Runner

确认执行用户、工作目录、环境变量来源、缓存位置、并发数和日志保留策略。敏感值通过受控变量注入。

独立上下文
迁移顺序

先声明,再安装,最后验证

  1. 导出清单:版本、依赖、源、Runner 标签与项目脚本。
  2. 恢复基础层:Xcode、命令行工具和包管理器。
  3. 恢复项目层:锁文件、私有源、缓存与环境变量。
  4. 运行验证:编译、测试、归档和产物校验分别执行。
不要直接复制秘密

凭据与项目文件分开迁移

代码仓库、构建缓存、签名资料和访问凭据不是同一类数据。按最小权限分别迁移,日志只保留定位所需字段,提交支持请求前先脱敏。

检查安全措施
故障定位

按故障层检查,不要同时改动所有变量

先复现并保留失败现场,再只改变一个条件。下列五条路径覆盖连接、构建、磁盘、依赖和节点网络问题;每条都给出提交支持请求前应拿到的证据。

A

无法建立远程连接

先确认订单仍在有效租期、访问资料是否更新、目标节点和协议是否正确。再从另一条本地网络测试,区分客户端设置、本地出口与节点路径问题。

  • 保留客户端错误全文和发生时间
  • 记录本地网络类型、协议与目标节点
  • 验证同一资料在另一受控客户端上的结果
输出:连接层结论
B

构建失败或归档中断

用同一提交、同一工具版本和同一命令再次运行。先关闭与问题无关的并发任务,比较交互会话和 Runner 的用户、路径、环境变量与权限差异。

  • 附上失败命令、退出码和首个有效错误
  • 记录 Xcode、SDK、Swift 与依赖版本
  • 说明是否只在 Runner 或只在交互会话复现
输出:工具链差异
C

磁盘空间不足

分别检查项目工作区、构建产物、模拟器数据、包管理缓存和 Runner 缓存。不要只看根目录总量;找出增长最快的目录并确认其是否可安全重建。

  • 记录剩余容量和主要目录占用
  • 区分源文件、可重建缓存与最终产物
  • 清理前保留最近一次异常增长的路径信息
输出:空间归因
D

依赖安装或版本解析异常

核对锁文件、包源、代理、架构和执行用户。清缓存前先保存失败输出;无差别删除所有缓存可能让原本可比较的现场消失,并扩大下载与解析变量。

  • 确认锁文件是否随提交变化
  • 记录实际读取的包源与工具路径
  • 使用最小依赖集合验证网络和解析能力
输出:依赖层结论
E

节点网络出现波动

从相同来源、相同协议、相近时段连续取样,并与另一网络出口对照。单次 ping 不能代表构建产物上传、仓库拉取或远程桌面会话的完整路径。

  • 记录源网络、目标节点、协议和样本次数
  • 同时保留延迟、丢包与应用层错误
  • 说明受影响的是连接、仓库、依赖源还是产物目的地
输出:路径对照
服务连续性

99.9% 可用率目标如何阅读

可用率不是单次连接速度,也不等同于任一第三方网络路径的质量。判断服务事件时,应结合节点状态记录、订单有效期、影响范围和服务条款中的统计口径。

SERVICE AVAILABILITY TARGET 99.9% 服务可用率目标

所有节点全年 365 天正常运行。适用范围、排除情形、申请时限与补偿方式以服务条款为准。

查看统计与补偿口径
近 90 天逐日状态条 每格代表一个自然日
正常状态
第 1–30 天
第 31–60 天
第 61–90 天

状态格用于快速阅读逐日记录;工单判断仍以可核对的节点记录、影响时段和条款适用范围为依据。

知识文章

把常见配置与迁移任务拆成可复用步骤

文章按发布日期排序,覆盖 MLX、Homebrew、部署方式对比、React Native 构建、远程调试准备与数据保护边界。

新稿正在整理

知识库文章发布后会在这里按日期展示。现在可先从上方检查单完成连接、环境、构建与网络排查。

提交支持请求

一张可追踪的工单,应当包含这些信息

支持人员需要先复现或定位问题层。完整上下文可以减少来回追问,但不要为了“完整”而发送访问密码、令牌、私钥或未脱敏项目数据。

SUPPORT REQUEST

问题上下文清单

5 REQUIRED FIELDS
订单标识
填写控制台中可核对的订单标识,不使用自定义项目代号代替。
节点
新加坡、东京、首尔、香港或美国东部,并说明是否只影响该节点。
故障时间
提供含时区的开始时间、持续时长和最近一次正常时间。
复现步骤
从初始状态写到首个错误,每一步注明命令、工具版本和实际结果。
脱敏日志
保留错误上下文、退出码和组件版本,移除凭据、令牌、个人数据与项目秘密。
控制台工单

运行中的订单优先走工单

工单能关联订单与节点记录,适合连接异常、设备状态、构建环境、账单和服务事件。提交后可在同一线程补充脱敏日志和复现结果。

登录控制台创建工单
联系分流

一般咨询、计费问题和运行故障走不同路径

先选择能关联最多上下文的渠道。运行中的设备问题优先进入控制台工单;尚未下单的一般咨询可通过支持邮箱联系。

一般咨询

配置、节点与使用边界

说明目标工作负载、候选配置、预计租期和团队所在区域。不要发送敏感项目文件,只需描述任务类型与资源要求。

查看联系方法
订单与计费

付款状态、账单或租期问题

登录控制台并关联具体订单。BerryVM 全部以 USD 结算,仅支持 USDT-TRC20 与 Visa / Mastercard / Amex(经 Stripe)。

提交计费工单
运行中故障

连接、设备或节点异常

附上订单标识、节点、含时区的故障时间、影响范围、复现步骤和脱敏日志。不要只提交截图,也不要发送访问凭据。

立即提交故障工单
需要一台可直接开始工作的云端 Mac

按任务选择配置与周期,再从五个节点中完成交付

Berry M4 适合轻量构建与日常开发,Berry M4 Pro 面向更高内存需求的构建和 MLX 实验。下单前核对机型、日周月季租期、节点与附加存储。