Lan-Mouse跨设备鼠标共享工具使用指南与常见问题解析

Lan-Mouse是一款开源的跨设备鼠标共享工具，允许用户在多台计算机间无缝共享鼠标和键盘输入。本文将深入介绍该工具的核心功能、配置方法以及实际使用中的注意事项。

基本工作原理

Lan-Mouse通过局域网建立设备间的连接通道，实现输入设备的共享。它采用客户端-服务器架构，每个设备既可以作为输入源(客户端)，也可以接收输入(服务器)。工具支持Wayland和X11显示服务器，在Hyprland等现代Wayland合成器上表现良好。

安装与启动

在NixOS系统上，用户可以直接通过nixpkgs安装0.10.0版本。启动方式有两种：

1. 图形界面模式：lan-mouse
2. 命令行模式：lan-mouse -f cli

基础配置方法

配置文件位于~/.config/lan-mouse/config.toml，采用TOML格式。每个需要连接的设备都需要在配置文件中添加一个客户端段：

[[clients]]
hostname = "设备名称"
ips = []
position = "right"  # 或"left"
activate_on_startup = true
enter_hook = "连接时执行的命令"

典型双设备配置示例

假设有两台设备：笔记本电脑和台式机，配置方法如下：

1. 笔记本电脑配置：

[[clients]]
hostname = "desktop"
position = "right"

2. 台式机配置：

[[clients]]
hostname = "laptop"
position = "left"

安全特性

最新版本引入了基于设备识别的加密认证机制，确保设备间通信的安全性。用户需要在首次连接时确认设备的识别信息。注意此功能目前仅在预发布版本中可用。

常见问题解决

1. 配置不持久化：当前稳定版本(0.10.0)存在配置保存问题，建议关注开发分支的更新或使用预发布版本。

2. 输入捕获问题：在Wayland环境下，若出现输入捕获失败，可尝试：

   • 确保安装了xdg-desktop-portal
   • 检查桌面环境是否支持input-capture-portal
   • 回退到layer-shell后端

3. 命令行参数变更：新版本调整了命令行语法，原lan-mouse cli已改为lan-mouse -f cli。

高级功能

1. 自定义释放快捷键：可通过配置修改释放鼠标的快捷键组合，默认是左Ctrl+左Shift+左Meta+左Alt。

2. 连接钩子：利用enter_hook参数设置连接时自动执行的命令，如切换工作区或通知提示。

3. 多设备拓扑：支持复杂设备排列，可配置上下左右多个方向的设备连接。

性能优化建议

1. 在低延迟要求的场景下，可尝试调整网络缓冲区大小
2. 对于高DPI设备，适当调整鼠标移动的灵敏度参数
3. 在多显示器环境中，确保各设备的屏幕布局配置一致

未来发展方向

根据项目动态，后续版本将重点改进：

1. 配置持久化机制
2. 更完善的Wayland支持
3. 简化的用户交互流程
4. 增强的错误处理和日志系统

通过合理配置和使用，Lan-Mouse能显著提升多设备工作环境的效率，特别适合开发者和多机用户群体。建议用户定期关注项目更新以获取最新功能和改进。