局域网键鼠共享+文件自动同步方案(Input Leap 与 Syncthing)
1. 前言与多跨平台协同的现实痛点
在 Mac+Linux 双机开发场景中,键鼠跨屏共享、文件实时同步是核心生产力诉求。业内老牌跨设备键鼠工具 Barrier 迭代为 InputLeap,凭借成熟的 C/S 架构成为跨系统键鼠联动的最优开源方案,适配多设备跨屏操控。而 Syncthing 作为轻量化 P2P 局域网同步工具,无需中转服务器、支持双向实时增量同步,完美适配双机开发文件互通需求。但 macOS 15(M1)严格的沙箱权限机制、Ubuntu 25.10 纯 Wayland 架构的底层革新,让两款工具常规图形化配置全部失效。本文摒弃GUI配置,全程使用纯命令行适配新系统架构,落地一套稳定可复刻的 InputLeap 键鼠共享 + Syncthing 全自动文件同步双机协同方案。
1.1 环境版本与技术栈拓扑
- 服务端(Server):MacBook Pro(Apple Silicon M1)/ macOS 15.x
- 客户端(Client):Ubuntu 25.10(纯 Wayland 架构、GNOME 桌面)
- 核心键鼠工具:Input Leap v3.0.x 跨平台编译开发版
- 文件同步工具:Syncthing(局域网 P2P 全双工实时同步)
2. 深度分步复刻配置指南
2.1 Mac 服务端(命令行部署)
2.1.1 系统权限放行(关键前置步骤)
打开 Mac 系统设置 → 隐私与安全性,完成两项核心权限配置:
- 辅助功能权限:添加并开启 InputLeap、Terminal(终端)/iTerm2。终端为进程拉起载体,必须授权才能操控鼠标键盘;若此前已添加,建议删除后重新添加,刷新系统权限缓存。
- 屏幕录制权限:为 InputLeap 开启权限,用于捕获屏幕坐标、实现跨屏指针定位。
2.1.2 手动创建最简网格配置文件
手动在软件默认检索路径创建配置文件,解决系统无法自动生成配置的问题,终端依次执行以下命令:
创建配置目录:
mkdir -p "$HOME/Library/Application Support/InputLeap"
新建并编辑配置文件:
nano "$HOME/Library/Application Support/InputLeap/input-leap.conf"
粘贴以下双机屏幕映射配置(可根据物理摆放位置调整左右方向):
section: screens
MacBookPro:
linux-INVALID:
end
section: links
MacBookPro:
left = linux-INVALID
linux-INVALID:
right = MacBookPro
end
配置释义:screens 定义双设备局域网别名;links 定义跨屏逻辑,Mac 鼠标向左滑动可无缝切入 Linux 屏幕右侧,物理摆放反向可互换 left/right 参数。
保存退出:Ctrl+O 回车保存,Ctrl+X 退出编辑器。
2.1.3 清理僵尸进程并启动服务端
先清理后台死锁、残留的僵尸进程,避免端口占用冲突:
pkill -f input-leap
加载配置、禁用加密、绑定端口,前台稳定启动服务端:
/Applications/InputLeap.app/Contents/MacOS/input-leaps -f --no-tray --debug INFO --disable-crypto -c "$HOME/Library/Application Support/InputLeap/input-leap.conf" --address :24800
启动成功标志:终端持续输出日志,最终停留 NOTE: ises: listening for connections,代表 24800 端口正常监听,等待客户端连接。
2.2 Ubuntu 25.10 客户端(Wayland 原生适配)
Ubuntu 纯 Wayland 环境必须启用 --use-ei 参数适配 Linux 原生输入基础设施 libei,保障键鼠操控丝滑稳定,同时匹配服务端关闭加密,终端执行以下命令(务必替换为 Mac 真实局域网 IP):
input-leapc -f --disable-crypto --use-ei --name linux-INVALID 192.168.43.78:24800
连接成功标志:Ubuntu 终端停止重试循环,Mac 服务端终端输出 NOTE: client "linux-INVALID" has connected,双机键鼠跨屏共享正式生效。
3. 全自动运维方案(一键启停 + 快捷访问)
为解决手动启停繁琐问题,适配 Ubuntu 桌面环境,搭建两套自动化方案,实现键鼠服务、文件同步一站式管控。
3.1 方案 A:桌面一键启停总控脚本
通过进程探测逻辑,实现单次双击启动服务、再次双击关闭服务的双向切换,同时联动 Syncthing 文件同步,附带系统通知提示。
- 桌面新建
toggle_tools.sh脚本文件,写入以下代码(注意IP和端口换一下):
#!/bin/bash
# 检测键鼠客户端进程是否运行
if pgrep -f input-leapc > /dev/null; then
# 终止所有服务进程
pkill -f input-leapc
pkill -f syncthing
# 发送关闭通知
notify-send "生产力总控" "🔴 已安全关闭 Syncthing 传输与局域网键鼠服务!"
else
# 后台启动文件同步服务,丢弃无关报错日志
syncthing > /dev/null 2>&1 &
sleep 0.5
# 后台启动局域网键鼠共享服务
input-leapc -f --disable-crypto --use-ei --name linux-INVALID 192.168.43.78:24800 &
# 发送启动通知
notify-send "生产力总控" "🟢 Syncthing 增量同步与局域网键鼠已在后台满血复活!"
fi
- 赋予脚本可执行权限:
```
chmod +x ~/Desktop/toggle_tools.sh
2. 双击运行适配配置:
打开 文件管理器 → 右上角菜单 → 首选项 → 可执行文本文件,设置为「运行它们」,后续双击脚本即可一键启停所有服务。
### 3.2:同步目录桌面快捷方式(软链接)
Ubuntu GNOME 桌面无图形化文件夹快捷方式创建选项,通过 Linux 底层软链接机制,生成桌面直达快捷方式,替换下方路径为你的 Syncthing 同步目录真实路径:
ln -s “/home/user/Your_Syncthing_Folder” ~/Desktop/同步盘直达
执行后桌面生成带标识的快捷方式,双击可直接通过系统文件管理器打开同步目录,实现跨平台文件快速访问。
## 4. 总结
本次方案核心破局思路:**摒弃图形界面依赖、回归底层命令行、适配新系统原生协议**。通过手动固化配置文件、启用 Wayland 原生 EI 输入管线、精简加密握手流程,完美解决 M1 Mac 与 Ubuntu 25.10 的兼容冲突。本方案稳定性不错。