Linux 系统下 Logitech MX Master 鼠标配置指南

安装 logiops（推荐）

Ubuntu/Debian：

sudo add-apt-repository ppa:patrick-fork/logiops
sudo apt update && sudo apt install -y logiops

Arch Linux：

yay -S logiops-git

实现精准滚动调节：配置基础功能参数

创建配置文件

logiops 的核心配置文件位于 /etc/logid.cfg，使用以下命令创建并编辑：

sudo nano /etc/logid.cfg

基础滚动配置示例

{
  "devices": [
    {
      "name": "Logitech MX Master 3",
      "smartshift": { "on": true, "threshold": 15 },
      "dpi": 1600,
      "scroll": { "natural_scroll": false, "invert": false, "hires": true }
    }
  ]
}

重启服务使配置生效

sudo systemctl restart logid

小贴士：smartshift 阈值建议设置在 10-20 之间，数值越小，切换到自由滚动所需的速度越低。对于办公场景，15 是兼顾精确控制和快速滚动的理想值。

构建手势操作矩阵：定制高级功能

配置 thumb button 按键功能

编辑配置文件，添加按键映射：

{
  "buttons": {
    "5": { "action": "Gestures" },
    "gestures": {
      "thumbwheel": {
        "up": { "action": "Keypress", "keys": ["KEY_VOLUMEUP"] },
        "down": { "action": "Keypress", "keys": ["KEY_VOLUMEDOWN"] }
      },
      "thumbbutton": {
        "click": { "action": "Keypress", "keys": ["KEY_SUPER"] },
        "hold": {
          "action": "Gestures",
          "gestures": {
            "up": { "action": "Keypress", "keys": ["KEY_PAGEUP"] },
            "down": { "action": "Keypress", "keys": ["KEY_PAGEDOWN"] },
            "left": { "action": "Keypress", "keys": ["KEY_LEFTMETA", "KEY_LEFT"] },
            "right": { "action": "Keypress", "keys": ["KEY_LEFTMETA", "KEY_RIGHT"] }
          }
        }
      }
    }
  }
}

配置文件参数详解

logiops 配置文件支持丰富的参数设置，以下是常用参数说明：

• dpi：设置鼠标分辨率，MX Master 支持 200-4000 DPI
• smartshift：智能滚动切换功能
  • on：启用/禁用智能滚动
  • threshold：切换阈值（1-100）
• scroll：滚动行为设置
  • natural_scroll：自然滚动方向
  • hires：启用高精度滚动
• buttons：按键映射配置
  • action：可设置为"Keypress"、"Gestures"、"None"等
  • keys：指定按键组合，使用 Linux 内核按键名称

多设备切换技巧：无缝跨设备工作流

MX Master 的多设备切换功能在 Linux 下可通过 logiops 实现：

{
  "devices": [
    { "name": "Logitech MX Master 3", "device": "/dev/hidraw0" },
    { "name": "Logitech MX Master 3", "device": "/dev/hidraw1" }
  ]
}

切换设备的快捷键可自定义：

# 安装 xdotool 用于模拟按键
sudo apt install xdotool
# 创建切换脚本
cat > ~/switch-mx-device.sh << 'EOF'
#!/bin/bash
# 切换到设备 1
xdotool key --clearmodifiers "ctrl+alt+1"
EOF
chmod +x ~/switch-mx-device.sh

跨系统配置同步：保持工作环境一致性

使用 Git 同步配置文件：

# 初始化配置仓库
mkdir -p ~/.config/mx-master-config
cd ~/.config/mx-master-config
git init
# 复制配置文件
cp /etc/logid.cfg .
# 创建同步脚本
cat > sync-config.sh << 'EOF'
#!/bin/bash
sudo cp ~/.config/mx-master-config/logid.cfg /etc/
sudo systemctl restart logid
EOF
chmod +x sync-config.sh

场景化配置方案：游戏优化模式

为游戏场景创建专用配置文件：

{
  "devices": [
    {
      "name": "Logitech MX Master 3",
      "dpi": 3200,
      "smartshift": { "on": false },
      "scroll": { "hires": false, "invert": true },
      "buttons": {
        "4": { "action": "Keypress", "keys": ["KEY_5"] },
        "5": { "action": "Keypress", "keys": ["KEY_6"] }
      }
    }
  ]
}

创建切换脚本：

cat > ~/switch-to-gaming-mode.sh << 'EOF'
#!/bin/bash
sudo cp ~/.config/mx-master-config/logid-gaming.cfg /etc/logid.cfg
sudo systemctl restart logid
echo "Switched to gaming mode"
EOF
chmod +x ~/switch-to-gaming-mode.sh

创意工作流配置：设计师专用设置

为创意工作设计的配置：

{
  "devices": [
    {
      "name": "Logitech MX Master 3",
      "dpi": 1200,
      "scroll": { "natural_scroll": true, "hires": true },
      "buttons": {
        "5": {
          "action": "Gestures",
          "gestures": {
            "thumbwheel": {
              "up": { "action": "Keypress", "keys": ["KEY_CTRL", "KEY_PLUS"] },
              "down": { "action": "Keypress", "keys": ["KEY_CTRL", "KEY_MINUS"] }
            }
          }
        }
      }
    }
  ]
}

兼容性测试报告

我们在主流 Linux 发行版上测试了 MX Master 系列鼠标的功能支持情况：

故障排除：症状 - 原因 - 解决步骤

症状：鼠标连接后频繁断开

可能原因：

• 蓝牙信号干扰
• 电源管理设置导致蓝牙休眠
• 蓝牙驱动版本过旧

解决步骤：

1. 检查并移除附近的蓝牙干扰源
2. 禁用蓝牙电源管理：

sudo nano /etc/udev/rules.d/50-bluetooth-power.rules

添加以下内容：

ACTION=="add", SUBSYSTEM=="bluetooth", KERNEL=="hci0", RUN+="/bin/sh -c 'echo 0 > /sys/class/bluetooth/hci0/device/power/control'"

3. 更新蓝牙驱动：

# Ubuntu/Debian
sudo apt install --reinstall bluez
# Arch Linux
sudo pacman -Syu bluez

症状：自定义按键无响应

可能原因：

• logiops 服务未运行
• 配置文件语法错误
• 设备名称不匹配

解决步骤：

1. 检查 logiops 服务状态：

sudo systemctl status logid

2. 验证配置文件语法：

jsonlint /etc/logid.cfg

3. 确认设备名称是否正确：

logid -v

查看输出中的设备名称，确保与配置文件中的名称一致。