ARGB

Music Sync RGB Lights
Language English
Beginner 12 min read March 15, 2026

OpenRGB 安装配置教程及常见问题

从零开始安装 OpenRGB，配置 SMBus 访问，检测设备并解决常见问题。

#OpenRGB #安装 #配置 #教程 #开源

OpenRGB 简介

OpenRGB 是开源社区开发的 RGB 统一控制软件，GPL v2 协议，支持 Windows、Linux 和 macOS。它是 Skydimo 的基础核心库。

安装步骤（Windows）

1. 下载

访问 openrgb.org 下载最新稳定版，选择：

  • OpenRGB_x.x_Windows_64_xxxx.zip（便携版，推荐）
  • 或 .msi 安装包

2. 解压并运行

便携版无需安装，解压后直接运行 OpenRGB.exe（需以管理员身份）。

3. 安装 USB 驱动（关键步骤）

OpenRGB 需要替换部分 USB 设备驱动才能访问：

  1. 工具栏 → Settings → USB Devices
  2. 找到你的 RGB 设备
  3. 点击 “Install Driver”（安装 WinUSB 驱动）

⚠️ 安装后该设备将无法被原厂软件（iCUE/Synapse）识别，如需恢复，用设备管理器更新驱动。

安装步骤（Linux）

解决 SMBus 权限问题

Linux 下访问 SMBus 需要特殊权限：

# 方法一：添加 udev 规则（推荐）
sudo nano /etc/udev/rules.d/60-openrgb.rules

# 写入以下内容：
SUBSYSTEM=="usb", MODE="0666"
KERNEL=="i2c-[0-9]*", GROUP="i2c", MODE="0660"

# 保存后重载规则
sudo udevadm control --reload-rules
sudo udevadm trigger

# 将当前用户加入 i2c 组
sudo usermod -a -G i2c $USER
# 方法二：以 root 运行（不推荐生产环境）
sudo ./openrgb

加载 i2c 内核模块

# 临时加载
sudo modprobe i2c-dev

# 开机自动加载
echo "i2c-dev" | sudo tee /etc/modules-load.d/i2c-dev.conf

首次使用配置

扫描设备

  1. 点击 **“Detect Devices”（检测设备）**按钮
  2. 等待扫描完成（可能需要 5-15 秒）
  3. 设备将出现在左侧列表

设置颜色

  1. 选择设备
  2. 右侧选择效果（Static、Breathing、Rainbow Wave 等）
  3. 选择颜色并点击应用

保存配置

  1. 点击 Profiles 标签
  2. 点击 + 创建新 Profile
  3. 命名并保存

使用 OpenRGB 服务器模式

OpenRGB 可以作为服务器运行，允许其他软件通过网络控制设备：

# 启动服务器模式（默认端口 6742）
openrgb --server

# 指定端口
openrgb --server --port 1234

Skydimo 可以通过 OpenRGB 协议连接到远程 OpenRGB 实例，控制另一台电脑上的 RGB 设备。

常见问题

Q: 主板设备检测不到

解决：

  1. 确认 BIOS 中 RGB 控制已启用
  2. 检查是否已加载 i2c-dev 模块（Linux）
  3. 以管理员权限运行（Windows）
  4. 参考 OpenRGB 支持设备列表 确认你的设备已支持

Q: 设备显示但颜色不正确

可能是不同品牌的 LED 顺序（RGB vs GRB vs BGR）不同：

Settings → Device → Color Order
尝试切换 RGB / GRB / BGR

Q: 如何从 OpenRGB 迁移到 Skydimo？

直接安装 Skydimo，它基于 OpenRGB 核心，所有 OpenRGB 支持的设备都可以在 Skydimo 中使用，无需额外配置。