CasaOS香橙派安装HomeAssistant智能家居系统并实现远程管理家中智能设备

前言

本文主要介绍如何在刷入 CasaOS 轻 NAS 系统的香橙派 Zero3 中安装 HomeAssistant 智能家居系统，并结合 cpolar 内网穿透工具轻松实现远程管理家中的智能设备，无需公网 IP 也不用设置路由器那么麻烦。

HomeAssistant是一个可以控制苹果、小米、MQTT 等设备的智能家居平台。它可以把家中的智能家居设备整合到一起，让后让各个品牌之间的设备可以联网。一个设备，在没接入 HA 之前，它是个单一设备，只能在自己的生态里面联动，一旦接入到 HA 上，它就活了，它可以在所有接入的平台里面自己联动，实现各种各样的自动化。

之前曾经和大家分享过如何使用VMware 创建虚拟机的方式和在群晖 NAS 中使用 Docker进行部署，今天分享一下在香橙派 Zero3 这种功耗小并且可以像路由器一样一直联网的小主机中安装，过程非常简单，下面就来具体演示一下。

1. 添加镜像源

我这里演示的环境是已经刷好 CasaOS 的香橙派 Zero3 小主机。

不知道如何操作的可以看下这篇教程：[香橙派 Orange Pi zero3 如何刷 CasaOS 轻 NAS 系统](香橙派 Orange Pi zero3 刷 CasaOS 轻 NAS 系统与远程浏览本地文档或影视资源_哔哩哔哩_bilibili)

首先，我们需要在浏览器中输入香橙派 ip 地址（在路由器中查看名为 orangepizero3 的就是），进入 CasaOS 管理界面。

然后进入终端，使用 root 账号密码登录。

进入终端后执行下方命令：

nano /etc/docker/daemon.json

在编辑器中输入新的镜像源地址：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live"
  ]
}

然后按 Crtl+X 键保存这个镜像源，退出编辑器回到终端后执行下方命令重新启动 docker 服务：

systemctl restart docker

2. 部署 HomeAssistant

上边的操作完成之后，我们回到 casaos 主界面点击系统自带的 App Store 应用中心。

刚安装 casaos 系统会发现里边的应用太少了，想要添加更多应用，只要点击目前 APP 下拉框中的更多应用。

然后点击问号，会自动在浏览器中打开一个添加更多应用的页面：

复制这个页面中的这些地址，然后回到 CasaOS 应用中心界面。

将复制的地址粘贴到刚才带有问号的输入框中，然后点击添加，系统就会自动更新更多应用到应用中心界面，可以从几十个增加到几百个。

在添加应用时，就可以在应用商店中搜索 HomeAssistant，出现后点击安装即可自动进行部署：

时间有点长，耐心等待即可，安装好后点击图标打开：

可以看到，浏览器中打开了 homeassistant 初始化流程界面，地址是香橙派主机 IP+8123 端口：

3. HA 系统初始化配置

首先点击创建我的智能家居按钮，跳转到创建用户界面，填写好信息后点击创建用户：

地区选择，可以手动定位，也可以选择自动检测：

点击下一步：

这里提示发现了兼容的设备，可以先点击完成，后面自己设置：

现在就完成了初始化配置，进入了 HA 系统的管理界面：

4. HA 系统添加智能设备

4.1 添加已发现的设备

首先点击左下角的设置：

选择设备与服务：

在这里可以对已发现的设备进行配置：

拿我现在已发现的这台群晖 NAS 来进行演示，首先点击配置

然后输入你的 NAS 登录账号密码，与 NAS 使用的端口号，点击提交：

稍等 HA 系统既可以自动创建配置，点击完成即可。

现在我们在 Home Assistant 的首页，即可看到新增了群晖 NAS 设备的相关信息。

4.2 添加 HACS 插件安装设备

如果想配置没有发现的智能设备，我们可以通过安装 HACS 插件的方式来添加设备。

首先，我们点击 casaos 终端，依然通过 root 账号密码登录:

执行下方命令，查看安装的所有容器信息：

docker ps -a

复制 HomeAssistant 容器的 ID

然后执行下方命令

docker exec -it 容器ID bash

然后执行下方命令安装 hacs 插件：

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

安装完成后，重新打开终端，执行下方命令重启 docker 服务即可：

systemctl restart docker

然后重新打开 Home Assistant 管理界面，点击设置：

选择设备与服务：

点击右下角的添加集成，输入 HACS:

点击 HACS 后，弹出的提示框中全选后点击提交：

然后复制弹出的提示框中的这串字符，点击上方选项 1 中的链接：

然后在打开的 github 页面中登录你的账号，没有的话注册一个，然后登录将这串字符粘贴到里边：点击继续

然后点击 Authorize hacs（授权给 hacs）即可：

最后点击完成即可：

现在我们在刚才的设备与服务界面，就能看到添加的 HACS 插件了：

想要通过 HACS 插件配置未发现的智能设备，我这里拿小米的小爱音箱来进行演示。

我们首先回到 Home Assistant 管理界面的首页，点击侧边栏中的 HACS，下载存储库。

可以看到下方第一个 Xiaomi Miot Auto 就是，点击图标跳转后点击右下角的下载按钮：

在弹出的对话框中继续点击下载：

完成后在设置中会看到要求重启 HA 的通知：

点击提示图标后，点击提交：

等待一会 HA 重启后，会自动刷新管理界面，点击 HACS，可以看到成功安装了 Xiaomi Miot Auto：

然后点击左下角设置-设备与服务-右下角添加集成：

搜索刚才安装的 Xiaomi Miot Auto 并点进来：

根据自己情况选择账号集成或局域网集成，点击下一步：

然后输入小米账户密码后，点击提交：

然后在筛选设备中选择包含，在设备列表中找到我要添加的小爱音箱，点击提交即可：

点击完成

现在我们在 HA 系统首页就能看到添加的小爱音箱，并可以进行相关管理了。

5. 安装 cpolar 内网穿透

此时，我们已经成功在本地的 CasaOS 香橙派 Zero3 主机中部署了 Home Assistant 智能家居系统，并安装了 HACS 插件实现对未发现设备的集成配置，但目前我们仅能在本地局域网中使用 HA 系统，有一定局限性。如果想在出差时也能远程访问家中的 HA 系统来管理家中智能设备，比如要到家前想提前开好空调时该怎么办呢？

很简单，只要在香橙派中安装一个 cpolar 内网穿透工具就能轻松实现远程访问内网主机中部署的服务了，接下来介绍一下如何安装 cpolar 内网穿透。

首先，点击左上角进入终端：

输入 root 账号密码登录：（不知道如何获取密码可以看上文中提到的刷机教程）

后在终端中执行下方一行命令，即可安装 cpolar 内网穿透工具：

curl -fsSL https://get.cpolar.sh | sudo sh

安装完毕后可以执行下方命令查看服务状态：

systemctl status cpolar

如下图所示即为 cpolar 内网穿透服务正在正常运行。

5.1 配置 HA 公网地址

然后我们使用 CasaOS 香橙派的 IP 地址加上 9200,打开一个新的浏览器来登录 cpolar 管理界面 ：

PS:香橙派的 IP 地址可以在路由器中查看，名为 orangepizero3 的就是。

如果没有账号可以点击免费注册访问 cpolar 官网注册账号：https://www.cpolar.com

输入账号密码登录 cpolar web UI 管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

隧道名称：可自定义，注意不要与已有的隧道名称重复，本例使用了：home assistant

协议：http

本地地址：香橙派主机 IP+8123 端口

域名类型：随机域名

地区：选择 China Top

点击创建

隧道创建成功后，点击左侧的状态——在线隧道列表,查看所生成的公网地址，然后复制地址

打开浏览器,使用刚刚获取的公网地址进行连接访问,此时会出现一个 400 的错误,如果没有的话,可以跳过此步骤:

如报错我们需要查看日志看一下提示具体错误，点击左下角设置，点击系统：

点击日志：

打开日志后,我们可以看到这么一个问题,大致意思是:从 192.168.x.x 收到来自反向代理的请求，但 HTTP 集成未针对反向代理进行设置,所以我们需要修改一下配置文件：

首先回到 casaos 香橙派界面：

点击文件按钮：

然后进入 DATA-AppData-homeassistant 这个文件夹：

继续进入 config 文件夹：

然后点击打开这个名为 的配置文件，添加下方配置并保存：

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.50.215（替换为你的香橙派主机IP）

然后进入 casaos 终端，执行下方命令重启 docker 服务：

systemctl restart docker

重启完毕后，此时我们在浏览器中使用刚才通过 cpolar 创建的公网地址，就可以成功远程访问本地部署的 Home Assistant 智能家居系统了：

小结

为了方便演示，我们在上边的操作过程中使用 cpolar 生成的公网地址是随机生成的。这种随机地址的优势在于建立速度快，可以立即使用。然而，它的缺点是网址是随机生成，不好记，而且这个地址在 24 小时内会发生随机变化，更适合于临时测试使用。

如果有长期远程访问本地 casaos 香橙派中的 Home Assistant 智能家居系统，或者远程访问其他本地服务的需求，又不想每天重新配置公网地址，还想地址好看又好记，那我推荐大家选择配置固定的公网地址来远程访问。

6. 配置固定公网地址

登录 cpolar 官网，点击左侧的预留，选择保留二级子域名，地区选择 China VIP，设置一个二级子域名名称，点击保留，保留成功后复制保留的二级子域名名称，这里我填写的是 myha001 ，大家也可以自定义喜欢的名称。

保留成功后复制保留成功的二级子域名的名称： myha001 ，返回登录 Cpolar web UI 管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道 home assistant，点击右侧的编辑：

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名：myha001
• 地区：选择 China VIP

点击更新(注意,点击一次更新即可,不需要重复提交)

更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,由随机地址名称变成了两个固定的二级子域名(固定公网地址)：

使用任意一个固定公网地址在浏览器访问,可以看到访问成功,这样一个固定且永久不变的公网地址就设置好了，随时随地都可以远程访问本地局域网内的 casaos 香橙派主机端中的 Home Assistant 智能家居系统了！

以上就是如何在 CasaOS 轻 NAS 系统香橙派 zero3 中部署 Home Assistant 智能家居系统，并安装 HACS 插件结合 cpolar 内网穿透工具配置固定不变的二级子域名公网地址，实现随时随地远程管理家中智能设备的全部流程，感谢您的观看，有任何问题欢迎留言交流。