
30 秒速读
手里的 Harmony 遥控器还能用,家里的灯、电视、音响也都连着它,偏偏原厂云服务一变,整套遥控就有停摆的风险。换一套新系统要重新配设备、重新教家人,成本一点也不低。本篇讲 harmony-ng:给 Logitech Harmony 设备做的开源本地控制固件,让兼容的 Harmony Hub 或 Elite 950 不再依赖原厂云,在自家局域网里继续遥控和接入自动化。它不是一个手机遥控皮肤,而是一套可以本地跑起来的控制方案,适合愿意自己动手维护的人先评估。
项目信息一览
| 项目 | 说明 |
|---|---|
| 项目名称 | harmony-ng |
| 适用设备 | Harmony Hub、Harmony Elite 950 及对应 Remote 型号 |
| 核心定位 | 开源本地控制固件与配套套件,恢复离线遥控与智能家居控制 |
| 控制入口 | Hub 内置 Web UI,通过 8089 端口在本地访问 |
| 程序接口 | REST 与 WebSocket,附带 OpenAPI 3.1 规范与接口文档 |
| 配套应用 | Android Companion App,要求 Android 10 或更高版本 |
| 遥控器界面 | Elite 950 使用 240×320、RGB565 格式的实时原生帧缓冲界面 |
| 安装方式 | 提供预构建发布包、部署脚本与安装指南,常规安装不要求自行编译 |
| 网络连接 | Pro 2400 可用板载 RJ45 或 PoE,标准 Hub 可配合 OTG Micro-USB 以太网适配器 |
它到底解决什么问题
很多人留着 Harmony,并不是舍不得一个遥控器,而是舍不得已经配好的整套联动:按一个键,电视、功放、灯光按顺序动作。云服务一旦不可用,这些联动就跟着断,遥控器本身硬件明明还好好的。harmony-ng 的思路是把控制权收回本地:Hub 上跑原生守护进程,对外提供 Web UI 和程序接口,遥控器、手机应用和自动化脚本都走局域网,不再经过原厂云中转。
- Hub 端:以 C 编写的原生守护进程,提供本地 Web UI、REST 接口与 WebSocket 接口。
- 手机端:Android Companion App,可作为随身的本地控制入口。
- 遥控器端:Elite 950 跑实时原生帧缓冲界面,界面直接画在设备屏幕上。
- 自动化端:REST 与 WebSocket 加 OpenAPI 3.1 文档,方便写脚本或接自建控制面板。
- 部署端:预构建发布包里包含二进制文件、模块、脚本与部署工具,省去自行编译的步骤。
这套分工的好处是各取所需:日常家人用遥控器或手机,喜欢折腾的人可以写脚本把 Hub 接进自己的自动化系统。但前提也要说清楚,它面向的是愿意自己维护本地服务的人,而不是插上电就能用的消费级产品。
上手指南
动手之前先把型号这件事做实,型号不对,后面每一步都可能白费。下面是按项目说明整理的关键步骤,只写容易踩坑的环节,不罗列一路下一步的废话。
- 核对型号:先确认现有设备是否属于项目说明里列出的 Harmony Hub Standard、Pro 2400、Harmony Elite 950 或对应 Remote 型号,型号不在清单里就不要硬套安装流程。
- 读对应安装指南:Hub 与遥控器的安装路径不同,动手前完整读一遍对应设备的指南,尤其注意备份与恢复那一节。
- 准备硬件:准备一台 Windows、macOS 或 Linux 电脑,外加一根 Micro-USB 数据线;标准 Hub 若要走有线网络,还要准备 OTG Micro-USB 以太网适配器。
- 用预构建包安装:按指南使用预构建发布包与部署脚本完成安装,常规流程不需要自己编译固件。
- 打开本地 Web UI:在浏览器里访问 Hub 的 8089 端口,确认 Web UI 能打开、设备状态正常,再往下接其他控制方式。
- 接自动化再对照文档:需要程序化控制时,对照 OpenAPI 3.1 规范确认你要的操作是否在接口覆盖范围内,不要凭猜测拼接口。
- 装手机应用:Android 手机需为 Android 10 或更高版本,再安装 Companion App 并在局域网内完成连接验证。
取舍:适合谁,不适合谁
| 情况 | 结论 | 理由 |
|---|---|---|
| 已有 Harmony Hub 或 Elite 950,想摆脱原厂云依赖 | 值得评估 | 本地 Web UI、REST 与 WebSocket 覆盖了日常遥控与自动化两种用法 |
| 家里已有自建自动化系统,想把遥控接进去 | 适合 | OpenAPI 3.1 文档在手,脚本化控制有可核验的入口 |
| 不愿刷机、不愿处理设备恢复问题 | 不适合 | 刷写自定义固件本身就有成本,升级与故障处理都要自己兜底 |
| 用的是 Ultimate、Touch 或 Pro 2400 遥控器 | 先谨慎 | 据项目说明,这些型号虽然标注为支持,但尚未在实体硬件上测试 |
| 只想买回来插电就用,不想维护本地服务 | 不适合 | 本地网络服务、接口兼容性与系统要求都需要长期有人管 |
一句话结论:设备型号对得上、又愿意自己维护本地服务的人,harmony-ng 是让老遥控继续服役的现实路径;只求省事的人,刷机的折腾很可能超过它带来的好处。
常见问题
刷机之前最该准备什么?先按项目文档确认备份与恢复步骤。升级、网络配置或恢复操作之前保留原厂固件相关备份,必要时使用项目提供的恢复脚本,不要在没有退路的情况下直接动手。
平时怎么控制 Hub?最直接的是浏览器打开 Hub 的 8089 端口,用内置 Web UI 操作;手机上可用 Android Companion App;想接自动化,就走 REST 或 WebSocket 接口。
Elite 950 的屏幕界面有什么特别?据项目说明,它用的是 240×320、RGB565 格式的实时原生帧缓冲界面,界面直接跑在遥控器本地,而不是靠云端下发。
Ultimate、Touch 和 Pro 2400 遥控器能用吗?项目说明里标注为支持,但同时说明尚未在实体硬件上测试。选型时要把这一点当作明确风险,先核对 README 里对应型号的说明再决定。
Android 手机有什么版本要求?Companion App 要求 Android 10 或更高版本,低于这个版本的手机不在项目说明的部署前提里,其他平台的移动端支持也没有在摘要中明确说明。
下载地址
GitHub 国内访问较慢,如打不开可多刷新几次

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







