确认节点状态
进入控制台查看当前节点。只有状态显示为可用时再开始连接；如果节点仍在分配或生成连接信息，等待状态完成后再配置客户端。
- 需要记录
- 节点区域、当前状态
- 通过条件
- 状态明确显示可用
VNC 连接工作单
从领取连接信息，到稳定使用云端 Mac 桌面
这是一条可逐项核对的 VNC 连接路径。先确认节点状态和目标地址，再配置客户端、检查桌面、调节画质。遇到断线时按固定顺序排查，不用反复盲试。
约 4 分钟
完成首次连接
4 项
连接前必查信息
1 条顺序
用于断线定位
REMOTE HANDOFF
连接信息交付单
可开始配置
- 节点状态
- 可用
- 目标地址
- host.example:5900
- 账户名
- remote-user
- 桌面模式
- 自适应分辨率
SG新加坡
JP日本（东京）
KR韩国（首尔）
HK香港
US-E美国东部
US-W美国西部
$
select-region JPregion accepted: JP-TYO
$
request-physical-nodededicated host assigned
$
start-build-sessiondesktop and terminal ready
入口价
$20.1/天
实际可用状态以控制台实时返回为准
连接前准备
先把四项基础信息放到手边
多数首次连接问题不是 VNC 本身故障，而是节点状态、地址格式、账户名或本地网络策略没有确认完整。连接前按顺序完成下面四项。
保存目标地址
完整保存主机名或地址与端口，不要只截取其中一段。复制后检查是否带入空格、换行或中文标点，避免地址看似正确但无法解析。
- 需要记录
- 主机地址、端口
- 通过条件
- 与控制台逐字一致
核对账户名
账户名和密码分别保存，输入时注意大小写与键盘布局。不要把订单邮箱当成远程桌面账户名，也不要把连接信息转发给无关成员。
- 需要记录
- 远程账户名
- 通过条件
- 字段来源清晰且未混用
检查本地网络
确认当前网络允许 VNC 连接并且没有被公司代理、防火墙或访客网络策略拦截。先关闭占用大量带宽的同步和下载任务。
- 需要记录
- 网络类型、客户端版本
- 通过条件
- 目标端口可正常访问
首次连接时间线
四个阶段，总计约 4 分钟
计时从控制台已经显示节点可用开始。每一步都保留一个明确完成条件，出现问题时可以直接指出停在哪个阶段。
约 4 分钟
领取信息、配置客户端、建立会话并完成桌面检查
实际耗时以控制台实时返回、客户端环境和本地网络状态为准。
领取连接信息
在控制台确认节点状态，复制目标地址、端口和账户名。完成条件是三个字段都已经单独保存并核对。
配置 VNC 客户端
新建连接记录，填写目标地址和显示参数。首次使用先采用自适应分辨率与中等色彩质量，不急于拉满画质。
建立远程会话
输入远程账户名和对应凭据，确认客户端展示的目标地址与控制台一致，再发起连接并等待桌面完成加载。
完成桌面检查
移动窗口、输入文本、打开终端并执行一个无副作用的检查命令。确认输入、画面刷新和复制粘贴均符合预期。
VNC 连接步骤
把地址、账户、显示参数和连接动作放在同一张检查图里
下面的界面示意不包含真实凭据。字段位置与操作顺序按通用 VNC 客户端流程组织，具体名称可能因客户端版本略有不同。
01
服务器地址
从控制台完整复制
host.example:5900
02
用户名
不要使用订单邮箱代替
remote-user
03
显示设置
首次连接从中等质量开始
Adaptive · Medium
连接前复核
地址、端口、账户名、键盘布局
会话预览
2560 × 1440
Xcode 工程
画面刷新
稳定
输入响应
正常
保留端口信息
客户端若把主机和端口拆成两个字段，分别填写；若使用单字段，则保持控制台给出的完整格式。
确认大小写
账户名与凭据按原样输入。连续失败时先停止尝试，重新核对字段，避免把输入错误误判为节点故障。
先稳定再提画质
首次连接选择自适应分辨率和中等质量。确认操作流畅后，再逐档提高色彩与清晰度。
核对目标后提交
发起连接前再次查看目标地址，避免打开旧连接记录，误连到团队此前使用过的其他节点。
桌面与终端协作
图形任务留在桌面，重复任务交给终端
远程桌面和命令行不是二选一。用 VNC 处理需要视觉反馈的工作，用终端运行可重复、可记录的自动化任务，并为每个长任务保留唯一执行入口。
图形桌面
适合需要观察界面状态的工作
- 打开 Xcode、检查工程设置和构建目标
- 观察编译错误定位、预览结果与应用界面
- 处理需要拖放、窗口切换或视觉确认的步骤
- 检查任务是否已经在其他桌面会话中运行
使用原则
桌面负责启动和观察，不把持续输出的大量日志长期铺在远程画面里。
命令行
适合自动化、日志和可复现任务
- 执行构建脚本、测试任务和依赖检查
- 运行 self-hosted runner 与持续集成流程
- 把完整输出写入日志文件，便于失败后比较
- 使用明确的工作目录与任务标识记录进程
使用原则
命令行负责执行和留痕，长任务启动后记录进程与日志位置，不在多个会话重复启动。
DUPLICATE TASK GUARD
避免重复启动同一构建任务
- 01先查进程
查看是否已有相同工程、脚本或 runner 正在运行。
- 02再查日志
确认最近一条输出时间，判断任务仍在执行还是已经停止。
- 03最后启动
只有现有任务明确结束后，才从唯一入口重新执行。
画质与延迟调节
一次只改一个参数，再记录输入响应
画面清晰度、色彩质量和带宽消耗互相影响。不要一次修改全部设置，否则无法判断是哪一项改善或恶化了体验。
- 先把分辨率调到适合当前屏幕的工作尺寸
- 出现拖影或刷新缓慢时，下调色彩质量
- 小屏查看大桌面时优先调整缩放比例
- 记录键盘输入到画面反馈的主观延迟
- 重复相同操作三次，排除单次网络抖动
分辨率
从可读且不频繁缩放的尺寸开始
色彩质量
代码编辑优先保证响应，不必先拉满色彩
画面缩放
避免客户端和系统同时进行重复缩放
输入延迟
以连续输入、窗口拖动和菜单响应共同判断
切换节点前
先保留一组可比较记录
在同一网络、同一客户端设置下记录连接建立时间、输入响应、画面刷新和断线情况。只有重复测试仍不理想时，再评估更接近团队位置的在售节点。
新加坡
日本（东京）
韩国（首尔）
香港
美国东部
美国西部
会话安全
凭据只给需要连接的人，会话结束后立即锁定
远程桌面连接本身只是入口。账户共享、离席未锁定和异常会话未处理，都会扩大项目代码与构建环境的暴露范围。
使用唯一凭据
每次输入时只使用当前节点对应的连接信息，不把其他服务密码复用到远程桌面账户。
避免共享账户
团队成员需要协作时先明确操作者和时间段，不让多人同时使用同一凭据启动无法归属的任务。
离开前锁定会话
任务可以继续运行，但桌面应在离席和工作结束时锁定。不要用关闭客户端窗口代替锁定远端会话。
处理异常登录
发现未知会话、异常输入或非预期任务时，立即更新凭据、保存时间与日志，并联系支持团队。
SESSION CLOSEOUT
结束一次远程工作时
- 确认任务记录仍在运行的构建、测试和自动化进程
- 保存结果保存项目变更、日志路径和下一位操作者需要的信息
- 退出敏感工具关闭不再使用的项目管理与凭据界面
- 锁定桌面锁定远端会话，再断开本地 VNC 客户端
断线恢复与排查
按固定顺序检查，避免把不同问题混在一起
断线后先确认节点，再检查本地网络、客户端日志、凭据和会话占用。每一步只回答一个问题，并把结果写进支持请求。
| 顺序 | 检查对象 | 具体动作 | 需要记录的结果 |
|---|---|---|---|
| 01 | 节点状态 | 在控制台查看节点是否仍为可用，并核对节点区域与当前订单是否一致。 | 状态文字、区域、检查时间 |
| 02 | 本地网络 | 确认网络未切换、代理或防火墙策略未变化，并暂停占用带宽的同步任务。 | 网络类型、是否可访问目标端口 |
| 03 | 客户端日志 | 查看断线前后的错误文本，不只记录“连接失败”，保留完整错误行和客户端版本。 | 完整错误文本、版本、发生时间 |
| 04 | 凭据有效性 | 重新从控制台核对目标地址与账户名，确认没有使用旧连接记录或多余空格。 | 核对结果、失败发生在哪一步 |
| 05 | 会话占用 | 确认是否有另一位成员或另一个客户端仍保持会话，并核对是否存在重复任务。 | 会话数量、操作者、相关任务 |
SUPPORT REQUEST
不提交密码或私钥
支持请求模板
- 订单编号
- 填写当前订单编号
- 节点区域
- 填写控制台显示的区域
- 机型
- 填写当前订单对应机型
- 发生时间
- 写明时区与大致时间
- 客户端
- 名称、版本与本地系统版本
- 错误文本
- 粘贴完整原文，不只提供截图
- 已尝试步骤
- 按检查顺序列出动作和结果
- 可复现性
- 每次发生、偶发或仅特定网络发生
在控制台提交工单
登录后附上订单编号、节点区域、发生时间、完整错误文本与已尝试步骤。后续补充信息和处理进度都在同一工单中查看。
通过支持邮箱联系
发送邮件到 support@bookamini.com。邮件中使用同一套请求模板，不要提交账户密码、恢复码或私钥。
开始远程工作
选择配置和节点，领取独享物理机连接信息
BookAMini 提供两档在售云端 Mac 配置与 6 个节点。下单后按控制台返回的实时状态领取 VNC 信息，再用本页流程完成首次连接。