CrossDesk 远程桌面功能CrossDesk remote desktop features
从单台电脑的远程操作,到桌面墙中的多设备管理,让常用设备随时可达。From a single remote computer to a wall of connected desktops, keep your devices within reach.
跨平台远程桌面Cross-platform remote desktop
在 Windows、macOS 与 Linux 电脑之间发起远程会话。主窗口集中显示本机 ID、远程连接入口与近期设备,方便重新连接常用电脑。Start remote sessions between Windows, macOS, and Linux computers. The main window brings your device ID, connection controls, and recent devices together for quick reconnection.
远程会话提供键鼠操作、音频、文本剪贴板与文件传输;可用能力取决于客户端平台与版本。Remote sessions support keyboard and mouse input, audio, text clipboard sharing, and file transfer. Availability depends on the client platform and version.
下载桌面客户端 →Download desktop clients →
桌面墙:集中管理多台设备DeskHub: manage multiple devices
在同一窗口查看多台远程设备的画面,按分组组织设备,放大需要操作的桌面,并执行批量连接、断开或文件分发。Preview multiple remote devices in one window, organize them into groups, expand the desktop you want to control, and connect, disconnect, or distribute files in batches.
桌面墙支持群控及画面传输设置。群控会向已连接设备发送相同的坐标和按键;设备屏幕尺寸不同,操作结果也可能不同。DeskHub supports group control and streaming settings. Group control sends identical coordinates and keys to connected devices, so results can differ across screen sizes.
分辨率、帧率与带宽调节按被控端能力生效。Resolution, frame rate, and bandwidth controls depend on the remote device’s capabilities.
浏览器与移动端访问Browser and mobile access
在 Web 客户端输入设备 ID 与密码即可发起连接。iOS 和 Android 原生客户端也可作为控制端,让手机或平板访问电脑。Enter a device ID and password in the Web client to start a connection. Native iOS and Android clients also let you control a computer from a phone or tablet.
被控电脑需要安装并运行 CrossDesk。移动端和浏览器端的功能范围与桌面客户端可能不同。The remote computer must have CrossDesk installed and running. Mobile and browser clients may support a different set of features from desktop clients.
打开 Web 客户端 →Open web client →
终端 CLI:在命令行中连接桌面Terminal CLI: connect from the command line
crossdesk-cli 通过 9 位设备 ID 连接被控电脑,默认只读、静音。可切换显示器、调整画质、放大和平移画面,也可按需开启键鼠控制。crossdesk-cli connects to a computer by its 9-digit device ID and starts in read-only, silent mode. Select a monitor, adjust quality, zoom and pan, or enable keyboard and mouse control when needed.
普通终端使用 ANSI 字符显示桌面;支持 Kitty 图形协议的终端可显示像素画面。默认自动探测 Kitty 支持,未获支持时使用 ANSI。Standard terminals display the desktop as ANSI characters. Terminals supporting the Kitty graphics protocol can show pixel graphics. The CLI detects Kitty support automatically and falls back to ANSI.
两图采集于 2026-10-31,来自同一设备的实际只读连接,经 128 × 40 字符视口的伪终端采集并渲染;实际终端效果取决于字体、窗口大小与协议支持。点击图片查看原图。Captured on October 31, 2026 from real read-only sessions with the same host, using a 128 × 40-cell pseudo-terminal to capture and render protocol output. Appearance varies with terminal fonts, window size, and protocol support. Select an image to view it at full size.
安装并连接Install and connect
准备 Node.js 22 或以上及 npm。安装时会自动选择对应系统与 CPU 架构的原生程序,无需本机编译。Install Node.js 22 or later and npm. Installation selects the native executable for your operating system and CPU architecture; no local compilation is required.
npm install -g @chunkdash/crossdesk-cli@latest
crossdesk-cli doctor --json
crossdesk-cli 123456789
将 123456789 替换为被控电脑的 9 位设备 ID,按提示隐藏输入密码。doctor 仅检查本机环境,不发起连接。被控电脑需运行 CrossDesk 并提供可捕获的图形会话,两端接入的信令服务需支持 CLI 临时身份注册。Replace 123456789 with the host’s 9-digit device ID and enter its password at the hidden prompt. doctor checks the local environment without connecting. The host must run CrossDesk with a capturable graphical session, and both ends must use a signaling service that supports temporary CLI identities.
选择画面模式Choose a renderer
可显式选择 ANSI 或 Kitty;ANSI 下阅读小字时,使用 --zoom native 进入细节模式。Select ANSI or Kitty explicitly. Use --zoom native to inspect fine detail in ANSI mode.
crossdesk-cli 123456789 --renderer ansi --zoom native
crossdesk-cli 123456789 --renderer kitty
查看、控制与退出View, control, and exit
| 操作Action | 按键Keys |
|---|---|
| 开启键鼠控制Enable keyboard and mouse control | 只读模式下按 cPress c in read-only mode |
| 放大细节 / 回到全景Inspect detail / fit the desktop | d / f |
| 缩放 / 平移Zoom / pan | +、- / 方向键+, - / arrow keys |
| 暂停远端输入,进入本地命令模式Pause remote input and enter local command mode | Ctrl+] |
| 退出连接End the session | 只读模式按 q;控制模式先按 Ctrl+],再按 qPress q in read-only mode; in control mode, press Ctrl+], then q |
缩放、平移快捷键适用于只读或本地命令模式。控制模式下的普通按键会发送到远端;本地命令模式按 Esc 返回会话。CLI 仅作为控制端,当前不提供音频播放、文件传输或剪贴板同步。Zoom and pan shortcuts apply in read-only or local command mode. In control mode, ordinary keys are sent to the host; press Esc in local command mode to return to the session. The CLI acts only as a controller and currently does not provide audio playback, file transfer, or clipboard sync.
硬件加速与连接方式Hardware acceleration and connectivity
CrossDesk 基于 MiniRTC,支持 H.264 / AV1 视频和硬件编解码。NVIDIA、VideoToolbox 等加速能力取决于设备、系统和构建配置。Built on MiniRTC, CrossDesk supports H.264 / AV1 video and hardware codecs. NVIDIA, VideoToolbox, and other acceleration options depend on hardware, operating system, and build configuration.
连接优先尝试 P2P 直连,无法直连时可通过 TURN 中继。你也可以部署自己的信令与中继服务。Connections attempt P2P access first and can use a TURN relay when a direct connection is unavailable. You can also deploy your own signaling and relay services.
查看自托管部署指南 →Read the self-hosting guide →