文档
快速开始
安装两端 App,完成配对,发起第一次连接。
Nearshell 由两个 App 组成:Mac 端负责被控,iPhone / iPad 端负责操控。整个上手过程不到几分钟。
Nearshell 尚未正式开放。以下流程描述的是上线后的实际使用方式;想在开放时第一时间收到通知,请加入等候名单。
1. 安装两端
- iPhone / iPad:从 App Store 安装 Nearshell(即将上线);
- Mac:从官网下载免费的 Mac 端。它经过 Apple 公证,双击即可安装,首次打开按提示允许即可。
Mac 端本身免费;订阅在 iPhone / iPad 端购买,14 天免费试用、免费一台 Mac。
2. 授予权限(Mac 端)
Mac 端需要两类系统权限:
- 屏幕录制:用于采集画面;
- 辅助功能:用于注入键鼠输入。只有在授予该权限后,远端的点击与打字才会生效;连接结束时会立即释放所有按下的按键。
在”系统设置 → 隐私与安全性”中授予后重启 App 生效。
3. 配对
配对只需一次,之后设备会被安全地记住。
- 在 Mac 端进入配对页,它会显示一个一次性二维码(包含设备名称、型号与一次性 secret);
- 在 iPhone 上扫码,双方通过 HMAC 双向证明自动固定彼此的加密身份;
- Mac 随即销毁一次性 secret,之后全程使用签名信令。
在没有相机的设备上,可改用文本邀请码:复制 Mac 端显示的文本码,粘贴到 iPhone 的配对页即可。
4. 连接与操控
回到 iPhone 首页,设备以列表卡片呈现:
- 点击设备卡片上的连接;连接优先走直连,必要时经就近的中转节点,全程加密;
- 连接后整块屏幕即触控板:单指移动光标、单击 / 双击、长按拖拽、双指滚动、双指右键;
- 顶部视频按钮启停 Mac 采集;开启视频后可双指缩放 / 平移画面、三指滚动;
- 需要键盘时唤起键盘工具栏,可在”输入法合成”与”按键直传”间切换。
5. 确认链路正常
诊断页实时显示 codec、收发 FPS、jitter buffer、丢帧 / freeze、可用码率与画质限制。连接路径会标记为 Direct(直连)或 TURN(中转),便于判断当前状态。