5分钟上手Nuki Hub：从硬件准备到WiFi配置的快速入门教程
【免费下载链接】nuki_hubUse an ESP32 as a Hub between a NUKI Lock and your smarthome.项目地址: https://gitcode.com/gh_mirrors/nu/nuki_hub
Nuki Hub是一款基于ESP32的智能家居网关，能让你的Nuki智能锁无缝接入本地智能家居系统。本教程将带你快速完成从硬件选型到WiFi配置的全过程，让你在5分钟内启动并运行Nuki Hub。
📋 准备工作：硬件与环境
推荐ESP32设备
Nuki Hub支持多种ESP32型号，2025年最推荐的选择是：
- ESP32-P4：搭载C5/C6模块，支持WiFi 6和以太网，性能最强
- ESP32-S3：性价比之选，推荐带PSRAM的型号（如N16R8）
- ESP32-C5：支持5GHz WiFi 6，低功耗设计
避免使用ESP32-S2（无BLE）和初代ESP32（稳定性问题较多）
其他必要物品
- Micro-USB数据线（用于供电和刷写固件）
- 电脑（Windows/macOS/Linux均可）
- 稳定的WiFi网络（2.4GHz，需知道SSID和密码）
🔧 第一步：安装Nuki Hub固件
快速刷写方法
- 访问Nuki Hub官方仓库：
git clone https://gitcode.com/gh_mirrors/nu/nuki_hub - 进入Docker目录：
cd nuki_hub/Docker - 运行一键构建脚本：
./build_with_docker_pio.sh - 根据提示连接ESP32并完成固件刷写
对于新手用户，推荐使用Web installer（需Chrome/Edge浏览器），访问项目仓库的Releases页面下载对应型号的固件
📶 第二步：WiFi网络配置
初始连接
固件刷写完成后：
- 给ESP32上电，等待30秒
- 在手机/电脑的WiFi列表中找到名为
NukiHub的热点 - 连接该热点，密码为
NukiHubESP32
配置家庭WiFi
- 连接后自动跳转配置页面（若未跳转，手动访问
192.168.4.1） - 在WiFi设置界面中选择你的家庭WiFi SSID
- 输入WiFi密码并点击"保存"
- 设备将自动重启并连接到你的WiFi网络
图：Nuki Hub网络配置界面 - 选择WiFi网络并输入密码
🔍 第三步：查找Nuki Hub IP地址
两种获取方式
- 路由器管理页面：登录路由器后台，在设备列表中找到名为
NukiHub的设备 - 网络扫描工具：使用Advanced IP Scanner等工具扫描局域网，找到ESP32设备
记下IP地址（如
192.168.1.100），后续配置需要使用
⚙️ 第四步：访问Web配置界面
- 打开浏览器，输入上一步获取的IP地址
- 首次访问会要求设置管理员密码
- 登录后进入主配置页面，你可以：
- 查看设备状态
- 配置MQTT连接（用于智能家居集成）
- 更新固件
- 管理Nuki设备配对
图：Nuki Hub固件更新进度 - 显示"Update done for file"表示更新成功
📱 第五步：配对Nuki智能锁
- 在Web界面中进入"Nuki配置"页面
- 确保Nuki智能锁处于配对模式（长按锁上的按钮直至指示灯闪烁）
- 点击"开始配对"按钮，等待配对完成
- 配对成功后，你可以在界面上看到锁的状态信息
对于Nuki Lock Ultra/5th gen Pro用户，需要先启用Hybrid模式，详情参见HYBRID.md
✨ 功能验证
配置完成后，你可以：
- 查看锁的实时状态（锁定/解锁）
- 通过Web界面控制锁的开关
- 配置MQTT实现与Home Assistant等智能家居系统的集成
Nuki Hub采用高效的网络通信架构，即使在多设备连接下也能保持低延迟：
图：Nuki Hub使用的PsychicHTTP库性能测试 - 在20个并发连接下仍保持60+请求/秒的处理能力
🚩 常见问题解决
WiFi连接失败
- 确保使用2.4GHz WiFi（不支持5GHz）
- 检查密码是否正确（区分大小写）
- 尝试将ESP32靠近路由器
- 若仍无法连接，长按设备重置按钮恢复出厂设置
无法找到NukiHub热点
- 确保固件刷写成功
- 尝试重新上电
- 检查USB供电是否稳定（建议使用5V/1A电源）
📚 进阶配置
Nuki Hub提供丰富的高级功能：
- Duo双因素认证：增强Web界面安全性
- MQTT配置：自定义主题路径和连接参数
- 以太网支持：对于有线网络环境，可使用W5500模块
- 静态IP设置：在网络配置页面设置固定IP地址
通过本教程，你已经成功完成了Nuki Hub的基础配置。接下来可以探索更多高级功能，将Nuki智能锁无缝集成到你的智能家居系统中。如有任何问题，欢迎查阅项目文档或参与社区讨论。
【免费下载链接】nuki_hubUse an ESP32 as a Hub between a NUKI Lock and your smarthome.项目地址: https://gitcode.com/gh_mirrors/nu/nuki_hub
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
