开源项目
OpenCCU/OpenCCU avatar
OpenCCU/OpenCCU

OpenCCU:把 Homematic IP 中枢从云里搬回本地,还给你备份自由

适用于 Homematic IP CCU (CCU3/ELV-Charly) 的基于 Buildroot 的无云智能家居平台。在 Raspberry Pi 和 x86/ARM 上运行或作为虚拟设备(Proxmox VE、Home Assistant、Docker/LXC/K8s)运行...

1,827 个 Star221 个 ForkJavaScriptApache-2.0

秒懂

它是什么?
OpenCCU 是基于 Buildroot 的免云 Homematic IP 中枢系统,兼容 CCU3 固件,可跑在树莓派、x86/ARM 或虚拟机里。本文拆解它的安装路径、备份互通机制和边界。
适合谁用?
OpenCCU 适合已经拥有 Homematic 或 Homematic IP 设备、不想被 eQ-3 云服务绑定,并且愿意自己维护一套 Linux 系统的用户。它不适合完全不想碰命令行、只想要开箱即用的人,也不适合对官方固件更新速度有硬性要求的场景。
能商用吗?
可以。Apache-2.0 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
还在维护吗?
在维护。仓库最近一次提交在 1 天前。
用什么语言写的?
主要是 JavaScript(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月14日)和我们的分析,不构成法律意见。

开源项目深度解析

它解决的是 Homematic 用户的云依赖问题

eQ-3 的 Homematic IP 生态本身是封闭的,官方 CCU3 是一台专用硬件,固件更新和备份都围绕它转。OpenCCU 的前身 RaspberryMatic 已经做了多年,现在的定位是提供一个与 CCU3 100% 兼容的开源固件,跑在树莓派、ODROID、Tinkerboard 或者任意 x86_64/aarch64 机器上。它不依赖任何云服务,所有设备通信和自动化逻辑都在本地完成。目标用户很明确:手里有一堆 Homematic 设备,但不想被官方硬件绑定,或者想把这套系统搬进虚拟机里统一管理的人。

从镜像到 WebUI:一条清晰的安装路径

安装方式分三种,覆盖了大多数场景。第一种是刷镜像,去 Releases 页面下载对应目标的 zip 文件,文件名格式是 OpenCCU-X.XX.XX.YYYYMMDD-<TARGET>.zip,解压后用 Etcher 或 dd 把 img 写到 microSD 卡。第二种是迁移,如果你已经有 CCU2 或 CCU3,直接把 OpenCCU 的固件包当作普通固件更新上传,官方升级路径被完整保留。第三种是虚拟化,Proxmox VE、VirtualBox、Docker、Kubernetes 都有对应的部署方式,README 里列出了 Synology VMM 和 QNAP Virtualization Station,说明这项目对 NAS 用户也有照顾。第一次启动时,系统会自动检测 GPIO 或 USB 上的 RF 模块,比如 RPI-RF-MOD 或 HmIP-RFUSB,然后你在浏览器里打开 http://openccu/ 就能进入熟悉的 CCU WebUI。整个过程不需要注册账号,不需要连外网。

备份互通是它最实在的卖点

README 明确写了备份是可互换的,这意味着你可以在官方 CCU3 和 OpenCCU 之间来回迁移,不用重新配对设备。这对实际使用很关键,因为 Homematic 设备配对涉及大量参数和房间分配,重来一遍是灾难。备份互通还意味着你可以先在虚拟机上试运行 OpenCCU,确认没问题后再把生产环境的备份恢复进去。反过来,如果 OpenCCU 出了你无法解决的问题,你也能带着备份退回官方固件。这个设计比很多开源替代品都务实,它不试图把你锁在自己的系统里。

增强功能与兼容性之间的平衡

OpenCCU 不是简单地把 CCU3 固件原样搬过来。README 提到它包含 WebUI 改进、Linux 系统更新、稳定性修复,以及上游还不存在的新功能。这意味着它在兼容官方生态的同时,也在尝试超越官方。但这里有个隐含的成本:任何偏离官方固件的行为都可能引入新的 bug,尤其是当 eQ-3 更新了设备协议或 WebUI 接口时,OpenCCU 需要跟上。项目发布节奏看起来挺快,最近一次是 3.89.8.20260719,说明维护活跃,但活跃不等于无风险。你在享受增强功能的同时,也得接受这些功能可能没有官方固件那么经过充分验证。

硬件要求比你想的更宽松

官方 CCU3 是一台专用设备,但 OpenCCU 把它拆开了。树莓派是常见选择,ODROID 和 Tinkerboard 2/2S 也在支持列表里,通用 x86_64 和 aarch64 硬件都能跑。这意味着你可以用一台旧 PC 或者一台迷你主机来当智能家居中枢,性能远超 CCU3 的原始硬件。虚拟化支持更是把灵活性拉满,Proxmox VE 和 QEMU/KVM 可以让你把中枢和其他服务跑在同一台服务器上,Docker 和 Kubernetes 则适合容器化部署。但要注意,RF 模块的检测依赖 GPIO 或 USB,如果你的硬件没有对应的模块接口,无线功能就用不了。这是硬件层面的硬约束,不是软件能解决的。

一个明显的限制:它只服务于 Homematic 生态

OpenCCU 不是通用智能家居平台,它只兼容 Homematic 和 Homematic IP 设备。如果你家里还有 Zigbee、Z-Wave 或者 Wi-Fi 设备,OpenCCU 不会帮你管理它们。这是它的边界,也是它的专注。相比之下,Home Assistant 是通用平台,支持几乎所有主流协议,但 Homematic 的集成深度通常不如原厂固件。OpenCCU 提供了一个有趣的折中:它作为 Home Assistant 的 App 存在,意味着你可以把 OpenCCU 当作 Homematic 的专用后端,然后通过 Home Assistant 统一管理其他设备。但这种组合增加了系统复杂度,不是每个人都需要。如果你只有 Homematic 设备,OpenCCU 单独用就够了。

替代方案:官方 CCU3 固件和 Home Assistant 集成

最直接的替代品是 eQ-3 官方 CCU3 固件,它跑在专用硬件上,稳定性有厂商保障,但你不自由,不能换硬件,也不能虚拟化。另一个选择是 Home Assistant 的 Homematic 集成,它不需要独立中枢,直接在 Home Assistant 里配对设备,但功能深度和 WebUI 体验通常不如 CCU3 完整。OpenCCU 的定位正好在两者之间:它保留了 CCU3 的完整 WebUI 和功能,同时让你自由选择硬件。如果你已经在用 Home Assistant,可以考虑把 OpenCCU 作为 add-on 跑在里面,这样既保留 Homematic 的原生体验,又不用单独维护一台机器。

维护成本与许可证现实

OpenCCU 采用 Apache-2.0 许可证,这意味着你可以自由使用、修改和分发,但要注意 README 里提到了商业分发有额外条款,具体细节在 wiki 的 License and Warranty 页面。维护成本方面,你需要自己管理操作系统更新和 OpenCCU 版本升级,不像官方 CCU3 那样有自动更新通道。发布频率看起来是每月一次左右,但这是社区驱动的,节奏可能变化。备份互通给了你一个安全网,但前提是你定期做备份并验证恢复流程。如果你不想承担这些运维工作,官方 CCU3 可能更省心,但你就得接受它的硬件锁定。

编辑结论

OpenCCU 适合已经拥有 Homematic 或 Homematic IP 设备、不想被 eQ-3 云服务绑定,并且愿意自己维护一套 Linux 系统的用户。它不适合完全不想碰命令行、只想要开箱即用的人,也不适合对官方固件更新速度有硬性要求的场景。动手前先确认三件事:你的 RF 模块是否在支持列表里(比如 RPI-RF-MOD 或 HmIP-RFUSB),你的备份是否来自 CCU3 或兼容固件,以及你能否接受 Apache-2.0 协议下社区维护的节奏。OpenCCU 的价值不在功能堆叠,而在把 CCU3 的软件层完整搬到通用硬件上,同时保留备份互通的逃生通道。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记