本文最后更新于 2025-04-02，文章内容可能已经过时。

Home Assistant以下简称HA

Hass效果.png

关于反代HA报400错误的解决

HA默认不允许公网访问，需要修改HA容器下的configuration.yaml文件，末尾加入（ip为反代服务器所在网段）：

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.50.0/24

重启HA即可解决

HACS集成

HACS，全称Home Assistant Community Store，为HA提供社区第三方丰富的插件

官方文档：https://hacs.xyz/docs/use/

一、下载HACS

https://hacs.xyz/docs/use/download/download

  1. 方法一：在1Panel中打开HA容器的终端（选择/bin/bash命令），输入wget -O - https://get.hacs.xyz | bash -

  2. 方法二：https://blog.csdn.net/fq157856469/article/details/136816473

二、配置HACS

  1. 重启HA容器

  2. 进入HA页面，点击左下角账户名，打开高级模式

  3. 设置->设备与服务->右下角添加集成，添加HACS，勾选全部，注意，需要链接GitHub代理（到头来还是需要代理）

米家集成

官方安装文档：https://github.com/XiaoMi/ha_xiaomi_home/blob/main/doc/README_zh.md

安装HACS后，按照方法二进行安装即可：

HACS > 右上角三个点 > Custom repositories > Repository: https://github.com/XiaoMi/ha_xiaomi_home.git & Category or Type: Integration > ADD > 点击 HACS 的 New 或 Available for download 分类下的 Xiaomi Home ，进入集成详情页 > DOWNLOAD

配置方法见官方文档

注意：登录账号如果卡授权则将浏览器顶部地址栏的homeassistant.local替换成正确的即可（设备的IP）

智能插座耗电量统计

由于目前小米官方集成无法正确显示插座的耗电量，只能显示实时功率，因此借助HA的辅助元素对耗电量进行统计。

  • 耗电量计算

  • 进入设置->设备与服务->辅助元素，添加积分传感器，度量前缀为kilo，时间单位小时，输入传感器为小米插座的实时功率，集成方式选择左黎曼和，精度选择5位（低功耗设备可能需要高精度）。

  • 耗电量统计

积分传感器是不断累积的，没有时间间隔设置，需要添加统计以分隔每月（或每日）耗电情况

  1. 辅助元素添加公用事业仪表，输入传感器为上面设置的耗电量统计传感器，计量复位单位为每月（或每日）。

  2. 显示耗电量

在仪表盘中选择显示状态为上一个周期即可显示上月（或昨天）耗电量

DeepSeek对不同积分方式的解释：

积分方法的原理对比

黎曼和积分传感器提供三种积分方法：

​左黎曼和（left）​
用每个时间区间的 ​起始点值 乘以时间间隔，计算该区间的耗电量。
​ 公式：累计电量 += 起始点功率值 × 时间差

​右黎曼和（right）​
用每个时间区间的 ​结束点值 乘以时间间隔。

​梯形法则（trapezoidal，默认方法）​
用起始点和结束点的平均值 乘以时间间隔。
​ 公式：累计电量 += (起始点功率值 + 结束点功率值) / 2 × 时间差

为何选择左黎曼和？

​1. 适应传感器数据特性

​场景假设：
小米插座可能以 ​固定间隔​（如每分钟）上报实时功率值，但 ​瞬时功率可能突变​（例如设备突然关闭，功率骤降为0）。

​左黎曼和的优势：

如果设备在某个时间点关闭（功率变为0），左黎曼和会 ​立即停止积分​（后续时间区间的起始点为0），避免高估耗电量。

而梯形法则会将关闭前后的功率值平均，可能导致 ​最后一个区间的耗电量被高估​（见下图示例）。

​2. 避免“未来依赖”问题

​右黎曼和的缺陷：
需要依赖 ​下一个时间点的值 才能计算当前区间，这在实时积分中不可行（无法预知未来数据）。

​左黎曼和的实时性：
仅依赖当前已知值，适合实时积分场景。

​3. 默认方法（梯形法则）的局限性

​适用场景：
梯形法则在数据平稳且间隔均匀 时精度更高，但在以下情况下表现较差：

功率突变（如设备开关）

传感器上报间隔不稳定（如网络延迟导致数据点间隔不均）

华硕路由集成

在HACS中下载AsusRouter（官方自带的ASUSWRT并不完全兼容现在的路由）

集成官方文档：https://asusrouter.vaskivskyi.com/

支持的路由列表：https://asusrouter.vaskivskyi.com/devices/

系统信息集成

添加集成System monitor

HA手机app下载

https://github.com/home-assistant/android/releases

天气集成

  1. 安装天气集成https://github.com/hasscc/tianqi

  2. 在HACS中安装彩云天气面板Colorfulclouds Weather Card

  3. 添加天气集成，服务器域填写weather.com.cn

说明：彩云天气从2024年无免费api，因此这里使用的是中国天气网

国家电网集成

https://github.com/ARC-MX/sgcc_electricity_new

这个无法添加到HACS中的Custom repositories，会提示这个项目属于Add-ons

Docker版本的HA不支持Supervisor 和加载项商店，因此这个项目目前只能运行在另外的容器中，但项目正在开发HACS集成。

Openwrt接入

https://github.com/kvj/hass_openwrt（限制太多，实体只有三个，不建议接入）

可以在路由器上安装netdata，在HA上通过netdata集成获取路由信息，但是这对路由性能的开销非常大（尤其是资源有限的硬路由）