远程桌面使用手册

连接远程 Mac,先从这里排查

已拿到交付信息?先确认节点、连接地址和端口,再按所用系统选择屏幕共享、VNC 或 SSH。下面的步骤也覆盖首次登录、安全设置与常见故障。

按问题找入口

先选你正在处理的事

连接不上先看地址与端口;已经进入桌面,再处理安全、画质或工具链。

交付后第一步

用你手边的设备连接 Mac

在控制台实例详情中核对连接地址、端口和初始凭据。不要把凭据复制到公开聊天或代码仓库。

01 / macOS

使用系统自带屏幕共享

  1. 在 Finder 选择「前往」→「连接服务器」。
  2. 输入交付信息中的屏幕共享地址;若提供了专用端口,按交付信息一并填写。
  3. 使用分配给这台 Mac 的用户名和密码登录,首次进入后立即修改初始密码。

连接成功但画面偏小?先调客户端缩放,不要立刻提高远端分辨率。

02 / Windows 与 Linux

使用支持 VNC 的客户端

  1. 从实例详情复制 VNC 地址与端口,填入客户端的连接目标。
  2. 按提示输入交付凭据;不要把密码保存在共享电脑上。
  3. 建立连接后,先测试鼠标、键盘和剪贴板,再调整画质。

客户端要求单独填写主机和端口时,请拆开输入,不要把整条地址都放进主机栏。

在可信网络中通过 SSH 隧道转发 VNC

先从实例详情取得 SSH 主机、端口及 VNC 端口,并在本机设置对应的环境变量。以下命令将远端 VNC 服务映射到本机 5901;保持终端窗口运行,再让 VNC 客户端连接 127.0.0.1:5901。

ssh -N -p "$SSH_PORT" -L "5901:127.0.0.1:$VNC_PORT" "$MAC_USER@$MAC_HOST"

如果本机 5901 已被占用,换一个空闲的本地端口,并在 VNC 客户端中同步修改。SSH 与 VNC 的实际端口以实例详情为准。

首次登录检查

先收紧访问,再导入项目

以下操作在远端 macOS 内完成。调整共享与防火墙规则前,保留当前连接,并确认自己仍有可用的重新连接方式。

01更换初始密码

登录后在系统设置中修改当前用户密码;团队交接时使用独立用户,不共用同一份初始凭据。

02评估 FileVault

需要磁盘加密时在「隐私与安全性」中开启 FileVault,并妥善保存恢复信息;先确认重启后仍能完成远程登录。

03核对防火墙

开启防火墙后,只保留当前工作所需的屏幕共享、远程登录等入口;逐项验证连接,再关闭多余规则。

04添加 SSH 公钥

在远端用户的授权密钥文件中加入自己的公钥,测试密钥登录成功后,再调整密码登录策略。

05精简共享服务

在系统设置的「共享」中关闭不使用的文件共享和远程管理功能;不要误关正在使用的屏幕共享或远程登录。

让输入跟得上画面

先调传输,再调桌面尺寸

拖动窗口卡顿不一定是 Mac 算力不足。先区分画面传输延迟、网络抖动和构建任务本身的资源占用。

分辨率与缩放

先保留默认桌面分辨率,在客户端使用适合屏幕的缩放。需要并排查看 Xcode 与模拟器时,再提高远端分辨率;画面像素越多,传输带宽需求通常越高。

高画质与低带宽

静态代码编辑可以优先选择清晰文字;网络波动时改用客户端的低带宽或较低画质设置。切换后分别测试输入响应与滚动流畅度,不要同时改动多项设置。

跨区域选择节点

优先选靠近实际操作者的节点,而不只是靠近团队总部。新加坡、日本(东京)、韩国(首尔)、香港、美国东部均在目录内;跨洋连接前先比较自己网络到候选节点的实际表现。

机型与节点的可选组合以控制台实时返回为准。已在使用的实例如需讨论迁移,先提交工单说明当前节点、目标节点与可接受的中断时间。

服务承诺

可用率如何核算

所有节点全年运行,不设置计划停机时段。下方展示的是服务承诺与核算方式,不是实时监控读数。

99.9% 月度可用率承诺

查看近 90 天记录时,按月分别核算

这三个区间仅帮助定位需要核对的时间段,不代表每日状态或已测得的在线率。请以控制台记录核对具体事件与受影响时长。

赔付口径:月度可用率低于 99.9% 时,按不可用时长的 10 倍顺延服务时长。申请时请附实例、节点及开始和恢复时间,便于核对。

逐项排除

四类常见故障,先检查这些点

每次只改一个变量。记录报错原文和发生时间;如果要提交工单,这些信息比「连接失败」更有用。

画面黑屏

  • 确认实例详情仍显示可连接,并等待 macOS 完成当前启动过程。
  • 重新建立会话,检查客户端是否误选了无画面的显示器。
  • 尝试降低客户端画质;若 SSH 可连接但桌面持续黑屏,记录发生时间并提交工单。

完全连不上

  • 重新复制实例详情里的地址与端口,排除旧书签。
  • 检查本地网络或公司防火墙是否拦截该连接;换一个可信网络复测。
  • 分别记录屏幕共享、VNC 与 SSH 哪些方式可用,不要反复猜测凭据。

操作卡顿

  • 查看本地网络是否抖动,以及远端是否正执行构建或模型推理。
  • 降低画质或桌面分辨率后复测键盘输入。
  • 对比不同时段的表现,记录操作者所在地区与所用节点。

剪贴板不同步

  • 确认客户端已允许双向剪贴板同步,并重新建立会话。
  • 先用短文本测试;文件传输不要依赖文本剪贴板。
  • 如仍失败,注明客户端名称、版本以及复制方向。
开发环境

按依赖顺序准备 Xcode 工具链

先确定项目要求的 Xcode 版本,再安装命令行与包管理工具。把签名材料放在最后导入,避免版本调整后重复配置。

  1. 01

    确认 Xcode 与 Command Line Tools

    打开 Xcode 核对版本及组件状态,再执行 xcode-select -p 检查活动开发者目录。项目锁定版本时,先对齐版本再跑构建。

  2. 02

    安装项目所需依赖

    按项目文档配置 Homebrew、Ruby 与 CocoaPods 等工具。安装后记录版本,并先用不含签名的构建验证依赖是否齐全。

  3. 03

    导入证书与描述文件

    将团队授权使用的签名证书导入远端钥匙串,设置适当的访问权限,再导入对应的描述文件。不要把私钥或密码放进仓库。

  4. 04

    执行一次可复现的首跑

    依次验证依赖安装、模拟器构建和需要签名的归档流程。记录 Xcode 版本、失败命令和完整错误片段,供后续排查。

需要人工协助时

把问题写成能复现的工单

已购用户登录控制台提交工单;售前或无法登录时,可发邮件至 support@xcodevnc.com。请勿在邮件中发送密码或私钥。

提交前备齐四项

  • 实例与节点:控制台中的实例标识、所用节点和机型。
  • 问题时间段:首次出现与最近一次复现的时间,并注明时区。
  • 复现路径:所用系统、客户端、连接方式和具体操作。
  • 诊断结果:错误提示、已尝试的排查步骤,以及 SSH 或桌面连接各自是否可用。

何时直接升级处理

核对地址与端口、换网络后仍无法连接;SSH 可用但桌面持续黑屏;或同一故障反复影响正在进行的构建时,直接在工单中说明影响范围与紧急程度。

账单、续费和收据也通过控制台核对。支付仅支持 USDT-TRC20,或经 Stripe 处理的 Visa、Mastercard、Amex,均以美元结算;实际可用网关以控制台返回为准。

下一步

问题排清楚,再开始使用远程 Mac

还在选配置?先对照两档 M4 的规格与周期价格。已经下单?从控制台取最新连接信息。