5 phút đọc
technyon/nuki_hub: Use an ESP32 as a Hub between a NUKI Lock and your smarthome. – Repository technyon/nuki_hub. Mô tả: Use an ESP32 as a Hub between a NUKI Lock and your smarthome.. 756 stars, 60 forks, ngôn ngữ chính C++, cập nhật 2026-11-11.
1. Repository làm gì?
The scope of Nuki Hub is to have an efficient way to integrate Nuki devices in a local Home Automation platform.
The Nuki Hub software runs on a ESP32 module and acts as a bridge between Nuki devices and a Home Automation platform. It communicates with a Nuki Lock and/or Opener through Bluetooth (BLE) and uses MQTT to integrate with other systems. It exposes the lock state (and much more) through MQTT and allows executing commands like locking and unlocking as well as changing the Nuki Lock/Opener configuration through MQTT.
Nuki Hub does not integrate with the Nuki mobile app, it can't register itself as a bridge in the official Nuki mobile app.
Feel free to join us on Discord: https://discord.gg/9nPq85bP4p
Supported Ethernet devices: As an alternative to Wi-Fi (which is available on any supported ESP32), the following ESP32 modules with built-in wired ethernet are supported:
In principle all ESP32 (and variants) devices with built-in ethernet port are supported, but might require additional setup using the "Custom LAN setup" option. See the "Connecting via Ethernet" section for more information.
2. Dữ liệu và cấu trúc đáng chú ý
We don't recommend using the original ESP32 or ESP32-Solo1 devices because these devices experience unexpected crashes related to the (closed-source) BLE controller. In newer models (e.g. ESP32-S3, ESP32-P4, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-C61, ESP32-H2) these unexpected crashed are seen a lot less.
When buying a new device in 2025 we recommend the ESP32-P4 or ESP32-S3 with PSRAM (look for an ESP32-S3 with the designation N>=4 and R>=2 such as an ESP32-S3 N16R8).
The ESP32-P4 with ESP32-C6 or ESP32-C5 module for BLE/WiFi is the most powerfull ESP32 in 2025. It supports anything the ESP32 range has to offer with the highest CPU clocks, largest flash and PSRAM, Ethernet, PoE and WiFi6 (and 5 GHZ WiFi with the C5 as co-processor).
The ESP32-S3 is a dual-core CPU with many GPIO's, ability to enlarge RAM using PSRAM, ability to connect Ethernet modules over SPI and optionally power the device with a PoE splitter. The only functions missing from the ESP32-S3 as compared to other ESP devices is the ability to use some Ethernet modules only supported by the original ESP32 (and ESP32-P4) and the ability to connect over WIFI6 (C5, C6 or ESP32-P4 with C6/C5 module)
The ESP32-C5 with PSRAM is a good option providing higher clockspeeds than the C6 and adding PSRAM and WIFI 6 on the 5 Ghz band support. The ESP32-C61 with PSRAM adds PSRAM compared to the C6.
Nuki Hub uses both CPU cores (if available) to process tasks (e.g. HTTP server/MQTT client/BLE scanner/BLE client) and thus runs better on dual-core devices.
Recommended devices ranked best-to-worst:
3. Khả năng ứng dụng và giới hạn
Devices without PSRAM (or where PSRAM was not detected, see "PSRAM Available" on the info page) run in low memory mode: WebSerial, Duo Push, the Nuki HTTP API and the per-entry keypad/timecontrol/authorization topics are disabled, the maximum number of keypad/timecontrol/authorization entries is limited to 20/10/10, the HTTPS server accepts fewer connections and the background update check is postponed while there is not enough contiguous memory for it. MQTT SSL and HTTPS remain available but are not recommended without PSRAM.
Not recommended devices ranked least-worst-to-worst:
Feature comparison Nuki Hub vs. Nuki Bridge
Feature comparison Nuki Hub vs. Nuki official MQTT API over WiFi/Thread (Smart Lock >=3.0 Pro)
This project is free to use for everyone. However if you feel like donating, you can buy me a coffee at ko-fi.com: If you plan to buy NUKI hardware, you can use my referral code to earn a 10% discount. It allows the project to team to buy further NUKI hardware for testing:
Flash the firmware to an ESP32. The easiest way to install is to use the web installer using a compatible browser like Chrome/Opera/Edge: https://technyon.github.io/nuki_hub/ Alternatively download the latest release for your ESP32 model from https://github.com/technyon/nuki_hub/releases Unpack the zip archive and read the included how-to-flash.txt for installation instructions for either "Espressif Flash Download Tools" or "esptool".
Initial setup (Network and MQTT)
Power up the ESP32 and a new Wi-Fi access point named "NukiHub" should appear. The password of the access point is "NukiHubESP32". Connect a client device to this access point and in a browser navigate to "http://192.168.4.1". The setup wizard guides you through three steps:
Pairing with a Nuki Lock (1.0-4.0) or Opener
Số liệu repository có thể thay đổi; nên mở liên kết nguồn để kiểm tra README, giấy phép và trạng thái phát hành.
