CrossDesk 支持 Windows、macOS、Linux 之间的远程访问，也可从浏览器或原生 iOS / Android 客户端控制电脑。项目基于 MiniRTC，提供实时音视频传输、键鼠控制、文件传输与自托管能力，仍在持续开发中。
本文按当前仓库代码整理。截图展示当前 Slint 桌面界面，使用演示 ID、密码、在线状态和连接记录；缩略图来自公开页面；下载包的功能与系统要求请同时核对对应 Release 说明。原生 iOS 客户端的构建、签名方式见下文。
界面预览 · 下载与安装 · 快速连接 · 会话操作 · 设置 · iOS · Android · 自托管 · 源码构建 · 常见问题
主窗口集中展示本机 ID、连接密码、远程连接入口和近期连接记录。
在浏览器中输入远程设备 ID 和密码，无需在控制端安装桌面客户端。
图片来源与更新方式见 截图说明。
| 能力 | 当前支持 |
|---|---|
| 跨平台控制 | Windows / macOS / Linux 桌面互控；浏览器与原生 iOS / Android 作为控制端 |
| 实时画面与声音 | H.264 / AV1、硬件编解码、远端声音播放；会话中可调整画质、30 / 60 fps 与画面偏好 |
| 多设备与多显示器 | 近期连接、设备别名、会话标签与远端显示器切换 |
| 输入与协作 | 键鼠输入、远端光标同步、组合键、文本剪贴板同步、文件传输 |
| 网络与部署 | P2P 直连、TURN 中继与强制中继、SRTP 媒体加密、自托管信令与中继服务 |
| 隐私屏 | 被连接时自动开启，或在会话工具栏切换；可用性取决于被控端系统与采集方式 |
| Windows 锁屏控制 | 通过 CrossDesk Service 支持锁屏、登录界面及安全桌面的输入转发 |
| Linux 无头运行 | 复用已有桌面和应用，或创建独立 Xvfb 虚拟桌面；终端控制台可查看状态、修改密码和设置，见 运行说明 |
各客户端的入口和能力有所不同；桌面会话操作见下文，iOS 的具体功能见 开发说明。
前往 GitHub Releases 或 官方网站，按系统与 CPU 架构选择安装包。
| 平台 | 当前源码 / CI 基线 | 安装方式 |
|---|---|---|
| Windows | Windows 10+，x64 | .exe 安装包；便携构建也受支持 |
| macOS | macOS 14.0+，Intel / Apple Silicon | 选择 x64 或 arm64 的 .pkg |
| Linux | Ubuntu 20.04+，amd64 / arm64，glibc 2.31 基线 | .deb 安装包 |
| iOS / iPadOS | iOS 16.0+，arm64 真机 | 原生客户端；使用 Xcode 构建并签名，CI 产物为未签名应用 |
| Android | Android 8.0+，arm64 | 原生控制端；使用 Gradle 构建 APK，见 开发说明 |
| Web | 支持 WebRTC 的浏览器 | 访问 web.crossdesk.cn |
Linux 下载后，在下载目录中将文件名替换为实际安装包名称：
sudo apt install "./crossdesk-linux-amd64-<version>.deb"macOS 首次运行： 按应用提示，在“系统设置 → 隐私与安全性”中授予 CrossDesk 屏幕录制（新系统可能显示为“屏幕与系统音频录制”）及 辅助功能权限，再按系统提示重新打开应用。前者用于捕获桌面，后者用于远程键鼠输入。
- 准备被控电脑。 安装并运行 CrossDesk，等待底部显示“已连接服务器”。在左侧“本桌面”查看 本机 ID 和 密码，提供给控制端。
- 输入对端 ID。 在控制端右侧“远程桌面 → 对端 ID”输入被控电脑的 ID，点击 →。
- 完成密码验证。 按弹窗输入被控电脑当前的连接密码，确认后等待远程画面出现。需要保存密码时勾选“记住密码”。
- 再次连接。 成功连接过的设备会出现在“近期连接”中，可通过卡片重连，也可编辑别名或删除记录。
本机密码旁的眼睛按钮用于显示 / 隐藏密码，刷新按钮用于生成新的随机密码，铅笔按钮用于手动修改。密码统一为 6 位数字或英文字母。修改或刷新时需保持连接服务器；等待修改成功、客户端重新连接后，再复制当前密码。已保存旧密码的控制端需重新输入。
- 保持被控电脑上的 CrossDesk 运行，并确认已连接服务器。