kunkundi/crossdesk

项目介绍

CrossDesk 是一款跨平台远程桌面软件，Windows、macOS、Linux 桌面客户端既可做主控也可被控，同时提供浏览器、iOS、Android 和终端客户端访问远端电脑。连接方式有两种：通过信令服务器用 9 位设备 ID 建立会话，或在局域网内用 IP 加端口直连，后者不依赖云端信令。项目基于 MiniRTC 实现，支持自托管信令与 TURN 中继服务。

桌面端除基本远控外，还提供多显示器切换、H.264/AV1 硬件编解码、远端音频、文本剪贴板同步、双栏文件传输，以及 DeskHub 桌面墙——可集中预览、分组、群控多台设备并批量分发文件。终端 CLI 能以 ANSI 字符或 Kitty/Sixel 像素画面观看远端桌面，MCP 服务则允许兼容的 Agent 观察和操作远端电脑，支持实时监看与人工接管。

快速使用

1. 在被控电脑上安装 CrossDesk。从官方网站或 GitHub Releases下载与系统、CPU 架构匹配的安装包；macOS 首次运行需按提示授予屏幕录制和辅助功能权限。
2. 在被控端切换到 ID 连接模式，等待显示已连接服务器，记下本机 ID 和连接密码。
3. 在另一台电脑输入 9 位设备 ID，点击连接，再输入被控端显示的密码。也可以使用原生移动端或Web 客户端。
4. 局域网场景下，两台电脑均切换到 IP 直连模式，在控制端输入对方的 IP:端口（默认端口 52888），再输入被控端显示的 6 位字母数字密码。两端可互相访问即可，无需外网。

终端 CLI

CLI 通过 npm 分发，需要 Node.js 22 及以上。全局安装后按设备 ID 连接：

npm install -g @chunkdash/crossdesk-cli@latest
crossdesk-cli doctor --json
crossdesk-cli 123456789

将 123456789 换成被控电脑的设备 ID，连接时按提示隐藏输入密码。默认只读、静音，按 c 开启键鼠控制。支持图形协议的终端可用 --renderer kitty 或 --renderer sixel 显示像素画面。CLI 当前不支持 IP 直连、音频、文件传输、剪贴板同步和可信设备认证。

使用约束

• Windows 需要 Windows 10 及以上 x64；macOS 需要 14.0 及以上，并按 Intel / Apple Silicon 选择对应安装包；Linux 面向 Ubuntu 20.04+、glibc 2.31，amd64 或 arm64。
• iOS 和 Android 客户端仅能作为控制端，手机不能作为被控桌面。鸿蒙 PC 和移动端仍处于开发版真机验收阶段。
• Linux 上会话内调整远端分辨率需要 X11 和 RandR，Wayland / XWayland 暂不支持。
• 可信设备限制要求两端都使用支持该认证的客户端；当前 CLI、iOS、Android 和鸿蒙移动端尚未实现。
• MCP 功能目前需从源码构建使用，且需要 Codex 或 DSH 作为宿主。
• 项目使用 GPL-3.0-only 许可。自托管需要单独部署信令与 TURN 服务端，并让两端接入同一服务。

HotRepo 点评

在 2026-11-14 的 C++ 日榜中，CrossDesk 单日新增 13 星，当天最好名次为第 2。这条快照说明项目在 C++ 社区内获得了一波集中关注，但只有一天的数据，不足以判断长期增长或采用情况。项目覆盖面较广，同时提供桌面端、移动端、Web、CLI、MCP 和可自托管服务端，评估时需要把功能广度与上面列出的平台缺口放在一起看，尤其是移动端只能做主控、CLI 尚不支持可信设备认证这两点。