安装 – OpenLogi Docs

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

支持 macOS、Linux 与 Windows。

安装或启动 OpenLogi 前请先退出 Logi Options+

两者会争夺 HID++ 访问权，同一时间只能有一个程序占用接收器。在 Linux 上，Solaar 同理。

macOS

需要 macOS 13 或更高版本。

brew install --cask openlogi

官方 cask 是默认安装方式。若希望跟随最新的 GitHub 发行版：

brew tap aprilnea/tap
brew install --cask aprilnea/tap/openlogi@latest

openlogi 与 openlogi@latest 二者选其一，不要同时安装

下载发行版

下载已签名并公证的 DMG 安装包：Apple 芯片或 Intel。

安装应用

打开下载的 DMG 安装包，把 OpenLogi.app 拖到 /Applications。

启动并授予权限

打包版应用会通过 macOS 已注册的登录项服务启动内嵌的 OpenLogi Agent。这个后台辅助进程负责 HID 访问与事件钩子，GUI 则通过本地 IPC 与它通信。

首次启动时，请按应用内的权限引导操作。输入监控与辅助功能应授予 OpenLogi Agent，而不是 OpenLogi GUI：前者让代理能够打开设备，后者用于按键重映射。摄像头预览所需的 摄像头权限则属于 OpenLogi GUI。可在设置 → 权限中查看代理当前报告的状态。

Linux

安装包同时提供 x86_64/amd64 与 arm64/aarch64。预构建安装包要求 GLIBC 2.35 或更高版本，基线为 Ubuntu 22.04。NixOS 用户请使用下方的 NixOS 模块。

验签安装器

先通过发行版的包管理器安装 minisign。请以普通用户运行安装器，不要用 sudo 运行整个脚本。通过 HTTPS 将脚本下载到文件，审阅后再执行，不要将下载内容直接通过管道传给 shell：

curl --proto '=https' --proto-redir '=https' --tlsv1.2 \
  --fail --location --silent --show-error \
  --retry 3 --retry-connrefused \
  --output openlogi-install.sh \
  https://raw.githubusercontent.com/AprilNEA/OpenLogi/master/packaging/linux/install.sh
less openlogi-install.sh
sh openlogi-install.sh

安装器默认选择最新的 GitHub 发行版，检测处理器架构与 apt、dnf、yum、zypper、rpm 或 pacman，并下载匹配的安装包。安装器会使用脚本内嵌的 minisign 公钥验证安装包的分离签名，并核对 SHA256SUMS 中对应条目的校验和，全部通过后才通过 sudo 调用包管理器。

如果系统提供 systemd，安装器会为当前用户启用并启动 openlogi-agent.service。如果无法连接用户服务管理器，已安装的软件包会保留，安装器会报告代理未能启动。

可按需在 sh openlogi-install.sh 后添加以下选项：

选项	作用
`--version 0.8.11`	安装指定发行版。
`--package-manager zypper`	指定包管理器，覆盖自动检测结果。
`--dry-run`	下载并验证安装包，不安装或启动代理。
`--no-start`	安装软件包，不启用或启动代理。

手动安装软件包

下载适合你发行版的安装包：

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

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

# Arch Linux
sudo pacman -U openlogi-*.pkg.tar.zst

直链：.deb · .rpm · .pkg.tar.zst。

手动安装软件包后，为当前用户启用后台代理：

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

安装包会写入 udev 规则，让你的用户无需 sudo 即可访问 /dev/hidraw*（HID++ 命令）、/dev/uinput（用于重映射的虚拟输入设备）以及罗技鼠标的 /dev/input/event* 节点。

如果安装 udev 规则时设备已经插着，请拔插接收器（或让无线设备重新上电），让新规则生效。GUI 的设置 → 权限页面会实时显示访问状态。

NixOS

请优先导入仓库提供的 NixOS 模块，而不是只把软件包加入系统。该模块会安装 OpenLogi 与 udev 规则，并默认随图形会话启动用户代理。把以下内容合并到已有 flake，并保留主机的硬件和系统配置模块：

{
  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
  inputs.openlogi.url = "github:AprilNEA/OpenLogi";
  inputs.openlogi.inputs.nixpkgs.follows = "nixpkgs";

  outputs = { nixpkgs, openlogi, ... }: {
    nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux"; # 或 aarch64-linux
      modules = [
        openlogi.nixosModules.default
        { programs.openlogi.enable = true; }
      ];
    };
  };
}

完整的 flake 示例与 launchAtLogin 选项见 INSTALL-linux.md。

源码安装以及没有 systemd 的发行版，请见 INSTALL-linux.md。

安装