安装 – OpenLogi Docs

介绍如何通过 Homebrew、包管理器或直接下载在 macOS、Linux 或 Windows 上安装 OpenLogi。

支持 macOS 与 Linux。Windows 处于未经测试的早期预览阶段——每个发行版都附带签名构建（参见路线图）。

安装或启动 OpenLogi 前请先退出 Logi Options+——两者会争夺 HID++ 访问权，同一时间只能有一个占用接收器。在 Linux 上，Solaar 同理。

macOS

brew install --cask openlogi

下载已经签名并公证的 .dmg：Apple 芯片或 Intel。

打开 .dmg，将 OpenLogi.app 拖入 /Applications。

首次启动时，macOS 可能要求你确认该应用，并授予辅助功能（Accessibility） / 输入监控（Input Monitoring） 权限——通过操作系统事件钩子重映射按键时需要。

下载 .deb 或 .rpm——安装包同时提供 x86_64/amd64 与 arm64/aarch64 两种架构：

# Debian / Ubuntu
sudo dpkg -i openlogi_*.deb

# Fedora / RHEL
sudo rpm -i openlogi-*.rpm

安装包会写入 udev 规则，让你的用户无需 sudo 即可访问 /dev/hidraw*（HID++ 命令）与 /dev/uinput（虚拟重映射设备）。然后为当前用户启用后台 agent：

systemctl --user enable --now openlogi-agent.service

如果安装 udev 规则时设备已经插着，请拔下并重新插入接收器（或重启设备电源），让新规则生效。GUI 的 设置 → 权限 页面有实时的访问状态指示。

手动 / 源码安装以及无 systemd 的发行版，参见 INSTALL-linux.md。

下载签名 .msi 安装包：x86_64 或 arm64。每个发行版还附带便携式 .zip 构建。Windows 支持仍处于早期预览，尚未在真实硬件上充分测试——请预期一些粗糙之处，并欢迎反馈问题。

参见仓库中的 DEVELOPMENT.md。