智能家居
Home Assistant 蓝牙代理实战：ESP32 蓝牙中继扩展米家/涂鸦 BLE 设备覆盖
2026年10月10日
ESP32 蓝牙代理扩展米家/涂鸦 BLE 设备覆盖
Home Assistant 蓝牙代理实战：ESP32 蓝牙中继扩展米家/涂鸦 BLE 设备覆盖
摘要：本文讲清 HA 蓝牙代理的原理，用 ESPHome 把 ESP32 变成蓝牙中继，扩展米家/涂鸦等 BLE 设备覆盖范围，并说明被动扫描与主动连接的区别及布点避坑。
一、为什么 Home Assistant 需要蓝牙代理
Home Assistant 自带蓝牙（尤其装在没有蓝牙的迷你主机、或 Docker 容器拿不到 USB 蓝牙棒时）往往信号极弱，隔一堵墙就搜不到 BLE 设备。而家里大量设备其实是蓝牙低功耗（BLE）的：米家温湿度计、花花草草检测仪、涂鸦门锁/传感器、Yeelight 灯、体脂秤……它们散布在各个房间。
单靠 HA 主机一根天线，覆盖半径通常只有几米，卧室的设备根本接不进来。蓝牙代理（Bluetooth Proxy）就是解决这个问题的标准方案。
二、蓝牙代理的工作原理
蓝牙代理本质是一个"蓝牙中继"：在信号好的位置放一台带蓝牙的小设备，它把附近 BLE 设备的广播和连接"转发"给 HA。HA 自己不需要到现场，只跟代理通信。
HA 的蓝牙集成支持多代理协同：一个设备被哪个代理先听到，就由哪个代理服务；当设备移动，HA 会自动切换到信号更好的代理。换句话说，布几个代理，就等于把 HA 的"蓝牙耳朵"伸到了全屋。
三、用 ESPHome 把 ESP32 变成代理
成本最低的方案是 ESP32 开发板（十几元），刷 ESPHome 固件，几行配置即可：
esphome:
name: bt-proxy-living
esp32:
board: esp32dev
framework:
type: arduino
bluetooth_proxy:
active: true # 允许主动连接（不止被动监听）
id: proxy0
api:
encryption:
key: "你的加密密钥"
wifi:
ssid: "家庭WiFi"
password: "密码"
烧录后上电，ESP32 即成为一个蓝牙代理节点。建议选带外接天线座的 ESP32（如 ESP32-WROOM 配 IPX 座），覆盖明显优于板载天线。
四、在 Home Assistant 中接入
HA 安装并启用官方 Bluetooth 集成后，同一局域网的 ESPHome 蓝牙代理会被自动发现（mDNS）。在"集成"页面点击"配置"即可加入。
加入后，去"添加集成"里搜索你的设备（如"小米 BLE 传感器"），HA 会自动通过代理扫描并配对。你会发现原本搜不到的卧室温度计，现在稳定出现在设备列表里。
五、被动扫描 vs 主动连接
active: true 与 false 的区别很关键：
- 被动（false）：只转发广播包，适合纯广播设备（温湿度计、存在传感器），最省电、最稳。
- 主动（true）：代理可代表 HA 与设备建立连接（读写特征值），适合需要控制的设备（灯、锁、插座）。
注意一个设备的连接只能由一个代理持有。若多个代理都开 active，HA 会自动仲裁，但不要把所有代理都开 active 造成"抢连接"。一般全屋布点用 passive，只有确实需要控制的房间代理才开 active。
六、布点与常见坑
- 布点：按"信号好不好"而不是"均匀摆"。重点覆盖设备密集的卧室、厨房、卫生间，一楼一台、二楼一台通常够。
- 信道干扰：BLE 只用 2.4G 的 37/38/39 三个广播信道，和 Wi-Fi 2.4G 同频段，代理尽量远离路由器天线。
- ESP32 性能：单颗 ESP32 同时服务的主动连接数有限（约 3–4 个），设备多的房间可放两颗或改用 ESP32-C3。
- 不要和 HA 主机蓝牙重复：若主机已有蓝牙，代理是扩展而非替代，避免 MAC 冲突。
小结
蓝牙代理是 Home Assistant 接入 BLE 生态性价比最高的"基建"：十几元的 ESP32 + 几行 ESPHome 配置，就能把 HA 的蓝牙覆盖从"一根天线"扩展到"全屋耳朵"。先按 passive 全屋铺广播采集，再在需要控制的房间开 active，米家、涂鸦、Yeelight 等一大批 BLE 设备就能稳定纳入本地自动化，彻底摆脱厂商云端的延迟与依赖。