一套键鼠控制多台电脑：Input Leap 跨设备输入共享指南

一套键鼠控制多台电脑：Input Leap 跨设备输入共享指南

【免费下载链接】input-leap Open-source KVM software 项目地址: https://gitcode.com/gh_mirrors/in/input-leap

你的鼠标从 Windows 屏幕右缘滑出，下一秒光标就出现在旁边的 MacBook 上。这套跨设备输入共享叫 Input Leap：纯软件实现，一台服务器接键盘鼠标，其余机器作为客户端加入，同一局域网内即用。

它到底是什么 & 和传统方案的差异

Input Leap 是一个开源、跨平台的 KVM 切换器软件实现，支持 Windows、macOS、Linux、FreeBSD、OpenBSD。它和传统方式的区别：

• 硬件 KVM 靠物理拨动切换，且需要购买切换器；Input Leap 完全靠软件，把鼠标移到屏幕边缘即可跨机
• 硬件方案通常绑定同一厂商接口，Input Leap 横跨 Windows / macOS / Linux，客户端各自按原生方式模拟输入
• 屏幕拓扑由配置文件定义，左右、上下、角落触发都能自定义
• 剪贴板随鼠标焦点跨机传递，Linux/Wayland 端暂不支持
• 项目定位克制：不做团队协同那类扩展，只做"一套键鼠控制多台机器"这件事并保证稳定

最小可用配置：从 clone 到鼠标跨屏

编译安装。仓库自带 CMake 构建脚本：

git clone https://gitcode.com/gh_mirrors/in/input-leap
cd input-leap
mkdir build && cd build
cmake ..
make -j$(nproc)

分配角色。接物理键盘鼠标的那台机器当 server，被控制的机器当 client。

启动 server。GUI 里选 server 模式，点 "Configure server"，把每台客户端拖进网格，按真实物理位置摆放。

启动 client。在客户端填入服务器 IP 后启动。

⚠️ 容易踩的点：屏幕名（screen name）必须两端完全一致，且大小写敏感——客户端窗口里、服务器 IP 上方会显示它自己的屏幕名。

两端都出现 "Input Leap is running" 后，把鼠标移出屏幕边缘就能跨界。

用配置文件定义你的桌面拓扑

角色分配逻辑只有一条：谁接物理键鼠，谁是 server；其余机器都是 client，填 server 的 IP 加入。

配置文件由 screens / links 两段组成，以三台机器为例：

section: screens
	WindowsPC:
	MacBook:
	LinuxServer:
end
section: links
	WindowsPC:
		right = MacBook
	MacBook:
		left = WindowsPC
		right = LinuxServer
	LinuxServer:
		left = MacBook
end

白话解读：screens 段声明三台机器的屏幕名，links 段按物理布局声明相邻关系——鼠标从 WindowsPC 右缘滑出就进 MacBook，再往右就进 LinuxServer。

网络前提：server 默认监听 24800 端口，所有机器需在同一局域网；防火墙要放行该端口的入站 TCP 流量。更细的写法（含区域坐标、别名映射）见 doc/input-leap.conf.example-advanced。

三类典型用法

全栈开发。Windows 主屏写代码、macOS 测试 UI、Linux 部署调试，三机横排。配置思路：links 段按实际摆放声明 left/right 即可。tip：键盘输入始终跟随鼠标焦点，切机时不用先"对准"哪台机器。

设计 + 预览。主屏做设计、旁侧设备看真机效果。配置思路：把预览设备放在主屏上方，用 top = xxx 声明。tip：在 options 段设置 switchCornerSize，只留屏幕边缘一小块触发区，精修时鼠标贴边也不会误切。

批量设备管理。测试环境里多机共用一套键鼠。配置思路：GUI 网格拖入多个 client 屏幕，或参照 doc/input-leap.conf.example-advanced 用 aliases 段把真实 hostname 映射成短名字，配置可读性高很多。

踩坑速查

症状	原因	解法
client 连不上 server	不在同一网段，或 24800 端口被拦	ping 通后再查防火墙，放行入站 TCP 24800
配置了却连不上	屏幕名两端不一致	以客户端窗口显示的屏幕名为准，注意大小写
鼠标跨界不流畅	Wi-Fi 延迟高	优先有线，减少同网段其他流量
精修时误切换	鼠标贴到屏幕边缘	设置 switchCornerSize 缩小角落触发区
鼠标完全不能跨界	Scroll Lock 亮着	关掉 Scroll Lock

已知限制：Linux/Wayland 端不支持剪贴板共享；server 在 Linux、client 在 Windows 时 AltGr 组合键默认不工作，需查 issue 跟踪的 workaround。

代码里看它

分层很直白：src/lib/server/ 解析配置、管理连接、把本地输入打包发送；src/lib/client/ 接收包并模拟键鼠事件；src/lib/platform/ 是平台适配层，按 Windows / macOS / X11 分目录封装屏幕、剪贴板、键盘状态等系统差异；src/gui/ 的 GUI 通过 IPC 驱动后台进程，不在数据路径上。

下一步 & 资源

• 配置示例：doc/input-leap.conf.example-basic，从最简两机配法逐步加复杂
• README.md 的 FAQ 覆盖开机自启加载配置、client 服务器 IP 留空等高频问题
• 支持渠道：LiberaChat IRC 的 #inputleap，bug 请走 issue 跟踪器

改一行配置，试一次鼠标跨界，比读十篇评测都直观。

【免费下载链接】input-leap Open-source KVM software 项目地址: https://gitcode.com/gh_mirrors/in/input-leap