工程支持手册

把云端 Mac 从连通到稳定运行

按实际操作顺序完成凭据核对、VNC 远程桌面连接、环境迁移与构建诊断。每一步都给出检查结果和下一步，不让问题停在模糊描述里。

登录控制台提交工单 立即租用云端 Mac
服务对象
独享物理 Mac mini
常规交付
约 4 分钟
支持方式
控制台工单或邮件
RUN / CONNECT-01

首次连接核对单

可执行
凭据已获取 控制台实例详情
01
网络可达 目标地址与端口连通
02
桌面已进入 VNC 会话显示 macOS 图形界面
03
验收结果

机型、内存、存储与所选节点一致后，再同步项目和构建缓存。

按问题进入

六个帮助主题，直接定位操作路径

先选择最接近当前阶段的主题。连接失败从凭据与网络开始，构建失败从环境和日志开始，订购与节点状态则在控制台核对实时结果。

远程连接

首次进入 macOS 桌面

核对地址、端口、用户名与临时密码，完成 VNC 会话和首次安全设置。

查看连接步骤 账户与订购

查看订单与节点详情

在控制台核对机型、租期、节点、附加存储、账单和服务状态。

打开控制台 系统初始化

完成交付后的基础验收

修改临时凭据，检查系统版本、磁盘空间、网络时间和管理员权限。

执行验收清单 开发环境

复现 Xcode、CI 与 MLX 环境

按版本清单安装工具链，隔离依赖，并保留构建和推理运行记录。

查看环境指南 网络与存储

区分链路问题与容量问题

检查本地出口、目标端口、磁盘余量、同步任务和大文件传输策略。

进入诊断树 服务状态

核对节点与实例运行结果

以控制台实时返回为准，结合节点状态、系统负载和服务记录判断影响范围。

查看状态口径
首次连接指南

先验收连接，再迁移项目

建议在同步仓库、模型或媒体素材之前完成四项检查。这样可以把交付问题、网络问题和项目环境问题分开处理。

  1. 01

    从控制台获取当前凭据

    进入实例详情，核对节点编号、机型、VNC 地址、端口、用户名和临时密码。不要使用旧工单或历史截图里的连接信息，也不要将完整凭据转发给其他人。

    节点编号与订单一致 地址和端口来自当前实例 凭据未包含多余空格
  2. 02

    建立 VNC 远程桌面连接

    在可信网络中打开兼容的 VNC 客户端，按控制台提供的地址和端口连接。若握手失败，先检查本地网络、代理、防火墙和目标端口，不要连续反复尝试错误密码。

    本地网络可正常访问外部服务 代理未改写目标端口 客户端保存的是当前地址
  3. 03

    修改账户安全设置

    首次进入图形界面后立即修改临时登录密码，并确认屏幕锁定、自动登录和远程访问设置符合团队规则。团队使用时应为授权成员分别建立可追踪的本地账户。

    临时密码已替换 屏幕锁定策略已确认 授权成员范围已记录
  4. 04

    验证系统与订单配置

    检查 macOS 版本、M4 芯片、内存、存储容量、可用磁盘空间、系统时间与网络出口。SureVM M4 Core 应显示 M4、16GB、256GB；SureVM M4 Plus 应显示 M4、24GB、512GB。

    芯片与内存匹配所选方案 磁盘容量与附加项一致 时间和网络状态正常
迁移路径

从本地 Mac 到云端 Mac 的三步迁移

迁移的目标不是复制整台旧机器，而是重建可验证、可复用的工作环境。先同步必要数据，再复现工具链，最后接入自动化任务。

01 数据同步

只迁移项目所需内容

优先同步代码仓库、配置模板、必要素材和已确认可复用的缓存。大文件先压缩或分批传输，避免一次同步把磁盘写满。

  • 通过版本控制拉取代码与子模块
  • 将敏感变量单独注入，不提交到仓库
  • 记录素材、模型和构建产物的存放路径
  • 同步后校验关键文件数量与校验值
交付结果 项目数据可读，目录边界清晰
02 工具链复现

按版本清单重建开发环境

先确认 Xcode、命令行工具、语言运行时和包管理器版本，再安装项目依赖。不要直接复制旧机器中无法追踪来源的全局目录。

  • 固定 Xcode 与 Command Line Tools 版本
  • 记录 Ruby、Node.js、Python 和 Java 版本
  • 从锁文件恢复 CocoaPods、SwiftPM 与 npm 依赖
  • 执行一次干净构建并保存完整日志
交付结果 同一提交可在新节点稳定构建
03 CI 接入与验证

将节点纳入可追踪队列

为 Runner 设置独立工作目录和最小必要权限，建立缓存清理策略，并用测试分支验证拉取、构建、归档和日志回传。

  • 限制 Runner 可访问的仓库与执行账户
  • 把缓存目录和构建产物目录分开
  • 验证失败任务能够返回退出码和日志
  • 记录节点编号、任务编号与提交哈希
交付结果 自动化任务可复现、可定位、可交接
Xcode 与 CI

构建失败时，按证据链排查

不要先清空所有缓存或重装全部工具。先保留失败日志，再从证书、签名、Keychain、Runner 权限、缓存和具体报错逐层缩小范围。

签名链

证书、描述文件与 Keychain

  1. 确认证书用途与有效状态

    核对构建目标使用的证书类型、团队配置和有效期限，避免把开发与发布环境混用。

  2. 核对签名设置来源

    检查项目配置、构建参数和 CI 环境变量是否指向同一套签名策略。

  3. 确认 Keychain 可被任务访问

    交互式登录可用不代表后台 Runner 可用，应在 Runner 执行账户下验证解锁与读取权限。

执行环境

Runner 权限、缓存与日志

  1. 确认 Runner 的实际执行账户

    核对工作目录、Shell、PATH 和读写权限，不要只在远程桌面的交互终端里验证。

  2. 隔离依赖缓存与派生数据

    为 CocoaPods、SwiftPM、npm 和 DerivedData 设定清晰目录，先定向清理问题缓存。

  3. 保留第一份完整失败日志

    记录任务编号、提交哈希、Xcode 版本、退出码和第一处错误，避免只提交最后几行摘要。

日志定位顺序

先找第一处失败，再看连锁错误

构建日志末尾通常包含大量后续失败。应从第一个非零退出码、首个签名错误或首个依赖解析错误开始，结合任务开始时间判断真正原因。

01 任务上下文

节点编号、任务编号、提交哈希、分支。

02 环境上下文

macOS、Xcode、运行时与依赖版本。

03 失败上下文

第一处错误、退出码、相关命令与时间。

MLX 与开发环境

让实验环境可以重建，而不是只在当前会话可用

将 Python 环境、模型文件、参数和输出记录分开管理。这样既能控制磁盘占用，也能在升级依赖后快速比较实验差异。

环境运行单

推荐目录与记录边界

ENV
Python 环境隔离

每个项目使用独立虚拟环境，固定 Python 版本，并将依赖清单纳入项目版本管理。

DEP
依赖安装

从锁定文件安装依赖，记录 MLX 与关键库版本；升级前先复制环境清单和基准结果。

MODEL
模型文件管理

模型、量化版本和临时下载目录分开存放，记录来源、校验值和磁盘占用，避免重复副本。

RUN
运行记录留存

每次实验保存提交哈希、参数、依赖版本、输入摘要、耗时和输出路径，不记录敏感原始数据。

开始前

确认磁盘预算

模型文件、虚拟环境、缓存和输出会同时占用空间。下载前先检查可用容量，并为中间文件预留余量。

  • 模型目录只保留需要的版本
  • 缓存设置明确的清理周期
  • 结果归档后再删除中间文件
变更后

用最小样例验证

依赖或模型变更后，先运行固定输入的小样例，比较退出码、输出结构和资源占用，再恢复完整任务。

  • 保留变更前后的环境清单
  • 记录失败命令与第一处错误
  • 确认输出路径可写且容量充足
连接诊断树

从凭据到节点状态，逐层排除

每一层只回答一个问题。前一层未通过时不要跳到后一层重装软件，这能减少无关改动，也能为工单保留清晰证据。

01
凭据

地址、端口、用户名和密码是否来自当前实例？

未通过时

重新打开控制台实例详情，手动复制当前连接信息，检查首尾空格和旧客户端记录。

02
网络

本地网络能否到达目标地址和端口？

未通过时

临时停用会改写流量的代理，检查公司出口策略，并用另一条可信网络交叉验证。

03
远程桌面服务

网络可达，但 VNC 会话是否在握手阶段失败？

未通过时

记录客户端名称、版本、错误原文和发生时间，避免反复提交错误凭据造成额外干扰。

04
系统负载

已连接但画面迟缓，是否有高负载任务占用资源？

需要检查

查看 CPU、内存、磁盘余量和正在运行的构建或推理任务，先暂停非必要队列再复测。

05
节点状态

控制台是否返回当前实例的正常运行状态？

状态异常时

不要自行反复重启任务。记录节点编号、控制台状态、发生时间和前述检查结果后提交工单。

服务状态口径

实时结果以控制台返回为准

所有节点按全年 365 天正常运行设计，不设置计划停机时段。若实例状态、连接结果与本地检查不一致，请将具体节点和时间范围提交给支持团队核对。

先记录
节点编号与发生时间
再对照
控制台状态与本地现象
最后提交
脱敏日志与复现步骤
提交支持请求

让支持团队能够直接复现问题

完整工单应说明对象、时间、操作和结果。请先对日志中的仓库地址、令牌、私钥、个人数据与业务内容进行脱敏。

TICKET / REQUIRED

工单需要包含五项信息

脱敏后提交
NODE
节点编号与地区

填写控制台显示的节点编号，并注明新加坡、日本（东京）、韩国（首尔）、香港或美国西部。

MODEL
机型与配置

注明 SureVM M4 Core 或 SureVM M4 Plus，以及是否使用附加存储或 Thunderbolt 5 并联。

TIME
发生时间与时区

提供首次发生时间、最近一次复现时间和所在时区，避免只写“刚刚”或“大约昨天”。

STEPS
最短复现步骤

从正常状态开始，按顺序写出执行动作、输入条件、预期结果和实际结果。

LOG
脱敏日志与错误原文

保留时间、退出码和错误上下文，移除密码、访问令牌、私钥、完整支付凭据和业务敏感数据。

已下单用户

通过控制台提交节点工单

控制台工单可关联实例、订单和节点状态，适合处理连接、系统、账单与持续性技术问题。

登录并提交工单
无法登录或售前问题

发送邮件至支持团队

使用可接收回复的邮箱发送问题摘要。对外支持邮箱只有 support@surevm.com，请勿在邮件中发送账户密码或私钥。

support@surevm.com
下一步

已有问题就提交证据，需要节点就直接配置

控制台用于实例管理和支持工单；订购入口用于选择两档 M4 配置、租期与五个可用节点。

进入控制台 立即租用云端 Mac