首次连接
查看完整顺序
从连接资料到桌面验证
核对节点、建立安全连接、检查键盘与显示，并在首次会话中更新初始凭据。
问题检索
先按任务找入口，再按关键词缩小范围
输入“黑屏”“runner”“磁盘”“付款”等问题词，或选择一个分类。检索只筛选下面的入口卡，不会隐藏后续完整指南。
远程桌面
打开桌面指南
画面、带宽与会话恢复
从客户端准备开始，逐项调整分辨率、色彩与画质，处理弱网和中断后的恢复。
命令行
查看连接路径
验证 SSH 与最小权限
确认主机指纹、连接端口和账号权限，再把 Git、脚本或运维任务接入节点。
CI/CD
进入配置清单
部署 self-hosted runner
隔离工作目录，控制签名材料与缓存边界，并按真实资源安排并发构建。
存储
查看磁盘排查
定位磁盘占用并安全清理
先检查工作目录、构建产物与缓存，再决定清理、导出或在下个订单中增加 SSD。
账单
查看价格构成
核对周期、附加项与付款记录
以订单编号为索引，核对机型、节点、计费周期、SSD 或 Thunderbolt 5 并联项。
没有匹配的入口。
尝试缩短关键词，或切换到“全部”后按故障类型查看决策树。
首次连接
第一次会话按五个检查点完成
不要在收到连接资料后立即安装工具。先完成节点、网络、显示和凭据验证，后续构建问题才能与连接问题分开定位。
-
01
从控制台取得连接资料
记录订单编号、节点区域、主机地址、端口、初始用户名和连接方式。连接资料只保存在受控位置，不转发到公开聊天或代码仓库。
完成标志：订单编号与主机地址能对应同一实例。 -
02
确认节点与来源网络
核对所选节点是否为新加坡、日本东京、韩国首尔、香港或美国西部，并记录当前网络出口。团队成员测试时应分别记录来源网络，避免把本地链路差异误判为节点问题。
完成标志：节点、来源网络和测试时间均有记录。 -
03
建立安全连接并核对主机
使用连接资料指定的方式进入图形桌面或命令行。SSH 首次连接时核对主机指纹；图形桌面连接时确认目标地址与端口，拒绝来源不明的连接配置。
完成标志：可以进入会话，且目标主机信息与订单一致。 -
04
验证键盘、显示和时区
测试中英文输入、常用修饰键、复制粘贴、显示缩放与时区。若键位异常，先统一本地客户端和远端 macOS 的键盘布局，再调整快捷键映射。
完成标志：常用快捷键可用，文字输入与显示比例符合工作需求。 -
05
更新初始凭据并保存恢复信息
首次连接成功后更新初始凭据，使用唯一且足够长的密码，并限制共享范围。自动化账号与日常桌面账号分开，避免 runner、人工操作和排障共用同一权限边界。
完成标志：旧凭据不再有效，新凭据已进入团队受控存储。
远程 Mac 桌面
先保证会话稳定，再逐步提高画质
远程桌面的体验由本地网络、往返延迟、分辨率、色彩深度和画面变化共同决定。排查时每次只改一个变量。
客户端与地址
使用支持加密连接和会话恢复的 VNC 客户端。导入连接资料后，先核对地址、端口和用户名，不保存不受控的明文密码。
- 更新到当前稳定版客户端
- 关闭会改写目标地址的代理规则
- 保留一份不含敏感凭据的连接参数记录
分辨率与色彩
首次连接先使用单显示器和中等分辨率。确认操作流畅后再提高画面尺寸或色彩质量，不要同时启用高分辨率、多屏和最高画质。
- 文字偏小先调系统缩放
- 颜色判断任务固定客户端色彩设置
- 画面撕裂时先降低刷新与质量
减少画面变化量
弱网下优先降低分辨率、色彩深度和动态效果。终端、编辑器和静态界面对带宽更友好，视频预览与大面积动画应最后开启。
- 关闭桌面动态背景和透明效果
- 避免在会话内播放高码率视频
- 持续波动时更换来源网络复测
中断后恢复会话
网络中断后先重新连接原会话，不要连续创建多个桌面会话。恢复后检查构建进程、文件传输和未保存内容是否仍在预期状态。
- 先等待短暂网络波动结束
- 重新连接前确认地址没有被改写
- 恢复后检查长任务的进程与日志
三条使用路径
按任务选择入口，不必所有操作都走桌面
图形界面适合 Xcode、设计检查和交互调试；命令行适合 Git、日志和运维；自动化任务应由隔离账号与 runner 执行。
图形桌面
Xcode、模拟器、媒体检查与需要视觉反馈的任务。
SSH 命令行
拉取仓库、查看日志、传输文件和运行可重复脚本。
自动化任务
由 self-hosted runner 接收队列，隔离构建并回传状态。
CI/CD 运行规程
让 runner 可清理、可追踪、可限制并发
独享物理机不会替你决定构建边界。runner 账号、工作目录、签名材料、缓存策略和并发数仍需由团队明确配置。
RUNNER MANIFEST
构建节点运行单
独享节点
01
建立专用 runner 账号
不要使用日常桌面账号运行持续集成。授予完成构建所需的最小权限，并记录服务启动与停止方式。
02
按仓库或流水线隔离目录
源码、依赖缓存、归档文件和临时输出使用明确目录。失败任务结束后仍应能判断哪些内容可删除。
03
把签名材料移出脚本与日志
证书、私钥、仓库令牌和 CI 密钥进入受控存储，通过运行时注入使用。构建日志不得打印完整密钥。
04
设置缓存生命周期
区分可复用依赖缓存、可再生成的 DerivedData 与必须保留的制品。为每类内容确定清理触发条件。
05
从单并发开始验证
先用单个任务确认环境、签名和输出路径，再提高并发。并发增加后持续观察内存、磁盘与构建时长。
术语小词典
八个会直接影响配置与排查的词
这些词不是营销标签。它们分别描述资源归属、连接协议、自动化角色、网络条件与订单时间边界。
- 物理节点
- 实际运行 macOS 工作负载的 Apple Silicon 设备。节点区域决定远程连接所经过的主要网络路径。
- 独享
- 一笔订单对应独立计算资源，不与其他租户共享该物理机的处理器、内存与本地存储。
- 非虚拟机
- 交付对象是独享物理机，而不是在同一宿主机上切分出的虚拟计算实例。
- VNC
- 用于远程查看和操作图形桌面的协议。体验受往返延迟、画面尺寸、色彩和网络波动影响。
- SSH
- 用于安全访问命令行的协议，适合 Git、脚本、日志、文件传输和自动化运维。
- self-hosted runner
- 由团队部署在自有或租用节点上的流水线执行程序，负责领取任务、构建、测试并回传结果。
- 节点延迟
- 数据从来源网络到节点再返回所需的往返时间。它会随运营商、路径、时段与本地网络变化。
- 计费周期
- 订单按天、周、月或季计算的使用区间。机型、节点与附加项共同构成最终 USD 金额。
故障决策树
从最短检查链开始，不要同时改多个变量
先确认现象是否可重复，再沿对应分支检查。提交工单时附上分支编号和结果，支持团队可以直接从失败点继续。
NET-01 无法连接或连接超时
- 核对目标：确认地址、端口、用户名和节点与控制台记录一致。
- 排除本地网络：关闭会改写目标的代理规则，换一个来源网络复测。
- 区分协议：分别记录图形桌面与 SSH 是否可达，判断是单一入口还是整体链路问题。
- 升级所需：订单编号、节点、发生时间、来源网络、客户端名称、错误原文与以上三步结果。
NET-02 延迟突然升高或画面卡顿
- 建立对照：记录当前来源网络、节点和往返延迟，不与其他地区的测试结果直接混用。
- 降低画面负载：降低分辨率与色彩质量，关闭动画和视频预览。
- 更换来源：用另一条网络测试，判断波动是否只发生在本地链路。
- 升级所需：节点、两种来源网络的结果、发生时段、客户端参数和问题持续时间。
DSK-01 磁盘空间不足
- 定位目录：分别检查源码、DerivedData、依赖缓存、归档、模拟器数据与日志。
- 区分数据：先导出必须保留的制品，再删除可重新生成的缓存和失败任务目录。
- 复查自动化：确认 runner 在任务成功与失败后都执行清理步骤。
- 升级所需：机型、剩余容量、占用最大的目录、已清理项目和预计后续容量。
BLD-01 构建失败或 runner 不领取任务
- 缩小范围：固定提交、依赖锁文件、Xcode 版本和构建命令，先用单任务复现。
- 检查 runner：确认服务进程、工作目录权限、队列标签与环境变量。
- 检查材料：验证签名材料是否可读，但不要把私钥或完整令牌写入日志。
- 升级所需：机型、失败步骤、命令、去敏后的错误原文、最后一次成功构建与已执行检查。
IAM-01 凭据无效或权限异常
- 确认账号：区分桌面账号、自动化账号和仓库访问凭据，避免用错身份。
- 确认变化：记录凭据最近是否更新、撤销或调整权限。
- 停止重复尝试：连续失败时暂停自动化任务，避免产生大量无效请求和混乱日志。
- 升级所需：订单编号、账号用途、错误时间、错误原文和权限范围；不要提交密码、私钥或完整令牌。
技术内容
围绕真实远程开发任务持续整理
以下是帮助中心覆盖的六个固定技术主题。正式文章发布后可在技术博客中按标题阅读全文；这里不展示虚构日期或未发布文章链接。
CI/CD
环境控制与持续成本
Xcode Cloud 与 HireVM 自建云端 Mac：从控制权到持续成本的完整对比
从构建环境控制、依赖缓存、签名材料、并发策略、调试路径和持续费用六个维度，判断何时采用托管流水线，何时部署 self-hosted runner。
按天租用 HireVM 云端 Mac，最适合哪些开发团队
按工作时长、配置需求与数据迁移成本判断短期租用边界。
用独享云端 Mac 完成 iOS 新版本适配测试
从测试分支、Xcode 环境到兼容性记录与构建归档。
HireVM 远程 Mac 开发环境搭建指南
依次配置账号、SSH、Git、Xcode、包管理工具与开发凭据，并补充弱网优化和数据导出检查。
从云端 Mac 提交 App Store 前的审核避坑清单
核对签名与描述文件、隐私声明、权限用途、测试账号、元数据一致性和归档结果。
Apple Silicon 云端 Mac 上的 Docker 与 OrbStack 实践
比较安装、资源占用、文件共享与网络配置，并整理适合独享物理节点的隔离和清理方法。
查看已发布内容
进入技术博客
博客列表只展示实际存在的文章，并按发布时间排序。
支持升级路径
让工单从可复现事实开始
先完成对应指南的最短检查链，再提交足够上下文。不要上传密码、私钥、完整访问令牌、签名私钥或与问题无关的代码。
确认指南分支
说明你查看了首次连接、远程桌面、CI/CD、存储或账单中的哪一项，并写明停在哪一步。
固定问题上下文
提供订单编号、HireVM M4 或 HireVM Pro、节点、发生时间与来源网络。
附上原始错误
复制完整错误文本或去敏日志片段，不只写“无法使用”“很慢”或“构建失败”。
列出已经执行的步骤
按顺序写出复测网络、调整客户端、清理目录或重跑命令的结果，避免支持团队重复询问。
下一步
需要一台可立即进入工作流的独享云端 Mac
从 HireVM M4 或 HireVM Pro 中选择配置，再在新加坡、日本东京、韩国首尔、香港、美国西部五个节点中选择区域。实际可用状态以控制台实时返回为准。