用一套键盘鼠标控 3 台电脑：Input Leap 完整实操指南-平芜编程栈

用一套键盘鼠标控 3 台电脑：Input Leap 完整实操指南

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

Input Leap 是一款免费开源的 KVM 软件（KVM 切换器原本是一台硬件设备，负责把一套键鼠在多台电脑间切换）。装好之后，鼠标划到屏幕边缘就切到隔壁电脑，键盘输入跟着走，跨设备复制粘贴也能用。

30 秒认识它

Input Leap 是 Barrier 项目的活跃分支，由原 barrier 维护者继续开发，目标是把"多机共享键鼠"这件小事做稳。它用软件模拟了物理 KVM 切换器：不用再拧盒子上的旋钮，而是把鼠标移到屏幕边缘来切换控制对象。

对比项	硬件 KVM	Input Leap
硬件成本	几百到几千元	0
平台覆盖	只认接口	Windows / macOS / Linux / BSD
维护成本	设备老化要换	软件更新即可

从零到跑通：装、配、连三步走

第一步：每台电脑都装一份

所有要共享键鼠的机器上都要装 Input Leap——服务器和客户端都装，缺一不可。

普通用户直接下载官方对应平台的安装包
源码构建的话，仓库克隆下来后执行：

git clone https://gitcode.com/gh_mirrors/in/input-leap cd input-leap && mkdir build && cd build && cmake .. && make

第二步：选角色，定布局

有键盘鼠标的那台是服务器（input-leaps）
其余是客户端（input-leapc）

图形界面里点 "Configure server"，把每台客户端拖进网格，像摆积木一样对齐真实桌面位置。也可以直接写配置文件，项目自带了最小化配置示例可参考。两台电脑左右相邻时，配置可以短成这样（把两行名字换成你 GUI 里显示的实际屏幕名，区分大小写）：

section: screens screen.name.server: screen.name.client: end section: links screen.name.server: left = screen.name.client screen.name.client: right = screen.name.server end

第三步：填地址，启动

客户端输入服务器的 IP 地址后点启动；局域网内也可以让 Bonjour 自动发现。两边都显示Input Leap is running后，把鼠标顶到服务器屏幕的左边缘——光标就会掉进客户端的屏幕里。

防火墙放行24800 端口（代码里定义在 protocol_types.h），这是连接失败时最常见的拦路虎。

划到屏边就切屏：鼠标越界切换怎么用

它做了什么：服务器监控光标位置，一旦顶到配置里声明的相邻边（left/right/top/bottom），就把鼠标焦点整包丢给对应客户端，键盘输入也跟着过去。

你怎么用：把鼠标顶到屏幕最左/右/上/下边缘并停顿一小会儿即可切换。配置里每块屏可以声明多个方向，比如中间那台既能 left 也能 right 切，就形成一条链。切回服务器同理，反向再顶一次边。

边界在哪：

键盘Scroll Lock 亮着时会禁用切屏（这是故意留的锁定开关），卡住时先按一下
同一时刻只能有一台机器"有焦点"，不存在鼠标同时在两块屏上的状态
切换依赖配置里 edges 的方向声明，方向写反就"该切的时候切不过去"

复制粘贴跨设备：剪贴板共享的边界

它做了什么：在一台机器上 Ctrl/Cmd+C 的内容，会自动同步到其余机器的剪贴板缓冲区，到任何一台机器上直接粘贴就行。

你怎么用：不用任何开关，复制即同步。适合把一段代码从 Mac 粘到 Windows 编译、把一段文案从开发机粘到办公机这类操作。

边界在哪：

Linux/Wayland 暂不支持剪贴板共享，X11 环境正常
拖放（把文件从 A 拖到 B）在 Linux 上目前不支持，官方 FAQ 里明确写了
Windows ↔ macOS、Windows ↔ X11 Linux 这类组合是当前最稳的

谁在用、怎么用

双机开发者。以前写代码在 Linux 开发机，跑前端要切到 Windows 虚拟机，每次都要拔插键鼠、等输入焦点回来。现在鼠标右滑进 Windows 屏幕，同一套键盘继续敲，上下文不中断。省下来的是"重新找键盘"这 3 秒 × 一天几十次的烦躁。

设计师跨平台出图。设计稿在 Mac 上做，需要在 Windows 上打开 PS 微调或导出版本。以前复制一段备注文字要开个网盘或聊天窗口中转，现在 Cmd+C 完右滑到 Windows 屏，Ctrl+V 直接落在 PS 里。省掉了中间那一步。

家庭办公角。一台台式机加一台笔记本，共用桌上一套键鼠。谁用谁把鼠标顶过去就行，不用再为笔记本单独买一套外设，桌面也少了几个接收器和转接头。

踩坑与自救

现象：鼠标到边缘切不过去。原因：多半是 Scroll Lock 被误开，它就是这个功能的总开关；其次是配置里左右方向写反。解法：按一下 Scroll Lock 灭灯；仍不行就检查 links 段，把left和right对调，重新加载配置。

现象：连接建立后频繁掉线。原因：防火墙拦了 24800，或 Wi-Fi 漫游导致 IP 漂移。解法：两台机器都放行 24800 端口；能走有线就不走 Wi-Fi；客户端连不上时手动填服务器 IP（配置里serverhostname=AAA.BBB.CCC.DDD），不要依赖自动发现。

现象：客户端 Server IP 字段是空的。原因：自动发现没探到服务器。解法：在服务器配置文件的 options 段里手写一行serverhostname=，重启客户端。

现象：Linux 服务器 → Windows 客户端，AltGr 组合键失灵。原因：两个平台对 AltGr 的编码不一致，开箱默认不通。解法：参考项目 wiki 里 issue #100 的 workaround，改服务器配置里的键位映射；简单场景可临时改用 Win+ 组合绕过。

现象：非英文输入法粘贴乱码。原因：当前版本 UTF-8 支持有限，多语言字符有已知问题（issue #860）。解法：先确认两台系统语言环境一致；仍乱码就先走纯 ASCII 通道（纯代码、纯英文文本）。

架构一瞥

代码按职责切成几块，各管一摊：核心协议与客户端/服务端逻辑在 src/lib/inputleap/，网络与加密层在 src/lib/net/（SSL 验证、指纹都在这里），Windows / macOS / X11 各自的输入输出适配集中在 src/lib/platform/。换平台就是换 platform 下对应那套实现，其余代码不动。GUI 在 src/gui/src/，想改界面不用碰核心。