连接,从这里开始。Make yourself at home.

从首次配对到日常连接,按你的节奏完成设置。From first pairing to everyday connections, set up at your own pace.

开始之前Before you start

RelayDesk 的 Mac 版本需要 macOS 14 或更新系统。首个公开版本面向 Apple 芯片 Mac;最低系统版本并不代表已在所有系统与设备上完成测试。RelayDesk for Mac requires macOS 14 or later. The first public release is intended for Macs with Apple silicon. Minimum requirements do not mean every system and device has been tested.

iPad 客户端尚未公开发行。以下 iPad 步骤面向已经获得测试客户端的用户;本网站目前不提供 App Store 安装入口。The iPad app is not publicly available yet. The iPad steps below are for people who already have a test client; there is no public App Store installation link at this time.

先在 Mac 旁完成首次设置,保留独立操作 Mac 的方式。请在出门前实际测试所选连接方式。Complete the initial setup beside your Mac, and keep another way to operate it. Test your chosen connection before leaving your Mac unattended.

安装与授权Install and allow access

公开版本发布后,从本站下载 Mac 安装包,将 RelayDesk 放入“应用程序”并从固定位置打开。更新时使用相同安装位置,以便保留设置。Once a public release is available, download it here, put RelayDesk in Applications, and launch it from that location. Keep the same installation location when updating to preserve your setup.

在“共享这台 Mac”中检查屏幕录制权限;需要键盘和指针控制时,再允许辅助功能。系统可能要求重新打开 App 才能应用权限。只查看画面时,可以关闭远程输入。In Share This Mac, check Screen Recording permission. Allow Accessibility when you want keyboard and pointer control. macOS may ask you to reopen the app to apply permission changes. You can turn off remote input for viewing only.

音频、剪贴板、文件接收目录和可浏览的共享文件夹按需要分别开启。文件共享只授权你愿意提供的目录。Enable audio, clipboard access, a file inbox, and a browsable shared folder separately as needed. Share only folders you intend the connected device to access.

如果 macOS 提示无法验证下载或签名,请先核对本网站与发布页,不要关闭系统安全保护。If macOS cannot verify a download or its signature, check this website and the release page first. Keep system security protections enabled.

通过 Wi-Fi 配对Pair over Wi-Fi

将 Mac 与 iPad 连到可信的同一局域网。Mac 点“开始共享”,再打开限时的新设备配对窗口;iPad 允许本地网络访问并选择“添加 Mac”。Connect the Mac and iPad to the same trusted local network. On the Mac, start sharing and open the temporary new-device pairing window. On iPad, allow Local Network access and choose Add Mac.

选择发现的 Mac,仔细核对两端六位数字完全一致,再分别确认。之后可以从已保存的设备连接。六位数字用于核对本次配对,不是长期密码。Select the discovered Mac, check that the six digits match on both devices, and confirm on each. You can then reconnect from saved devices. The six digits verify this pairing; they are not a permanent password.

找不到 Mac 时,检查本地网络权限、系统防火墙、访客 Wi-Fi 的设备隔离和配对窗口是否仍有效。不要把主机端口直接开放到互联网。If the Mac is missing, check Local Network permission, the firewall, guest-network device isolation, and whether the pairing window is still open. Do not expose the host port directly to the internet.

通过 USB 连接Connect with USB

使用支持数据传输的数据线连接设备,解锁 iPad,并完成系统“信任此电脑”。在 Mac 开始共享,保持 iPad 客户端前台运行。Connect the devices with a data-capable cable, unlock the iPad, and complete the system Trust This Computer prompt. Start sharing on the Mac and keep the iPad client in the foreground.

首次使用,在 iPad 的“添加 Mac → 使用数据线”中配对,核对双方六位码;已经配对的设备可使用保存的身份连接。插线不会自动跳过配对与权限。For first use, pair from Add Mac → Use a Cable on iPad and compare the six-digit codes. Previously paired devices can use their saved identity. A cable does not bypass pairing or permissions.

USB 连接目前仍属实验功能,线缆、设备信任、锁屏和系统版本可能影响连接。它不是 HDMI 输入,也不承诺雷电速率;有问题时先回到前台并重连,再尝试局域网。USB connectivity is still experimental. Cables, device trust, locking, and OS versions can affect it. It is not an HDMI input and does not promise Thunderbolt speeds. Return to the foreground and reconnect, or try the local network.

熟悉的 Mac 输入Familiar Mac input

原生连接默认使用 Mac 输入法和整台 Mac 的指针控制。中文候选由 Mac 处理;长按按键重复沿用 Mac 设置。系统保留快捷键与部分手势仍可能不同。Native connections use the Mac input method and whole-Mac pointer control by default. The Mac handles text composition and held-key repeat settings. System-reserved shortcuts and some gestures may still behave differently.

普通 Esc 发送给 Mac;Control + Option + Shift + Esc 用于退出整台 Mac 的输入捕获。打开连接工具时会暂时让出远程输入。A normal Esc is sent to the Mac. Control + Option + Shift + Esc exits whole-Mac input capture. Opening connection tools temporarily releases remote input.

文件需要主动选择后传送;下载仅来自 Mac 已授权的共享文件夹。已完成的文件会留在接收设备上,断开连接不会自动删除。File transfers start when you choose a file. Downloads come from the Mac folder explicitly shared with the client. Completed files remain on the receiving device after disconnecting.

外出连接与启动边界Remote access and startup limits

跨网络连接需要自行配置可达的 VPN,例如 Tailscale。RelayDesk 没有自建云中继或自动公网穿透服务;VPN 服务的数据处理由相应提供方负责。Connecting across networks requires a reachable VPN you configure, such as Tailscale. RelayDesk does not provide its own cloud relay or automatic internet traversal service. Your VPN provider handles its own service data.

登录启动与自动共享服务于已登录的 macOS 用户会话。RelayDesk 不提供 FileVault 预启动或恢复模式画面,也不能远程开机。保留 FileVault,不要依赖它作为唯一的开机与恢复途径。Launch at login and automatic sharing serve an already signed-in macOS session. RelayDesk does not show FileVault preboot or Recovery screens, and cannot power on a shut-down Mac. Keep FileVault enabled and retain another startup and recovery method.

实验性扩展屏、临时主屏以及 iPad 后台恢复仍受系统限制。请以当前发布说明和实际测试为准,不要把可选择的帧率当作保证达到的帧率。Experimental extended displays, temporary primary displays, and iPad background recovery remain subject to system limits. Check the release notes and test your setup; a selectable frame rate is not a guaranteed frame rate.

更新与反馈Updates and feedback

公开 Mac 版本支持检查更新。自动检查默认关闭,可以主动开启;更新安装仍需确认。开发或未配置更新的版本不会发起更新检查。Public Mac builds support update checks. Automatic checks are off by default and can be enabled; installing an update still requires confirmation. Development builds and builds without an update configuration do not check for updates.

反馈问题时,请提供版本、Mac/iPad 型号、系统版本、USB 或网络连接方式与复现步骤。GitHub Issue 是公开的,请勿附上密码、配对密钥、文件内容或未打码的私人桌面截图。When reporting a problem, include the app version, device models, OS versions, connection route, and steps to reproduce it. GitHub issues are public: do not post passwords, pairing keys, file contents, or unredacted private desktop screenshots.