Ubuntu系统下使用OpenRGB轻松控制电脑风扇与RGB灯效

小白也有IT梦

已于 2025-03-22 10:24:50 修改

阅读量562

点赞数 5

文章标签： Ubuntu OpenRGB 风扇控制 RGB灯效 Linux教程

于 2025-03-14 10:48:02 首次发布

本文链接：https://blog.csdn.net/i89211/article/details/146251732

版权

一、安装依赖

在终端中执行以下命令，安装所需的依赖包：

sudo apt update
sudo apt install git build-essential libusb-1.0-0-dev libhidapi-dev libgtk-3-dev
sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools libmbedtls-dev qttools5-dev-tools

这些依赖包括编译 OpenRGB 所需的工具和库，确保后续步骤顺利进行。

二、克隆并编译 OpenRGB

使用以下命令从 GitLab 仓库获取 OpenRGB 源码并进行编译：

git clone https://gitlab.com/CalcProgrammer1/OpenRGB
cd OpenRGB
qmake
make clean
make -j$(nproc)

git clone：克隆 OpenRGB 的源代码。
qmake：生成 Makefile 文件。
make clean：清理旧的编译文件。
make -j$(nproc)：使用所有 CPU 核心加速编译。

编译完成后，可执行文件 openrgb 会出现在当前目录下。

三、安装 udev 规则（以普通用户身份运行 OpenRGB）

OpenRGB 需要访问硬件设备（如 USB 或 I2C 接口）来控制 RGB 灯光和风扇。如果不配置 udev 规则，你需要以 root 权限运行（sudo ./openrgb），否则会遇到设备检测失败的问题。为了让普通用户也能正常使用 OpenRGB，需要安装 udev 规则。

下载 udev 规则文件
访问 OpenRGB 官网的 udev 规则页面：https://openrgb.org/udev，或者从 OpenRGB 源码仓库的 udev 文件夹中获取 60-openrgb.rules 文件。例如：
```
wget https://openrgb.org/releases/release_0.9/60-openrgb.rules
```
如果你已经克隆了 OpenRGB 仓库，规则文件通常位于 OpenRGB/udev/60-openrgb.rules。
安装 udev 规则(请先确认规则路径,后面有确认方法)
将下载的 60-openrgb.rules 文件复制到系统的 udev 规则目录：
```
sudo cp 60-openrgb.rules /etc/udev/rules.d/  # 确认规则路径再复制
sudo chmod 644 /etc/udev/rules.d/60-openrgb.rules
```
- /etc/udev/rules.d/ 是推荐的存放位置，优先级高于 /usr/lib/udev/rules.d/。
重新加载 udev 规则
安装后，重新加载规则并触发生效：
```
sudo udevadm control --reload-rules
sudo udevadm trigger
```

四、设置全局可执行路径（在任意目录运行 OpenRGB）

为了方便使用，可以将 openrgb 可执行文件设置为全局可执行，这样在任意目录下都可以直接运行 openrgb，无需每次进入编译目录。

复制可执行文件到全局路径
将编译生成的 openrgb 文件复制到 /usr/local/bin/：
```
sudo cp ~/OpenRGB/openrgb /usr/local/bin/
sudo chmod +x /usr/local/bin/openrgb
```
- /usr/local/bin/ 通常已在系统 PATH 中，复制到这里后即可全局访问。
验证全局执行
在任意目录下运行：
```
openrgb
```
如果成功启动，说明全局配置完成。

五、运行 OpenRGB 并测试

调试模式：如果遇到设备检测问题，可以使用详细模式查看日志：
```
openrgb --verbose
```
这会输出更多信息，帮助排查问题。

六、常见问题排查

找不到 udev 规则文件
如果你不确定 60-openrgb.rules 是否安装成功，可以用以下命令查找：
```
sudo find / -name "60-openrgb.rules" 2>/dev/null
```
- 正常情况下，文件应位于 /etc/udev/rules.d/60-openrgb.rules。
- 如果文件同时存在于 /etc/udev/rules.d/ 和 /usr/lib/udev/rules.d/，可能会导致冲突。建议删除 /usr/lib/udev/rules.d/60-openrgb.rules：
```
sudo rm /usr/lib/udev/rules.d/60-openrgb.rules
sudo udevadm control --reload-rules
sudo udevadm trigger
```
设备无法检测
- 确保你的设备在 OpenRGB 支持列表中：https://openrgb.org/devices.html。
- 检查用户组权限是否正确（见步骤三）。
- 如果问题仍未解决，尝试以 root 权限运行一次，排除权限问题：
```
sudo openrgb
```

七、注意事项

硬件支持：请确认你的风扇和 RGB 设备在 OpenRGB 支持列表中，避免兼容性问题。
定期更新：OpenRGB 不断更新设备支持，建议定期从 GitLab 仓库拉取最新代码重新编译：
```
cd ~/OpenRGB
git pull
make clean && make -j$(nproc)
sudo cp openrgb /usr/local/bin/
```
包管理器安装用户：如果你通过 apt 或其他包管理器安装了 OpenRGB，可能会在 /usr/lib/udev/rules.d/ 自动安装 udev 规则，与手动安装的规则冲突，请注意检查。