先在这里找，找不到就开工单
你可以按主题浏览，也可以搜索下方问答。首次连接先核对订单里的节点编号、地址与凭据；涉及订单或机器的具体问题，交给控制台工单处理。
- 01先确认范围
只有远程桌面异常，还是 SSH 与构建也受影响？
- 02记录可复现信息
保留节点编号、订单号、报错原文与出现问题的步骤。
- 03带着记录开工单
登录控制台提交，避免在公开页面发送连接凭据。
连接问题从凭据开始核对；计费问题从订单周期开始核对。
先选与你当前任务最接近的一类
四类问题都在本页展开。点击卡片会跳到相应问答，不需要逐页查找。
先把术语对齐
这里的「节点」指一台可以交付的真实设备，不是从一台机器切出的虚拟份额。
- 物理节点
- 一台真实的 Mac mini，硬件不切分给多个租户。
- 独享
- 租期内整机只交给你使用；芯片、内存和磁盘不与其他租户共用。
- 非虚拟机
- macOS 直接运行在所租的硬件上，而不是作为虚拟机运行。
- VNC
- 能看见并操作 macOS 图形桌面的远程控制方式；与只输入命令的 SSH 不同。
- SSH
- 通过加密连接远程登录命令行，适合部署脚本、查看日志与运行构建任务。
- self-hosted runner
- 注册在你自己控制的机器上的 CI 执行器，让构建任务在这台 Mac 上运行。
- 计费周期
- 一次购买所覆盖的租用时长，可选日、周、月或季；以订单显示的起止时间为准。
- 整盘重置
- 租期结束并回收设备后清空磁盘、重新安装系统；退租前必须自行备份。
先确认凭据，再排查网络与桌面
SSH 和 VNC 使用订单交付的地址与端口。不要把示例命令中的占位内容直接当成你的连接信息。
拿到机器后，第一次怎样登录？
先登录控制台，打开对应订单，核对节点编号、SSH 地址、端口和交付凭据。使用终端或 SSH 客户端连接；需要图形界面时，再按交付信息连接 VNC。首次进入后，先检查机器规格、系统版本与可用磁盘空间，再配置自己的构建环境。
连接失败时，分别记录 SSH 与 VNC 的结果。提交工单时附上节点编号、失败时间、客户端显示的报错，不要附密码或私钥。
VNC 已连接却只看到黑屏怎么办？
先等桌面会话完成加载，再断开并重新连接一次。确认客户端使用订单中的 VNC 地址与端口，而不是 SSH 端口。如果 SSH 可用，可检查机器是否仍能响应命令，以及当前图形会话是否正常；不要反复重置整机来排查显示问题。
仍是黑屏时，把客户端名称、截图、节点编号以及「SSH 是否正常」写进工单，方便区分显示会话和整机连接故障。
怎样更换 SSH 公钥？
保持当前连接不要退出，先把新公钥追加到目标用户的 ~/.ssh/authorized_keys，确认该目录与文件的权限符合 SSH 要求。另开一个终端，用新私钥完成一次登录测试；测试成功后，才移除旧公钥。
只需上传公钥。私钥留在你自己的设备上，不要通过工单发送。若旧密钥已失效且无法进入机器，在工单中写明订单号和节点编号，请服务团队核对恢复路径。
如何修改机器上的默认密码？
登录交付的 macOS 用户后，在系统设置的用户与群组中更改密码，或在该用户的终端会话中执行 passwd。修改前确认你还保留一条可用的 SSH 或 VNC 连接；修改后用新会话验证，不要只依赖当前已登录的窗口。
如果已无法登录，请从控制台提交工单，附订单号、节点编号和看到的错误信息，不要把旧密码写进工单。
把工具链和项目依赖分开检查
先确认 Xcode 版本，再检查证书、运行时和剩余空间。这样比直接重跑整条 CI 更容易定位问题。
项目需要另一版 Xcode，怎么切换？
先用 xcodebuild -version 核对当前工具链。若机器上已有多个 Xcode 安装目录，可通过 xcode-select -s 指向所需版本，再执行一次版本检查。CI 脚本也可以显式设置 DEVELOPER_DIR，避免不同任务之间互相改变默认版本。
若目标版本尚未安装，先核对该版本的系统要求和剩余磁盘空间，再通过可用的正式安装来源取得安装文件。不要假定每个版本在交付时都已预装。
构建能通过，签名却失败，先看哪里？
按顺序检查证书是否带有对应私钥、描述文件是否匹配目标标识符、构建任务能否访问所用钥匙串。手动桌面构建成功而 CI 失败时，重点比较两种会话的用户身份、钥匙串解锁状态与签名参数。
证书、私钥和钥匙串文件属于你的敏感数据。工单里可以附脱敏后的错误日志，不要上传证书私钥或完整签名密码。
Simulator 找不到项目指定的运行时怎么办？
先在 Xcode 的平台管理界面检查已安装的运行时，或用 xcrun simctl list devices available 查看当前可用设备。缺少所需运行时，就在 Xcode 中下载与当前版本兼容的组件；下载前留出足够磁盘空间。
CI 里不要只按设备名称猜测目标。把运行时版本和设备型号明确写进构建配置，更新 Xcode 后再核对一次目标是否仍可用。
磁盘空间不够，应该清理还是加盘？
先检查 DerivedData、旧 archive、下载的 Simulator 运行时和依赖缓存，确认哪些文件可以安全重建。不要在未备份时删除证书、项目源码或正在使用的产物。
若项目本身需要更大的持久工作区，下单时可选择 +1TB SSD 或 +2TB SSD 附加项。当前在用订单是否支持调整，以控制台实际提供的选项为准；需要协助时附上订单号及空间占用情况开工单。
按订单周期核对，不把月租当日租
两档机型均可选择日、周、月、季。结算金额、起止时间及实际可用支付网关，以控制台下单页面实时返回为准。
日、周、月、季的租期怎么计算？
每次下单选择一个周期，订单会列出对应的价格与到期时间。XV M4 Runner 为 $21.4/天、$57.8/周、$107.1/月、$291.3/季；XV M4 Studio 为 $40.7/天、$109.8/周、$203.3/月、$553/季。价格均为美元。
不要把月付金额直接当作每天扣款。预计使用时长确定后，再比较各周期总价；附加盘等选项也应按同一订单周期核对。
续费后会换成另一台机器吗？
在当前租期结束前完成同一实例的续费，正常情况下继续使用原机器。请在控制台核对续费订单所指向的实例与新的到期时间。需要更换机型或节点时，不要把它当作普通续费；先通过工单确认迁移方式并备份数据。
到期未续的机器会被回收并整盘重置，因此不要把尚未支付完成的续费视为备份方案。
USDT-TRC20 转账需要多少次确认？
请以控制台当前订单给出的收款信息、要求与入账状态为准，不要沿用旧订单的地址或自行假设固定确认次数。转账时核对网络为 USDT-TRC20，并保留交易哈希；链上显示完成而订单仍未更新时，在控制台工单中附订单号和交易哈希。
不要在工单中发送钱包私钥或助记信息。
银行卡按什么币种扣款？
订单以美元（USD）结算。银行卡仅支持经 Stripe 处理的 Visa、Mastercard 与 Amex；实际可用网关以控制台实时返回为准。卡号由 Stripe 处理，不经过本站服务器。
若发卡机构在账单中显示不同的记账金额或附加费用，请先核对发卡机构的规则；订单金额以控制台显示的美元金额为准。
退租前先带走文件，再核对清除规则
把源码、签名材料、构建产物和重要配置列成备份清单。到期后的整盘重置不能代替你的备份。
到期后机器上的数据怎样处理？
租期结束且未续费时，机器回收并执行整盘重置，磁盘数据会被清空，系统重新安装后才用于后续交付。这个过程不会为你保留可恢复的项目副本。
账户与必要账务记录和机器磁盘是两类数据；如需了解账户信息的处理范围，可在控制台提交工单询问。
怎样在到期前完成备份？
先将源码提交到你管理的代码仓库，再把证书与私钥、签名配置、需要保留的 archive、测试数据和脚本导出到你控制的存储位置。对大文件可用 SSH 文件传输工具分批复制，并核对文件大小或校验值。
复制完不要立即删除原件：从备份位置抽取一个项目或产物，实际验证能够打开或重新构建。完成验证后，再按订单到期时间安排退租。
服务团队会查看我机器上的文件吗？
你存放在独享物理机上的项目文件归你所有；我们不查看或分析这些文件。排查故障时，优先使用你在工单中主动提供的节点编号、错误信息与脱敏截图。
截图前请遮住令牌、连接凭据、证书内容及项目中的敏感信息。确需进一步协助时，先在工单中说明你愿意提供哪些诊断材料。
四个亚太节点，状态看控制台实时结果
新加坡、日本（东京）、韩国（首尔）和香港均在两档机型的订购目录内。这里列的是服务覆盖范围，不是实时运行监控；下单可用性与实例状态以控制台返回为准。
新加坡
覆盖东南亚团队的开发与构建任务。
两档机型可订日本（东京）
适合需要靠近日本用户的远程操作与测试。
两档机型可订韩国（首尔）
面向韩国及周边团队的构建与验证。
两档机型可订香港
适合华南及东南亚团队就近连接。
两档机型可订服务通知去哪里看？
节点全年 365 天正常运行，不设置计划停机。若遇到突发故障，请先查看控制台中的实例与工单消息；提交故障工单后，也在同一处跟进处理进度。不要把此处的目录标签当作实时健康状态。
把线索放进同一张工单
登录控制台，选择对应订单提交工单。写清节点编号、订单号、出现问题的步骤和时间；附上脱敏后的报错原文或截图。连接凭据、私钥与密码不要附在工单里。
还没下单、想先确认机型与用途？可发邮件至 support@xcodevps.com，说明项目类型、预计租期和所需节点。