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 应用,请按以下步骤操作:
打开【应用中心】找到 Home Assistant 应用,点击“安装”。
选择存储空间,点击“下一步”继续。
选择配置路径,应用会读取路径中插件信息,点击“安装”继续。
您可以通过以下方法访问 Home Assistant 应用:
在局域网内,管理员点击 Home Assistant 应用图标,系统将跳转至登录界面。
在局域网内使用http://NAS_IP:8123
访问。例如 NAS 的 IP 是172.17.70.86,在浏览器中输入http://172.17.70.86:8123
进行访问。
您可以在控制面板中,找到 网络设置,点击 网络连接,查看 NAS 设备的 IP 地址。
管理员可以通过在 NAS 系统安装的 Firefox 应用在非局域网环境中访问 Home Assistant:
使用 UGREEN Link 登录 NAS,打开 Firefox 浏览器。
登录 Firefox 后,使用http://NAS_IP:8123
访问。例如 NAS 的 IP 是172.17.70.86,在浏览器中输入http://172.17.70.86:8123
进行访问。
注意:在不受信任的设备上登录时,建议及时清理浏览器的访问记录以确保数据安全。
在局域网访问时,建议使用兼容性较好的浏览器(如 Chrome 或 Edge)进行访问,以获得最佳体验。
在公共网络环境下访问 NAS 时,请注意数据安全,避免泄露敏感信息。
管理员请妥善管理访问密码,确保密码的安全性。
如果多人共用 Firefox 浏览器访问容器应用,建议关闭自动记住密码功能,并定期清理历史记录。
首次使用 Home Assistant 时,需要完成初始化配置:
点击“创建我的智能家居”进入创建引导。
创建用户,按照提示输入姓名、用户名和密码来创建您的 Home Assistant 账户。
设置您的家庭所在地理位置,设置完成后点击“下一步”继续。
根据需要选择是否启用某些功能,点击“下一步”继续。
到这一步初始化配置就完成了,点击“完成”按钮进入Home Assistant 的主页面。在主页中,您可以添加设备、配置自动化规则和自定义仪表板。
如果需要修改语言,可以在【用户设置】中将系统语言设置为您熟悉的语言。点击您的用户名称,在【用户设置】选项栏中切换语言。
在 Home Assistant 中,插件(集成)是扩展智能家居功能的核心工具,它们能将不同品牌的设备和服务无缝接入系统,实现统一管理。以下是一些常用插件的安装方法,涵盖 HACS 插件商店、小米官方插件、第三方小米插件以及 Apple HomeKit 的配置方法:
HACS(Home Assistant Community Store)是 Home Assistant 的一个社区驱动的插件商店,提供海量第三方插件和主题,方便一键安装、更新和管理。以下是安装 HACS 的步骤:
HACS 插件需要前往 GitHub 下载最新的 HACS 压缩包,如果之前没有github账号的话,可以在这一步先把账号注册了再下载HACS压缩包。
在撰写本文时,HACS的最新版本为2.0.5。建议您根据实际情况下载并安装最新版本。https://github.com/hacs/integration/releases
打开文件管理器,在应用的配置目录下创建以下两个文件夹:
www
:用于存放静态资源。
custom_components
:作为插件目录。
配置目录是您在安装应用时设置的路径。您可以在应用详情页的【配置】选项中查看该路径。
HACS 压缩包下载完成后,解压hacs.zip
文件,并将解压后的文件夹上传到应用配置目录内的插件目录。
插件上传后,回到 Home Assistant 的页面,找到【开发者工具】重启 Home Assistant。
重启完成后在 HomeAssistant 页面中,点击【设置】>【设备与服务】,选择“添加集成”,搜索并添加 HACS。
勾选所有选项后点击“提交”。
复制弹窗中的代码,并点击弹窗的github网址跳转进行账号绑定,如果没有github账号可以自己注册一个,根据提示完成 GitHub 账号的绑定。
根据指引完成 GitHub 账号的绑定。
填写代码后点击Continue继续。
点击“Authorize hacs”。
显示这个就是授权成功了。
绑定授权成功后,您可以在 Home Assistant 的侧边栏中看到 HACS 选项。
小米官方已发布适用于Home Assistant的插件 xiaomi_home,可在GitHub上获取。该插件通过小米官方接口接入米家设备(如空调、插座、传感器等),适合需要稳定官方支持的用户。
安装方法与HACS插件相同,只需将文件放入custom_components
目录即可。
以下是安装的步骤:
xiaomi_home 插件需要前往 GitHub 下载最新的压缩包Releases · XiaoMi/ha_xiaomi_home,如果之前没有github账号的话,可以在这一步先把账号注册了再下载压缩包。
在撰写本文时,xiaomi home 的最新版本是 v0.1.5b2。建议您根据实际情况下载并安装最新版本。
xiaomi_home 压缩包下载完成后,解压xiaomi_home.zip
文件,并将解压后的文件夹上传到应用配置目录内的custom_components
插件目录。
插件上传后,回到 Home Assistant 的页面,找到【开发者工具】重启 Home Assistant。
重启完成后在HomeAssistant页面中,点击【设置】>【设备与服务】,选择“添加集成”,搜索并添加 Xiaomi Home。
勾选风险告知,点击“下一步”继续。
点击“下一步”继续。
点此进行登录。
登录自己的小米账号。
点击登录会转跳到如下图页面,请将地址栏的 homeassistant.local 改为 NAS 的 IP地址,修改后重新访问地址,重新访问后该页面会自动关闭,我们回到 Home Assistant。
注意:您可以在控制面板中,找到 网络设置,点击 网络连接,查看 NAS 设备的 IP 地址。
回到 Home Assistant 页面中,勾选要导入设备的家庭,点击“下一步”继续。
到这一步可以看到家庭设备就说明部署成功了,点击“完成”关闭页面。
除了小米官方插件外,社区还提供了一个名为 xiaomi-miot
的第三方插件。该插件通过小米的 MIoT 协议,支持更多的小米设备,包括一些官方插件不支持的设备。
以下是通过 HACS 安装 Xiaomi-Miot 的步骤:
在 HACS 商店中搜索 “Xiaomi Miot Auto”,然后下载该插件。
点击“Download”开始下载,下载完成后重启 Home Assistant 容器。在【Docker】应用中重启HomeAssistant容器,或者在HomeAssistant页面的【开发者工具】中点击“重新启动”。
容器重启后在Home Assistant的【设置>设备与服务】中,点击“添加集成”,搜索“xiaomi miot auto”找到并点击图标添加。
选择“账号集成”,下一步。
输入小米ID和密码,选择Automatic(自动模式),点击“提交”
根据您的需要,选择要包含或排除的设备,并完成集成设置。包含规则为手动选择您想要绑定的设备,排除规则为手动选择不想绑定的设备。
提交后我们可以在【概览】页面查看到我们添加的设备,到这里,我们可以通过homeassistant来控制米家接入的所有设备了。
Apple HomeKit 是苹果的智能家居平台,Home Assistant 提供了与 HomeKit 的集成,通过 HomeKit 集成,用户可以在 Apple 的家庭应用中控制 Home Assistant 中的设备,或者将 HomeKit 设备添加到 Home Assistant 中进行统一管理。
如果您希望将 Home Assistant 中的设备添加到 Apple Home 应用中,可以通过以下步骤进行配置:
在HomeAssistant 中点击【设置>设备与服务】,点击“添加集成”,搜索“apple”,点击Apple图标进入下级菜单。
进入后点击“HomeKit Bridge”,您可以根据自己的需求选择要包含的域,域可以理解为不同的设备类型,选择后点击“提交”。
“与 HomeKit 配对”这一步中,跟随引导点击“提交”>“完成”。
点击侧边栏的【通知】,使用Apple Hom 扫描生成的二维码,完成配对。
在使用 UGOS Pro 系统及容器应用时,请注意以下事项:
请勿随意迁移、移动、重命名或删除容器挂载的 NAS 路径,以免功能异常或数据丢失。
如果需要通过浏览器访问容器应用,请关闭【控制面板>网络管理】中的多网关选项,避免网络冲突。
容器应用适合新手用户使用,如果需要更灵活地配置和管理,建议直接使用 Docker 自行部署容器应用,便于自定义配置文件及高级功能。