Deskflow 键鼠共享上手：一套键鼠控多台，网格布局与故障排查

Deskflow 是一个开源的键盘鼠标共享工具，装在两台以上电脑后，一套键鼠就能控制它们。鼠标移到屏幕边缘会「穿」到另一台机器，键盘焦点跟着走，剪贴板内容也能带过去。它不传画面，所以不是远程桌面，更接近去掉视频的软件 KVM。

项目托管在 GitHub，采用 GPL-2.0 协议，用 C++ 编写，主页指向 deskflow.org。它是 Synergy 的官方上游项目，Synergy 出钱出代码，并在其上叠加面向企业的闭源功能。这层关系在 官方 wiki 的说明页 里有完整对照。眼下稳定版是 1.27.0，发布于 2026 年 10 月 1 日。

Deskflow 键鼠共享是什么：软件 KVM 的定位与来历

它的工作方式很朴素：一台电脑当服务端，负责读取真实的键鼠输入。其他电脑当客户端，接收指令并模拟按键与鼠标移动。输入不走显示器，所以每台机器仍用自己的屏幕，桌面空间不变。

这条路线的历史比多数人想的要长。Synergy 早期是商业软件，社区为了去掉序列号校验分出了 Barrier。后来 Barrier 的维护者又分出了 input-leap，这个分支目前也已不活跃。Deskflow 由原班人马重新推进，并把 Synergy 的商业代码剥离，回归纯开源。

支持平台覆盖 Windows、macOS、Linux 与 BSD 系。仓库的下载页按平台分得很细：Windows 有 msi 与便携 zip，macOS 有 dmg。Linux 侧则区分了 Debian、Fedora、openSUSE 与 Ubuntu 各自的不同版本号，另有通用 Flatpak 包。

安装与首次连接：服务端、客户端三步走

Windows 侧要注意一个前置条件：先装 Microsoft Visual C++ Redistributable。缺这个组件，程序可能起不来。macOS 用 Homebrew 的 deskflow tap 会更省事，升级也方便。Linux 走 Flatpak 更不容易遇到依赖问题，官方商店页面标注包体约 4 MiB。

连接过程本身只有三步，但顺序不能乱：

1. 在插着键鼠的那台机器上选服务端，点启动，记下它显示的局域网 IP。
2. 在另一台机器上选客户端，填入刚才的 IP，端口默认 24800。
3. 服务端会弹出指纹确认，核对后接受，两端就通了。

第一次连接失败时，多数情况是主机名解析出了问题。直接用 IP 地址，不要填计算机名，能省掉一半排查时间。如果公司网络禁止主机互访，这套方案基本用不了，它不是穿透工具。

屏幕布局怎么摆：网格、边缘延时与锁屏切换

服务端界面里有一张网格，默认 5 列 3 行，最多容纳 15 台电脑。把每台机器的图标拖到它在现实桌面的相对位置，切换方向就定了。左边那台放左边，上方那台放上方，之后鼠标往哪个方向出屏，就进哪台机器。

靠近屏幕边缘办公的人容易误触，配置里有两个开关可以压住这个问题。switchDelay 默认 250 毫秒，光标要停在边缘够久才切过去。switchDoubleTap 则要求快速双击边缘。两者可以同时打开，满足任一条件就切换。

如果希望光标锁定在某台机器上而不是自由穿屏，可以启用锁定并配合 Scroll Lock 或自定义热键。多显示器接在同一台机器上时，把副屏在系统设置里挪到两侧或上下。别把它夹在两台电脑之间，否则切换会多经过一段看不见的空白。

1.27.0 还加了「进入/退出命令」，切换到某台电脑或离开时自动跑一段脚本。用它联动显示器输入源或切换键位映射，比手动按键省事。

剪贴板、TLS 与 Wayland：能力与边界

剪贴板共享默认参与工作，但需要设上限。服务端选项 clipboardSize 以 MB 为单位，客户端收发都跟随服务端取值。超过上限的内容会被拒收，而不是直接断连，这一点在 1.27.0 里做了修正。

传输默认加密。配置项 tlsEnabled 默认为 true，keySize 默认 2048 位，可以改成 4096。首次连接的指纹确认由 checkPeerFingerprints 控制，建议保持开启。指纹对不上就直接拒绝，别图省事关掉。

Wayland 是这套工具长期以来的坎。1.27.0 把剪贴板后端换成 xdg portal，移除了对 wl-clipboard 的依赖。全局快捷键也走 portal。

代价是输入捕获对桌面版本有要求。ArchWiki 的记录是 GNOME 46 或 KDE 6.1 以上才具备该能力，旧版本桌面仍会退回 X11。

常见故障排查：连不上、macOS 权限与锁屏

连不上先查三处。防火墙是否放行 24800；填的是 IP 还是主机名；TLS 密钥是否需要重新生成。官方 wiki 的 Workarounds 页还提到一种情况：Windows 服务端由后台服务托管，个别机器上反而会破坏服务端模式。可以在「配置服务端 - 高级」里关掉它再试。

macOS 需要两个权限，缺一不可。辅助功能（Accessibility）负责模拟输入。输入监控（Input Monitoring）负责把按键发出去。升级版本后旧条目常常失效，得先删掉再加一次，否则会出现「能连上但键盘没反应」。

剪贴板同步并不总是可靠。少数派有作者在 Windows 与 Linux 直连场景里发现日志显示已更新、粘贴却拿不到内容。于是他拆成两条链路，把剪贴板交给 CrossPaste 单独处理，Deskflow 只负责键鼠。这个思路值得借鉴，两条链路互不影响。

社区还反馈过一个具体限制：Windows 客户端锁屏后，从服务端无法用这套键鼠唤醒并解锁登录界面，得先在本机操作。另外 1.25 与 1.26 版本在长按按键时可能让 Barrier 客户端崩溃，混用老版本时要注意。

适合谁用，不适合谁用

适合的场景很明确：桌面上有两到三台电脑，各带自己的显示器，希望用一套键鼠横跨操作。台式机加笔记本、Windows 加 macOS、开发机加测试机，都属于这一类。它不占桌面空间，也不用再买 KVM 切换器。

不适合的场景同样明确。它不传画面，所以外出远程办公用不上。它不传文件，拖拽跨机传文件得靠 Tessoa 这类跨平台文件管理器 或共享文件夹。它依赖局域网互通，跨网段或访客网络里基本连不上。

如果你只用 Windows 且不超过四台机器，微软 PowerToys 里的无界鼠标是更省心的选择，PowerToys 的实操记录里已经覆盖过。跨系统、需要 Wayland、需要靠协议兼容老客户端时，Deskflow 的优势才显出来。

上手建议：先在两台机器上跑通一次最小连接，确认键鼠和剪贴板都正常，再往网格里加第三台。剪贴板如果反复出问题，就按拆链路的思路，把它交给独立工具，比如 CopyQ 这类剪贴板管理器 再加同步方案。

参考资料收在这里。配置细节看 GUI Settings 文档，故障排查看 Workarounds 页。下载与版本说明在 1.27.0 发布页，Linux 打包信息见 Flathub 页面。项目主页是 deskflow.org，仓库在 GitHub，Wayland 与旧版本细节可对照 ArchWiki 与 少数派的直连实践。