Nest 恒温器固件设置

🏆 FULU 赏金获胜者 🏆

Hack House 和本项目是 Nest Learning Thermostat Gen 1/2 的 FULU 赏金计划 的官方获胜者

硬件替代方案： 如果你对硬件方面感兴趣，可以查看 https://sett.homes，获取可直接替换的 PCB 替代方案。

安装

方案一：GUI 安装程序 - 推荐

📖 按照 docs.nolongerevil.com 上的安装指南操作，或直接下载最新版本。

安装程序会处理一切——刷写固件并引导你完成设置。在设置过程中，选择你的托管模式：

• 云托管 — 连接到 No Longer Evil 平台；无需搭建服务器
• 自托管（Home Assistant） — 自动发现你的 Home Assistant 实例并连接到 No Longer Evil 插件
• 自托管（NLE Server） — 连接到自定义 IP 和端口上的独立 No Longer Evil 服务器

需要自托管？ 在运行安装程序之前，你需要单独搭建自己的服务器基础设施。请参阅自托管指南。

方案二：从源码构建

如果你更愿意自己构建并运行安装程序，而不是下载发布版本：

前置要求

• Node.js 18+ 和 npm
• Docker — 仅当需要从源码重新构建固件时才需要（安装 Docker）
• macOS/Linux — 不支持在 Windows 上构建或刷写

1. 克隆仓库

git clone https://github.com/codykociemba/NoLongerEvil-Thermostat.git
cd NoLongerEvil-Thermostat

2. 构建固件（可选）

仓库中已包含预构建的固件文件，位于 firmware/installer/resources/firmware/。仅当你想要自定义固件（例如使用不同的服务器 URL）时才需要此步骤。

cd firmware/builder
./docker-build.sh --generation both --enable-root-access --yes

这会在 Docker 内同时为 Nest Gen 1 和 Gen 2 构建。之后，将输出复制到安装程序目录：

cp firmware/builder/firmware/* firmware/installer/resources/firmware/

3. 构建或运行安装程序

cd firmware/installer
npm install

直接运行（无需构建）：

npm run electron:dev

或构建可分发的安装包：

npm run package:mac    # macOS
npm run package:linux  # Linux

输出位于 firmware/installer/dist/。打开构建好的应用并按照屏幕上的步骤操作。

安全注意事项

该工具提供对设备启动过程的底层访问权限。请负责任地使用：

• 仅在你拥有的设备上使用
• 不正确的固件可能让你的设备变砖（别起诉我，兄弟）

致谢

本项目建立在多位安全研究人员和开发者的卓越工作之上：

• grant-h / ajb142 - omap_loader，用于刷写 OMAP 设备的 USB 引导加载程序工具
• exploiteers (GTVHacker) - Nest DFU 攻击的原始研究与开发，证明了向 Nest 第 1 代和第 2 代设备刷写自定义固件的能力
• FULU 及所有赏金赞助者 - 资助了 Nest Learning Thermostat Gen 1/2 赏金计划 并支持维修权运动

没有他们开创性的研究、开源贡献以及对设备所有权权利的倡导，这项工作将无法实现。谢谢你们！

开源承诺

我们致力于透明度和维修权运动。固件镜像和后端 API 服务器代码将很快开源，让社区能够审计、改进并自行托管自己的基础设施。

参考资料

• ajb142 的 OMAP Loader
• exploiteers 的 Nest DFU 攻击