Home Assistant安装HACS商店与UI主题更换完整教程

前言

Home Assistant作为目前最流行的开源智能家居平台，其强大的扩展性离不开各种插件和主题的支持。HACS（Home Assistant Community Store）作为第三方社区商店，为我们提供了丰富的插件、主题和集成资源。本文将详细介绍如何安装HACS商店以及如何更换UI主题，让你的Home Assistant界面更加美观实用。

安装HACS商店

方案选择

在NAS上安装Home Assistant主要有两种方案：

1. Docker方案 - 轻量级，资源占用少
2. VMM虚拟机方案 - 隔离性好，功能完整

本文以VMM虚拟机安装方案为例进行说明。

安装前准备

1. 打开高级设置模式

1. 登录Home Assistant界面
2. 点击左下角个人账户
3. 选择”打开高级模式”

2. 安装Terminal & SSH

1. 进入”配置” → “加载项”
2. 点击右下角的”加载项商店”
3. 在商店中搜索”Terminal & SSH”
4. 点击安装

💡 安装成功后，左侧栏会出现Terminal图标

正式安装HACS

方法一：自动安装（推荐）

1. 打开Terminal终端
2. 输入以下命令：

1

wget -O - https://get.hacs.xyz | bash -

3. 等待安装完成，看到”Installation complete”字样表示成功

方法二：手动安装

如果自动安装遇到网络问题，可以采用手动安装：

1. 在Home Assistant根目录下创建文件夹：

1
2

mkdir -p custom_components
mkdir -p www

2. 下载HACS安装包：

1
2
3
4
5
6

# 如果无法访问，需要先解决网络问题
cd custom_components
wget https://github.com/hacs/integration/releases/latest/download/hacs.zip
unzip hacs.zip
mv hacs/* .
rm -rf hacs hacs.zip

网络问题解决方案

如果在安装过程中出现”Connection refused”等无法连接的提示，通常是因为无法访问githubusercontent.com导致的。可以通过以下方法解决：

修改hosts文件

1. 在Terminal中输入：

1

vi /etc/hosts

2. 按i键进入编辑模式
3. 添加以下内容（需要先查询最新的IP地址）：

1
2
3
4
5
6

# GitHub相关域名解析
140.82.114.4 github.com
185.199.108.133 raw.githubusercontent.com
185.199.109.133 raw.githubusercontent.com
185.199.110.133 raw.githubusercontent.com
185.199.111.133 raw.githubusercontent.com

4. 按ESC键退出编辑模式

5. 输入:wq保存并退出

6. 重新执行安装命令

配置HACS

1. 重启Home Assistant

安装完成后，需要重启HA服务器：

1

reboot

2. 添加HACS集成

1. 重启后，点击左下角”配置”
2. 选择”设备与服务”
3. 点击”添加集成”
4. 搜索”HACS”
5. 点击安装

3. GitHub配置

1. 点击HACS中的GitHub超链接
2. 注册/登录GitHub账号
3. 复制页面上的8位数激活码
4. 在GitHub页面粘贴激活码并确认
5. 返回Home Assistant页面，等待成功提示

4. 完成安装

1. 看到成功提示后，再次重启HA服务器
2. 重启后，左侧栏会出现HACS图标
3. 点击HACS图标，可以看到各种插件和主题

更换UI主题

安装主题

1. 点击左侧栏的HACS图标
2. 选择”前端”选项卡
3. 浏览你喜欢的主题（如”lovelace”主题）
4. 点击主题右下角的下载图标进行安装
5. 安装完成后重启Home Assistant

启用新主题

1. 点击左下角用户头像
2. 选择”配置文件”
3. 在”主题”下拉菜单中选择新安装的主题
4. 主题会立即生效

常用主题推荐

常见问题解决

1. HACS商店无法加载

问题原因： 网络连接问题
解决方案：

• 检查网络连接
• 尝试修改hosts文件
• 使用全局代理加速

2. 主题安装后无法显示

问题原因： 缓存问题
解决方案：

• 清除浏览器缓存
• 强制刷新页面（Ctrl+F5）
• 重启Home Assistant

3. GitHub激活失败

问题原因： 激活码错误或过期
解决方案：

• 重新获取激活码
• 确保GitHub账号正常登录
• 检查网络连接

4. 安装后HACS图标不显示

问题原因： 安装不完整
解决方案：

• 检查custom_components目录
• 重新执行安装命令
• 查看日志文件排查错误

进阶配置

自定义主题配置

在configuration.yaml中添加主题配置：

1
2
3
4

frontend:
  themes: !include_dir_merge_named themes
  extra_module_url:
    - /hacsfiles/lovelace-card-mod/card-mod.js

主题个性化设置

1. 进入HACS商店
2. 选择”设置”
3. 配置主题相关选项
4. 可以自定义颜色、字体、布局等

主流品牌设备接入教程

小米设备接入

安装小米官方集成

1. 通过HACS安装（推荐）

   • 打开HACS商店
   • 搜索”Xiaomi Home”
   • 点击安装

2. 手动安装

1
2
3
4
5
6
7

# 进入Home Assistant配置目录
cd config
# 克隆小米官方集成仓库
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
# 执行安装脚本
./install.sh /config

配置小米账号

1. 进入”设置” → “设备与服务”
2. 点击”添加集成”
3. 搜索”Xiaomi Home”
4. 点击”登录小米账号”
5. 输入小米账号密码完成授权

选择设备和家庭

登录成功后会弹出”选择家庭和设备”对话框：

• 选择要导入的家庭
• 勾选需要接入的设备
• 支持多账号登录，可重复添加

支持设备类型

本地控制模式

前提条件：

• 小米中枢网关（固件版本3.3.0_0023及以上）
• 或内置中枢网关的智能设备（软件版本0.8.9及以上）

开启方法：

1. 确保中枢网关在本地网络
2. 在集成配置中启用”本地控制”
3. 设备控制响应更快，不依赖云端

⚠️ 注意：中枢网关仅在中国大陆地区销售，其他地区用户只能使用云端控制

美的设备接入

插件介绍

最近发现了一个新上架不久的插件 midea_auto_cloud，能让美的全系设备（包括华凌、布谷）丝滑接入Home Assistant，体验简直吊打红外方案！

安装步骤

插件名称： midea_auto_cloud

1. 搜索插件

   • 打开HACS商店
   • 在搜索栏输入 midea_auto_cloud

2. 下载安装

   • 认准搜索结果的第一个，点击安装

3. 添加集成

   • 安装完毕后，点击左侧菜单的概览
   • 点击右上角”添加集成”
   • 在弹出的窗口中，直接输入你的美的美居App账号和密码

4. 见证奇迹

   • 登录成功后，插件会自动拉取你账号下的所有设备
   • 华凌空调、布谷洗碗机等设备会瞬间显示出来
   • 状态反馈极其迅速，再也不用猜设备是开是关了

相比红外控制的优势

支持设备类型

• 空调设备：完全支持，包括温度控制、模式切换、风速调节
• 冰箱设备：支持温度监控、模式设置、故障报警
• 洗衣机：支持状态监控、程序控制、剩余时间显示
• 热水器：支持温度调节、定时功能、用水量统计
• 洗碗机：支持程序选择、剩余时间、故障提示
• 厨电系列：油烟机、燃气灶、消毒柜等

进阶玩法：拒绝电费刺客

场景描述： 冬天开空调最怕不小心误触开了电辅热！电辅热一开，电表转得跟风火轮一样，一晚上就是好几块钱。

解决方案：

1. 创建自动化规则

1
2
3
4
5
6
7
8
9
10
11
12
13

automation:
  - alias: "防止电辅热误开"
    trigger:
      platform: state
      entity_id: climate.midea_ac_bedroom
      attribute: aux_heat
      to: 'on'
    action:
      service: climate.set_aux_heat
      target:
        entity_id: climate.midea_ac_bedroom
      data:
        aux_heat: false

2. 添加通知提醒

1
2
3
4
5
6
7
8
9
10
11
12

automation:
  - alias: "电辅热关闭提醒"
    trigger:
      platform: state
      entity_id: climate.midea_ac_bedroom
      attribute: aux_heat
      to: 'on'
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "检测到空调电辅热已开启，已自动关闭以节省电费"
          title: "电费保护提醒"

💡 效果： 现在，不管是谁手滑开了电辅热，HA都会在后台默默地把它关掉，帮我守住钱包。这才是智能家居该有的样子！

本地控制配置

部分美的设备支持本地控制：

1. 前提条件

   • 设备和Home Assistant在同一局域网
   • 设备支持WiFi直连（非仅云端控制）

2. 配置步骤

   • 在集成配置中启用”本地控制”
   • 输入设备IP地址和端口
   • 部分设备需要获取Token（插件会自动完成）

3. 优势

   • 响应速度更快（毫秒级）
   • 不依赖外网连接
   • 隐私性更好

设备管理技巧

区域划分

1. 在Home Assistant中创建区域
2. 将设备分配到对应区域
3. 便于批量控制和场景设置

自动化场景

1
2
3
4
5
6
7
8
9
10
11

# 示例：回家自动开灯
automation:
  - alias: "回家开灯"
    trigger:
      platform: state
      entity_id: person.your_name
      to: 'home'
    action:
      service: light.turn_on
      target:
        entity_id: light.living_room

状态监控

• 使用HACS安装设备状态监控面板
• 实时查看设备在线状态
• 设备离线时发送通知

总结

通过HACS商店，我们可以轻松地为Home Assistant添加各种功能插件和美观的主题，大大提升使用体验。虽然安装过程中可能会遇到一些网络问题，但通过本文提供的解决方案，相信大家都能顺利完成安装配置。

HACS不仅提供了丰富的资源，还有活跃的社区支持，是Home Assistant用户必装的工具之一。希望本教程能帮助大家更好地使用Home Assistant，打造属于自己的智能家居系统。

相关推荐：

• Home Assistant官方文档
• HACS官方GitHub
• Home Assistant中文社区
• 小米官方Home Assistant集成
• 小米设备接入详细教程