这个项目能做什么

CrossDesk 是一款轻量、跨平台的远程桌面软件,目标是让电脑、浏览器和 iPhone / iPad 连接到同一张桌面。项目基于 MiniRTC 构建,提供实时音视频传输、键鼠控制、文件传输与自托管能力,目前仍在持续开发中。 ## 平台与安装 支持 Windows 10+(x64)、macOS 14.0+(Intel / Apple Silicon)、Linux(Ubuntu 20.04+,amd64 / arm64,glibc 2.31 基线)以及 iOS 16.0+ 真机。桌面端提供 .exe、.pkg、.deb 安装包,可从 GitHub Releases 或官方网站下载;Web 端直接访问 web.crossdesk.cn,无需在控制端安装桌面客户端。macOS 首次运行需在系统设置中授予屏幕录制与辅助功能权限。 ## 主要能力 - 跨平台控制:Windows / macOS / Linux 桌面互控,浏览器与原生 iOS 作为控制端。 - 实时画面与声音:支持 H.264 / AV1、硬件编解码、远端声音播放,会话中可调整画质、30 / 60 fps 与画面偏好。 - 多设备与多显示器:近期连接、设备别名、会话标签与远端显示器切换。 - 输入与协作:键鼠输入、远端光标同步、组合键、文本剪贴板同步、文件传输。 - 网络与部署:P2P 直连、TURN 中继与强制中继、SRTP 媒体加密、自托管信令与中继服务。 - 隐私屏:被连接时自动开启,或在会话工具栏切换。 - Windows 锁屏控制:通过 CrossDesk Service 支持锁屏、登录界面及安全桌面的输入转发。 - Linux 无头运行:复用已有桌面和应用,或创建独立 Xvfb 虚拟桌面,终端控制台可查看状态、修改密码和设置。 ## 使用方式 从另一台电脑连接时,被控端运行 CrossDesk 并等待显示“已连接服务器”,将本机 ID 与密码提供给控制端;控制端输入对端 ID 后按弹窗输入密码即可。密码统一为 6 位数字或英文字母,可显示、刷新或手动修改。从浏览器连接时,打开 Web 客户端输入远程设备 ID 和密码即可操作远端,手机和平板也可通过浏览器访问。 会话控制栏提供显示器切换、组合键发送、鼠标控制、声音播放、文件发送、画面设置、网络状态查看、隐私屏切换、全屏与断开连接等操作。网络状态面板可查看流量、丢包率、帧率、分辨率、直连 / 中继及加密状态。 ## 设置与自托管 客户端设置包含语言(中文、English、Русский)、Windows 采集方式(自动 / DXGI / WGC / GDI)、视频编码格式、中继服务与强制中继、自动隐私屏、自托管配置、开机自启与守护进程、文件保存路径等。客户端启动后会在后台检查版本,也可在“关于”中手动检查更新。 自托管方面,可自行部署信令服务与 TURN 中继,并在桌面客户端设置中填写连接信息,控制端与被控端需启用同一套配置。仓库提供自托管指南、服务端源码(CrossDesk Server)与浏览器端源码(CrossDesk Web Client)的链接。 ## 开发与许可 仓库包含源码构建、iOS 开发说明、GUI 架构与常见问题等文档,并接受 GitHub Issues 反馈。项目使用 GPL-3.0 许可,官方 Windows 发布包通过 SignPath.io 进行代码签名。