首页 / 服务中心 / 教程中心 / 进阶教程 / 绿联云安装使用HomeAssistant快速入门指南
绿联云安装使用HomeAssistant快速入门指南
2025/03/06

应用简介

Home Assistant 是一款开源家庭自动化平台,连接内网智能家居设备并实现自动化控制。

支持该功能的版本:NAS 固件的版本为1.2.0.2121 及以上,Home Assistant 应用版本为V1.0.0.3768及以上。

默认登录信息

  • 默认访问端口:8123

  • 局域网访问:在浏览器地址栏输入 http://NAS_IP:8123。例如 NAS 的 IP 是172.17.70.86,在浏览器中输入http://172.17.70.86:8123进行访问。您可以在控制面板中,找到 网络设置,点击 网络连接,查看 NAS 设备的 IP 地址。

  • 您可以在控制面板中,找到 网络设置,点击 网络连接,查看 NAS 设备的 IP 地址。

注意:请勿修改 WebUI 的端口号,避免因修改导致管理员通过 UGOS Pro 应用中心图标跳转功能失效。

配置路径

  • 应用存放配置的路径,您可以将例如 HACS、homekit、小米官方等插件放在这个路径下。

  • 配置路径的文件夹设置好以后,请不要删除、移动文件夹或修改文件名称,否则将导致功能异常。

  • 配置路径的文件夹可选范围为“共享文件夹”,不支持选择个人文件夹。

路径挂载规则:

应用安装完成后您可以在应用详情页的【配置】中查看对应的路径。

安装指南

安装 Home Assistant 应用,请按以下步骤操作:

  1. 打开【应用中心】找到 Home Assistant 应用,点击“安装”。

  2. 选择存储空间,点击“下一步”继续。

  3. 选择配置路径,应用会读取路径中插件信息,点击“安装”继续。

访问Home Assistant应用

您可以通过以下方法访问 Home Assistant 应用:

方法一:通过应用中心访问(仅限管理员)

在局域网内,管理员点击 Home Assistant 应用图标,系统将跳转至登录界面。

方法二:通过局域网访问(管理员和普通用户)

  1. 在局域网内使用http://NAS_IP:8123访问。例如 NAS 的 IP 是172.17.70.86,在浏览器中输入http://172.17.70.86:8123进行访问。

  2. 您可以在控制面板中,找到 网络设置,点击 网络连接,查看 NAS 设备的 IP 地址。

方法三:通过非局域网访问(仅限管理员)

管理员可以通过在 NAS 系统安装的 Firefox 应用在非局域网环境中访问 Home Assistant:

  1. 使用 UGREEN Link 登录 NAS,打开 Firefox 浏览器。

  2. 登录 Firefox 后,使用http://NAS_IP:8123访问。例如 NAS 的 IP 是172.17.70.86,在浏览器中输入http://172.17.70.86:8123进行访问。

注意:在不受信任的设备上登录时,建议及时清理浏览器的访问记录以确保数据安全。

使用提示

  1. 在局域网访问时,建议使用兼容性较好的浏览器(如 Chrome 或 Edge)进行访问,以获得最佳体验。

  2. 公共网络环境下访问 NAS 时,请注意数据安全,避免泄露敏感信息。

  3. 管理员请妥善管理访问密码,确保密码的安全性。

  4. 如果多人共用 Firefox 浏览器访问容器应用,建议关闭自动记住密码功能,并定期清理历史记录。

初始化配置

首次使用 Home Assistant 时,需要完成初始化配置:

  1. 点击“创建我的智能家居”进入创建引导。

  1. 创建用户,按照提示输入姓名、用户名和密码来创建您的 Home Assistant 账户。

  1. 设置您的家庭所在地理位置,设置完成后点击“下一步”继续。

  1. 根据需要选择是否启用某些功能,点击“下一步”继续。

  1. 到这一步初始化配置就完成了,点击“完成”按钮进入Home Assistant 的主页面。在主页中,您可以添加设备、配置自动化规则和自定义仪表板。

切换语言

如果需要修改语言,可以在【用户设置】中将系统语言设置为您熟悉的语言。点击您的用户名称,在【用户设置】选项栏中切换语言。

安装插件(集成)

在 Home Assistant 中,插件(集成)是扩展智能家居功能的核心工具,它们能将不同品牌的设备和服务无缝接入系统,实现统一管理。以下是一些常用插件的安装方法,涵盖 HACS 插件商店小米官方插件第三方小米插件以及 Apple HomeKit 的配置方法:

安装 HACS 插件商店(必备前置)

HACS(Home Assistant Community Store)是 Home Assistant 的一个社区驱动的插件商店,提供海量第三方插件和主题,方便一键安装、更新和管理。以下是安装 HACS 的步骤:

  1. HACS 插件需要前往 GitHub 下载最新的 HACS 压缩包,如果之前没有github账号的话,可以在这一步先把账号注册了再下载HACS压缩包。

  2. 在撰写本文时,HACS的最新版本为2.0.5。建议您根据实际情况下载并安装最新版本。https://github.com/hacs/integration/releases

  1. 打开文件管理器,在应用的配置目录下创建以下两个文件夹:

  • www:用于存放静态资源。

  • custom_components:作为插件目录。

  1. 配置目录是您在安装应用时设置的路径。您可以在应用详情页的【配置】选项中查看该路径。

  1. HACS 压缩包下载完成后,解压hacs.zip文件,并将解压后的文件夹上传到应用配置目录内的插件目录。

  2. 插件上传后,回到 Home Assistant 的页面,找到【开发者工具】重启 Home Assistant。

  1. 重启完成后在 HomeAssistant 页面中,点击【设置】>【设备与服务】,选择“添加集成”,搜索并添加 HACS。

  1. 勾选所有选项后点击“提交”。

  1. 复制弹窗中的代码,并点击弹窗的github网址跳转进行账号绑定,如果没有github账号可以自己注册一个,根据提示完成 GitHub 账号的绑定。

  1. 根据指引完成 GitHub 账号的绑定。

  1. 填写代码后点击Continue继续。

  1. 点击“Authorize hacs”。

  1. 显示这个就是授权成功了。

  1. 绑定授权成功后,您可以在 Home Assistant 的侧边栏中看到 HACS 选项。

小米官方插件 xiaomi_home

小米官方已发布适用于Home Assistant的插件 xiaomi_home,可在GitHub上获取。该插件通过小米官方接口接入米家设备(如空调、插座、传感器等),适合需要稳定官方支持的用户。

安装方法与HACS插件相同,只需将文件放入custom_components目录即可。

以下是安装的步骤:

  1. xiaomi_home 插件需要前往 GitHub 下载最新的压缩包Releases · XiaoMi/ha_xiaomi_home,如果之前没有github账号的话,可以在这一步先把账号注册了再下载压缩包。

  2. 在撰写本文时,xiaomi home 的最新版本是 v0.1.5b2。建议您根据实际情况下载并安装最新版本。

  1. xiaomi_home 压缩包下载完成后,解压xiaomi_home.zip文件,并将解压后的文件夹上传到应用配置目录内的custom_components插件目录。

  2. 插件上传后,回到 Home Assistant 的页面,找到【开发者工具】重启 Home Assistant。

  1. 重启完成后在HomeAssistant页面中,点击【设置】>【设备与服务】,选择“添加集成”,搜索并添加 Xiaomi Home

  1. 勾选风险告知,点击“下一步”继续。

  1. 点击“下一步”继续。

  1. 点此进行登录。

  1. 登录自己的小米账号。

  1. 点击登录会转跳到如下图页面,请将地址栏的 homeassistant.local 改为 NAS 的 IP地址,修改后重新访问地址,重新访问后该页面会自动关闭,我们回到 Home Assistant。

注意:您可以在控制面板中,找到 网络设置,点击 网络连接,查看 NAS 设备的 IP 地址。

  1. 回到 Home Assistant 页面中,勾选要导入设备的家庭,点击“下一步”继续。

  1. 到这一步可以看到家庭设备就说明部署成功了,点击“完成”关闭页面。

安装 xiaomi-miot 插件

除了小米官方插件外,社区还提供了一个名为 xiaomi-miot 的第三方插件。该插件通过小米的 MIoT 协议,支持更多的小米设备,包括一些官方插件不支持的设备。

以下是通过 HACS 安装 Xiaomi-Miot 的步骤:

  1. 在 HACS 商店中搜索 “Xiaomi Miot Auto”,然后下载该插件。

  1. 点击“Download”开始下载,下载完成后重启 Home Assistant 容器。在【Docker】应用中重启HomeAssistant容器,或者在HomeAssistant页面的【开发者工具】中点击“重新启动”。

  1. 容器重启后在Home Assistant的【设置>设备与服务】中,点击“添加集成”,搜索“xiaomi miot auto”找到并点击图标添加。

  1. 选择“账号集成”,下一步。

  1. 输入小米ID和密码,选择Automatic(自动模式),点击“提交”

  1. 根据您的需要,选择要包含或排除的设备,并完成集成设置。包含规则为手动选择您想要绑定的设备,排除规则为手动选择不想绑定的设备。

  1. 提交后我们可以在【概览】页面查看到我们添加的设备,到这里,我们可以通过homeassistant来控制米家接入的所有设备了。

配置 Apple Homekit

Apple HomeKit 是苹果的智能家居平台,Home Assistant 提供了与 HomeKit 的集成,通过 HomeKit 集成,用户可以在 Apple 的家庭应用中控制 Home Assistant 中的设备,或者将 HomeKit 设备添加到 Home Assistant 中进行统一管理。

如果您希望将 Home Assistant 中的设备添加到 Apple Home 应用中,可以通过以下步骤进行配置:

  1. 在HomeAssistant 中点击【设置>设备与服务】,点击“添加集成”,搜索“apple”,点击Apple图标进入下级菜单。

  1. 进入后点击“HomeKit Bridge”,您可以根据自己的需求选择要包含的域,域可以理解为不同的设备类型,选择后点击“提交”。

  1. “与 HomeKit 配对”这一步中,跟随引导点击“提交”>“完成”。

  1. 点击侧边栏的【通知】,使用Apple Hom 扫描生成的二维码,完成配对。

注意事项

在使用 UGOS Pro 系统及容器应用时,请注意以下事项:

  1. 请勿随意迁移、移动、重命名或删除容器挂载的 NAS 路径,以免功能异常或数据丢失。

  2. 如果需要通过浏览器访问容器应用,请关闭【控制面板>网络管理】中的多网关选项,避免网络冲突。

  3. 容器应用适合新手用户使用,如果需要更灵活地配置和管理,建议直接使用 Docker 自行部署容器应用,便于自定义配置文件及高级功能。


在线交流
关注微信公众号
服务热线:
0755-28066995
技术支持:
0755-21044617