从第一次连接开始

把上机步骤走通，
再把工作流跑稳。

这里按实际操作顺序整理独享物理 Mac mini 的使用方法。先核对交付凭据，再连接系统、配置工具，最后安排构建、备份与续期。无需一次读完，按当前任务检索即可。

立即租用云端 Mac 打开控制台

已有实例：在控制台查看交付信息与订单状态。需要协助：登录后提交工单，勿在公开文本中粘贴密码、私钥或签名材料。

先连接，再配置

首次上机的四个检查点

每一步都有明确的完成标志。先在交互会话里验证，再将相同配置交给自动化任务。

01交付核对

收到凭据后的首次登录

把订单、机器与连接信息对应起来。先验证一台机器，避免把另一节点的地址填入客户端。

展开操作步骤
  1. 登录控制台，打开对应订单的实例详情。核对机型、节点、租期，以及当前交付状态。
  2. 保存连接地址、登录用户名和实际端口。凭据以控制台交付内容为准，不从邮件转发或聊天记录拼接。
  3. 首次连接后更换登录密码，执行 sw_vers 确认系统版本，再运行 df -h 查看磁盘余量。
  4. 记录项目目录、产物目录与负责人。团队使用时，不要把同一份凭据直接提交到代码仓库。

完成标志：能够重新连接，系统信息与订单一致，且已知道构建结果保存在哪里。付款完成但尚未取得凭据时，在订单内提交工单，不反复创建重复订单。

02远程连接

配置屏幕共享与 SSH 公钥

图形界面适合首次配置和交互调试；SSH 适合命令执行、文件传输与自动化任务。

展开操作步骤
  1. 使用交付信息连接屏幕共享。系统设置中检查“通用 → 共享”，只允许需要使用的账户访问。
  2. 需要命令行时检查“远程登录”。在本地生成或选用已有 SSH 密钥，只将公钥上传到远端。
  3. 将公钥追加到目标用户的 ~/.ssh/authorized_keys，设置目录权限为 700、文件权限为 600。
  4. 保留当前会话，另开一个终端验证公钥登录成功，再调整认证方式。私钥始终留在本地或团队密钥管理系统中。

完成标志：图形会话可正常连接，SSH 公钥可在新会话中通过认证。端口与防火墙设置必须按实际交付信息核对。

阅读各系统的连接说明
03工具核对

安装与确认 Xcode 命令行工具

先检查当前环境是否符合项目要求，不因系统里已有 Xcode 就直接开始升级。

展开操作步骤
  1. 用 xcodebuild -version 和 xcode-select -p 检查版本与开发工具路径。
  2. 缺少命令行工具时执行 xcode-select --install。完整构建需要与项目匹配的 Xcode，命令行工具不能替代全部 SDK。
  3. 多个 Xcode 并存时，使用 DEVELOPER_DIR 为单次任务指定开发工具目录，或用 xcode-select 切换系统选择。
  4. 完成工具许可确认与首次启动所需组件安装，再运行一个小项目的编译和测试。

完成标志：终端与 CI 日志中的 Xcode 版本一致，目标 SDK 可见。把版本写入项目配置或 runner 启动环境，不依赖操作人员记忆。

04自动化接入

在 Mac mini server 注册自托管 runner

先跑通一次手动构建，再让 runner 承接任务。不同 CI 平台的注册命令以项目后台为准。

展开操作步骤
  1. 创建专用构建用户与工作目录，在 CI 项目设置中获取适合 macOS 与 Apple Silicon 的 runner 安装包。
  2. 使用短期注册令牌完成绑定。标签中注明系统、芯片、节点与用途；不要把长期访问令牌写进仓库。
  3. 先以前台进程运行一条最小任务，检查 PATH、Xcode 路径、钥匙串访问与产物上传。
  4. 确认无人值守执行所需的权限后，再按 CI 平台说明配置服务。含图形操作的任务应单独验证会话要求。

完成标志：提交一次测试变更可触发任务，日志能定位到该实例，产物存到机器以外。整机独占不等于任务可以无限并发，先串行验证，再按内存与磁盘占用调整并发数。

把可重复性写进流程

构建、签名与缓存

Unity、Flutter 或原生工程都应保留工具版本、依赖锁文件与构建命令。签名材料和可再生缓存分开管理。

Unity iOS 云端出包流程

把 Unity 工程导出与 Xcode Archive 拆成两个可独立验证的阶段，失败时才能知道问题发生在哪一步。

展开操作步骤
  1. 固定 Unity 编辑器版本、包依赖与 iOS 构建支持模块。先核对项目许可要求，避免把授权问题误判为机器故障。
  2. 同步工程后导出 Xcode 项目。生成目录与源码目录分开，保留导出日志及本次提交标识。
  3. 安装项目所需的原生依赖，核对 scheme、目标设备类型、Bundle Identifier 与签名配置。
  4. 执行 Archive，验证导出产物后，再通过团队既有的分发流程上传。不要把“编译通过”当成“分发完成”。

建议保存：提交标识、工具版本、导出日志、Archive 日志及产物校验值。失败重试前先处理首个错误，不只截取日志末尾的通用失败提示。

Xcode 证书与描述文件迁移

构建签名同时依赖证书、对应私钥与有效描述文件。只复制证书文件，通常不足以完成签名。

展开操作步骤
  1. 从团队受控位置准备带私钥的签名材料，使用加密传输。导出密码通过另一条安全路径交付。
  2. 导入构建用户可访问的钥匙串，检查证书有效期与私钥是否配对。可用 security find-identity -v -p codesigning 检查可用身份。
  3. 导入与目标应用、团队和分发方式对应的描述文件，核对 Bundle Identifier、有效期与所需能力。
  4. 在与 runner 相同的用户和执行方式下测试签名，确认无人值守任务不会卡在权限提示上。

安全边界：不要在日志中输出导出密码、私钥或完整签名文件。轮换或撤销材料时同步更新构建配置；结束租用前清理机器内的敏感材料，并保留团队侧安全副本。

把构建缓存放到附加 SSD

+1TB SSD 适合集中放置可再生缓存和中间产物。先确认实际挂载路径，再修改构建脚本。

展开操作步骤
  1. 运行 df -h 确认附加 SSD 的挂载位置和可用空间，为项目建立独立目录，避免多个任务共用一套可写缓存。
  2. 把 Xcode DerivedData 指向专用缓存目录。Unity Library 缓存按项目、编辑器版本与依赖状态区分。
  3. 将缓存、Archive、导出包分成三个目录。产物通过 SFTP 或团队存储回传后，再按保留策略清理。
  4. 重启或重新连接后检查挂载状态。路径不可用时让任务明确失败，不静默退回系统盘继续写满磁盘。

容量判断：按工作副本、依赖、缓存、并行任务与产物分别估算空间。附加 SSD 随机器归还同步清除，不是租期结束后仍可访问的备份盘。

先验证能装下，再测速度

24GB 档的本地推理准备

GNU Studio M4 为 M4 · 24GB RAM · 512GB SSD。模型文件大小不等于推理时的总内存占用，量化方式、上下文长度和并发请求都会改变需求。

建立可复现的 MLX 推理环境

先用小模型完成加载与输出校验，再调整上下文或并发。不要一开始就把最大负载交给服务进程。

展开操作步骤
  1. 确认依赖支持当前 macOS、Python 与 Apple Silicon 环境。为每个实验建立独立虚拟环境。
  2. 安装项目所需依赖并记录版本，保留依赖锁定文件。固定模型版本与量化格式，避免两次测试实际使用不同权重。
  3. 先用单请求、短上下文加载模型，记录进程内存、内存压力与交换空间变化，再逐步增加输入长度。
  4. 比较结果时固定提示词、生成长度与预热条件，将首次加载和后续生成分开记录。

完成标志：同一份配置能够重复加载模型并生成结果。需要扩大并发时先观察资源，不根据磁盘文件尺寸直接推断可承载的请求数。

规划模型文件与磁盘预算

模型权重、下载缓存、转换副本和实验输出分目录存放。保留多个量化版本时，磁盘占用会叠加。

展开操作步骤
  1. 下载前查看模型仓库的实际文件大小。磁盘预算至少包含原始文件、量化或转换输出、下载临时文件与运行日志。
  2. 将模型目录与 Python 环境分开；使用附加 SSD 时，把模型缓存路径显式写进启动配置。
  3. 用 du -sh 检查目录占用，用 df -h 检查所在卷余量。两个命令回答的问题不同。
  4. 为失败下载与转换过程预留临时空间。删除旧模型前确认没有运行中的任务仍引用其目录。

选择边界：+1TB 或 +2TB SSD 增加的是存储，不增加统一内存。归还前导出实验配置、结果与需要保存的权重，别把唯一副本留在实例内。

把到期时间写进排期

续期、换档与付款

以控制台订单显示的计费周期、到期时间和付款状态为准。实例全年 365 天正常运行，没有固定停机安排；项目排期仍应为备份与迁移留出时间。

续期与到期前检查

按天、周、月、季选择租期。不要把已发起支付当成续期已经完成。

展开操作步骤
  1. 打开控制台中的对应订单，核对实例与到期时间，确认剩余租期覆盖正在运行的构建或实验。
  2. 按控制台提供的续期入口确认周期和金额。若当前订单没有可用操作，提交工单核对处理方式。
  3. 付款后检查订单状态及新的到期时间。未更新时保留订单号与付款凭证，通过工单查询。
  4. 计划退租时，先停止新任务、导出产物和配置，再验证本地或团队存储中的副本可以打开。

注意：不要假定存在自动续费或到期后的固定宽限期。机器归还后执行数据清除，附加 SSD 同步处理，重要数据应在租期结束前完成迁出。

换档与叠加附加项

内存需求变化与磁盘需求变化分开判断。更换机型前，先安排数据和构建环境的迁移。

展开操作步骤
  1. 记录当前负载的内存压力、磁盘余量和失败现象。缓存过大不等于需要更高内存档位。
  2. 需要换档时，通过控制台工单提供当前订单号、目标档位和迁移需求，先确认处理路径及计费。
  3. 需要 +1TB SSD、+2TB SSD 或 Thunderbolt 5 并联时，核对控制台可选项与报价。并联方案应先说明台数、软件用途及数据交换方式。
  4. 配置变化后重新验证挂载路径、权限、runner 标签和任务路由，再恢复正式任务。

边界：附加存储不会改变内存容量；Thunderbolt 5 并联不等于自动合并各机器的内存，也不保证任意软件会自动分摊任务。

核对两档机型与附加项价格

完成付款并核对到账状态

仅支持 USDT-TRC20 与经 Stripe 的 Visa / Mastercard / Amex，全部以美元（USD）结算。

展开操作步骤
  1. 在订单内核对机型、节点、周期、附加项与应付金额。实际可用网关以接口返回为准。
  2. 使用 USDT-TRC20 时，只按当前付款页面给出的网络、收款信息与金额操作，不复用历史截图中的地址。
  3. 使用银行卡时，经 Stripe 付款流程完成卡片验证，随后回到控制台核对订单状态。
  4. 状态未确认时，先记录付款时间、订单号及交易标识，再提交工单核对，避免不明原因下重复付款。

提交凭证：链上付款可提供交易哈希；刷卡付款可提供付款回执。不要发送完整卡号、安全码、密码或私钥。

获取账单与申请账务资料

先从具体订单定位付款记录，再提出资料需求，比只发送一张扣款截图更容易核对。

展开操作步骤
  1. 在控制台账单与订单记录中找到对应付款，核对金额、币种、周期和订单号。
  2. 保存可用的账单或付款回执。需要发票或额外账务资料时，在控制台工单中注明用途和所需字段。
  3. 提交抬头等必要信息前检查拼写，避免在工单附件中夹带无关的个人资料。
  4. 资料类型、开具方式及处理结果由团队核对后答复，不把支付网关回执与所有用途下的发票混为一谈。

非订单咨询：可邮件联系 support@gnumac.com。已有订单的账务问题优先使用工单，便于保留完整处理记录。

完整工作流记录

继续读：从操作步骤到项目实践

短指南用于定位当前动作。项目实践与技术记录统一收录在博客，发布后可从文章列表进入。

查看技术文章列表
保留现场，逐层排查

连不上或磁盘告警，先查这三项

先区分网络不可达、认证失败与应用报错。记录原始错误、发生时间和已经尝试的操作，避免重复修改配置。

无法连接屏幕共享

地址不可达、认证被拒和连接后黑屏是不同问题。不要在未确认原因前连续重启实例。

展开排查步骤
  1. 从控制台重新核对地址、端口和用户名，确认客户端未保留另一台实例的旧配置。
  2. 检查本地网络是否允许出站连接。可以在获准的另一网络环境中复测，判断是否为本地策略限制。
  3. 若 SSH 可用，检查屏幕共享设置和允许访问的用户。若两种方式都不可达，记录各自错误后提交工单。
  4. 连接建立但画面异常时，降低分辨率与画质，并记录客户端名称、版本及问题截图。

工单附带：订单号、出错时间与时区、客户端、错误原文、是否能通过 SSH 连接。截图应遮盖凭据。

SSH 超时或认证失败

超时多与地址、端口或网络路径有关；认证失败则先查用户名、公钥与权限。

展开排查步骤
  1. 使用交付的实际端口连接，不默认假设为标准端口。以 ssh -vv 查看失败发生在连接、协商还是认证阶段。
  2. 超时时核对本地出站限制和实例状态；“拒绝连接”时检查远程登录服务是否开启。
  3. 出现 Permission denied 时，检查目标用户、公钥内容和文件权限，确认本地选择了正确私钥。
  4. 主机指纹变化时，先在控制台核对是否执行过重装或换机。确认原因后再更新本地记录，不直接忽略安全告警。

工单附带：脱敏后的连接命令、错误末段、发生时间与时区。不得发送私钥内容或密码。

磁盘空间告警

先停掉继续写入的大任务，再找占用来源。不要直接删除系统目录或其他任务正在使用的文件。

展开排查步骤
  1. 执行 df -h 找到空间不足的卷，区分系统盘与附加 SSD，不只看 Finder 中的总容量。
  2. 用 du -sh 检查项目、构建缓存、模型下载与产物目录。确认当前任务是否仍在写入。
  3. 先转移需要保存的产物，再清理可再生缓存和失败下载的临时文件，检查日志轮转是否正常。
  4. 清理后重新核对余量，再恢复一条任务观察写入增长。空间长期不足时，评估附加 SSD，而不是反复删同一批必要数据。

工单附带：订单号、相关卷的容量输出、占用最大的目录及近期任务变化。不要上传包含敏感文件名的完整目录清单。

提交工单前，整理一份可复现纪要

  • 定位：订单号、实例、节点及问题发生时间与时区。
  • 现象：预期结果、实际结果、首次出现还是每次出现。
  • 证据：最短复现步骤、脱敏日志，以及已尝试的排查操作。

已有订单的问题请在控制台提交工单。售前选型或无法进入账户时，可邮件联系 support@gnumac.com。请勿提交密码、私钥、完整银行卡信息或签名材料。

登录并提交工单 查看联系说明

流程明确后，再开始这次租用。

选好机型、节点和租期，把项目配置与备份路径带上。已有实例的问题，直接在控制台订单内继续处理。

开始租用云端 Mac 进入控制台