Deskflow：一套键鼠无缝控制多台电脑的开源软件 KVM #

Deskflow 是什么？ #

Deskflow 是一款免费开源的键盘与鼠标共享应用，让你用一台电脑的键盘、鼠标或触控板，直接操控旁边其他电脑，并在多台设备之间无缝切换工作。

它常被形容为"没有视频功能的软件 KVM（Software KVM）"：你不需要额外的硬件切换器，也不需要频繁插拔 USB 接收器，只要让多台电脑处于同一个局域网中，就能把鼠标从一个屏幕"滑"到另一台电脑的屏幕上，键盘输入也会自动跟随。对于同时使用台式机与笔记本的开发者、把工作机与测试机并排摆放的运维人员，或以 Mac + Windows 双机办公的创作者来说，Deskflow 能显著减少桌面上的冗余外设与操作中断。

项目以 GPL-2.0 协议开源，在 GitHub 上已获得约 29.8k Star、5.0k Fork，代码提交超过 7,400 次，默认启用 TLS 加密传输，并明确支持剪贴板共享与 Linux Wayland 环境。

Deskflow 有哪些亮点特色？ #

• 一套键鼠，多机通用：把鼠标移到屏幕边缘即可切换到相邻电脑，键盘输入自动跟随焦点，无需 KVM 硬件切换器，也无需在两套键鼠之间来回腾挪。
• 软件 KVM 的轻量方案：只共享输入设备而不传输视频信号，因此不占用大量带宽，也不依赖采集卡，局域网环境下操作延迟低、体验接近本地。
• 默认启用 TLS 加密：客户端与服务器之间的通信默认经过 TLS 加密，避免键击与剪贴板内容在局域网中以明文传输。
• 支持剪贴板共享：在一台电脑上复制的文本可以在另一台电脑上直接粘贴，减少通过聊天工具或 U 盘中转的步骤。
• 广泛的跨平台覆盖：官方支持 Windows、macOS、Linux，并官方支持 FreeBSD，同时希望未来支持 OpenBSD、NetBSD、DragonFly 与 Solaris 等 Unix-like 系统。
• 拥抱 Wayland：在 Linux 上支持 Wayland 会话，服务端与客户端需要 libei 1.3+ 与 libportal 0.8+，图形界面需要 Qt 6.7+。
• 与 Synergy / Barrier / Input Leap 网络互通：Deskflow 与这些同源分支在网络协议层面保持兼容，便于在混合部署环境中逐步迁移。
• 完全开源、社区活跃：GPL-2.0 许可，29.8k Star 的社区规模，通过 Matrix（#deskflow:matrix.org）与 Libera Chat IRC（#deskflow、#deskflow-dev）进行讨论与协作。

免费下载 Deskflow #

以下为官方提供的各平台安装包，点击链接即可下载。

提示：Windows 用户还需安装 Microsoft Visual C++ Redistributable（官方提供 vc_redist.x64.exe 与 vc_redist.arm64.exe）。macOS 用户也可通过官方 homebrew-tap 安装并保持更新。

Deskflow 如何使用？ #

Deskflow 采用经典的"服务器 + 客户端"模型：一台电脑作为服务器（Server，接驳物理键鼠），其余电脑作为客户端（Client）接收输入事件。

1. 在所有电脑上安装 Deskflow：每台需要共享键鼠的电脑都要安装同一大版本的程序，并确保它们处于同一局域网内。
2. 在主力电脑上配置服务器：打开 Deskflow，选择"Server"模式，进入屏幕布局配置界面，按照实际物理摆放位置添加客户端屏幕（例如左、右或上、下），并为每台客户端指定名称。
3. 在其余电脑上配置客户端：选择"Client"模式，填入服务器电脑的局域网 IP 地址或主机名，保存配置。
4. 启动服务并切换：先在服务器端点击启动，再在客户端依次启动。之后把鼠标移动到屏幕边缘，光标就会"跨"到相邻电脑上，键盘输入也随之切换。
5. 按需开启附加功能：在设置中确认剪贴板共享、TLS 加密等选项处于开启状态；如需与 Synergy 1 客户端互通，需在服务器设置中把协议切换为 Synergy。

macOS 首次运行需要为 Deskflow 应用与 deskflow 进程授予"辅助功能"权限（系统设置 → 隐私与安全性），在 macOS Sequoia 上可能还需要在"本地网络"中允许 Deskflow。

Deskflow 的常见问题？ #

Deskflow 与 Synergy、Input Leap、Barrier 兼容吗？

兼容。Deskflow 与这些分支在网络协议层面可互通（需 Deskflow ≥ v1.17.0.96）：Deskflow 与 Input Leap、Barrier 的服务端或客户端可以"直接工作"；把 Deskflow 客户端连接到 Synergy 1 服务器同样可用；若要连接 Synergy 1 客户端，则需要在 Deskflow 服务器设置中选择 Synergy 协议。注意目前仅兼容 Synergy 1，尚不兼容 Synergy 3。

Deskflow 支持剪贴板共享吗？

支持。官方明确列出剪贴板共享为可用功能，可在多台电脑之间直接复制粘贴文本内容，减少中转步骤。

Linux 上的 Wayland 能用吗？

可以。官方说明 Wayland 已获支持，但 Linux 服务端/客户端需要 libei 1.3+ 与 libportal 0.8+，图形界面需要 Qt 6.7+。若系统版本较低无法满足依赖，官方建议改用 Flatpak 版本替代原生包。

macOS 提示应用"已损坏"，无法打开怎么办？

这是因为项目未使用 Apple 证书进行公证签名，属于预期现象。把应用复制到「应用程序」目录后，执行 xattr -c /Applications/Deskflow.app 清除隔离属性即可运行；若通过 Homebrew 安装则一般不会遇到该问题。

Deskflow 与 Lan Mouse 兼容吗？

目前不兼容。官方表示希望未来实现互通，但两者处理生成输入事件的方式差异较大，短期内实现兼容需要投入较多工作。

升级后键鼠共享失效，或权限授权异常怎么办？

macOS 上如果旧版本的 Deskflow 或 deskflow 进程已在辅助功能白名单中，需要先手动移除旧条目，才能为新版本重新授予权限。此外请确认客户端填写的服务器 IP 未因网络变化而失效，并检查防火墙是否放行了 Deskflow 的通信。

Deskflow 如何安装？ #

Windows #

1. 根据处理器架构下载对应的 MSI 安装包（win-x64 或 win-arm64）。
2. 先安装 Microsoft Visual C++ Redistributable（官方提供 vc_redist.x64.exe / vc_redist.arm64.exe），否则程序可能无法启动。
3. 双击 MSI 文件，按向导完成安装。
4. 系统要求：Windows 10 v1809 或更高版本。

macOS #

方式一（推荐，便于持续更新）：

1. 打开终端，执行 brew tap deskflow/tap 添加官方 tap。
2. 安装稳定版执行 brew install deskflow；安装持续构建版执行 brew install deskflow-dev。

方式二（手动安装 DMG）：

1. 下载对应架构的 DMG（Apple Silicon 选 arm64，Intel 选 x86_64）。
2. 打开 DMG 并把 Deskflow 拖入「应用程序」文件夹。
3. 若系统提示应用已损坏，执行 xattr -c /Applications/Deskflow.app。
4. 首次运行时，在「系统设置 → 隐私与安全性 → 辅助功能」中同时允许 Deskflow 应用与 deskflow 进程；macOS Sequoia 还需在「本地网络」中放行。
5. 系统要求：Apple Silicon 官方 CI 构建需 macOS 13 或更高；Intel 机型或本地自行构建需 macOS 12 或更高。

Linux #

1. 优先使用发行版包管理器安装 deskflow（各发行版打包情况可参考项目 README 中的 Repology 链接）。
2. 若发行版版本较旧、依赖不满足，改用 Flatpak 版本。
3. 依赖要求：服务端/客户端需要 libei 1.3+ 与 libportal 0.8+，图形界面需要 Qt 6.7+。
4. 也可以从源码自行编译，编译步骤见项目 Wiki 的 Building 页面。

Deskflow 如何卸载？ #

Windows #

1. 打开「设置 → 应用 → 已安装的应用」（或控制面板的「程序和功能」）。
2. 找到 Deskflow，选择卸载并按向导完成。
3. 如需彻底清理，可手动删除用户目录下残留的配置与日志文件夹；若不再需要，也可一并卸载此前为运行而安装的 Visual C++ Redistributable（其他软件可能仍在依赖它，请谨慎操作）。

macOS #

1. 若通过 Homebrew 安装：执行 brew uninstall deskflow（持续构建版为 brew uninstall deskflow-dev）。
2. 若为手动安装：打开「应用程序」文件夹，将 Deskflow 拖入废纸篓并清空。
3. 前往「系统设置 → 隐私与安全性 → 辅助功能」，手动移除 Deskflow 与 deskflow 的授权条目；在 Sequoia 上同时检查「本地网络」列表。
4. 如需清除个人配置，可手动删除用户资源库中与 Deskflow 相关的偏好设置与缓存文件。

Linux #

1. 使用包管理器卸载，例如 Debian/Ubuntu 系执行 sudo apt remove deskflow，Fedora 系执行 sudo dnf remove deskflow。
2. 若为 Flatpak 安装，执行 flatpak uninstall <应用 ID>。
3. 如需清理配置，可手动删除用户主目录下对应的配置与缓存目录。
4. 如果是源码编译安装，请在原构建目录中执行卸载命令或手动删除安装产物。