前言
你是否遇到过——家里的智能设备越来越多，可米家、vivo、Yeelight、飞利浦……各种品牌各自为阵，互不兼容，彼此无法联动？想让小 V控制米家的灯，却发现完全不行；想在手机上统一管理全屋设备，又被各种App分散得手忙脚乱……
其实，这一切都可以被彻底解决——只需一个开源神器：Home Assistant。
本教程专为零基础用户打造，无需懂代码、不用复杂配置，只要你有一台支持Docker的Windows或NAS等设备即可，跟着步骤操作，30 分钟内即可完成部署。通过Home Assistant，你可以把各种品牌设备接入统一管理，实现跨品牌互联；所有操作都可以在Web 页面上直观管理，小白也能轻松上手。
从此，家里的智能设备不再各自为阵，你的米家设备、智能插座……都能被统一调度与控制，真正实现“跨品牌全屋智能”——想开哪个就开，想关哪个就关，想自动化执行的场景也能随心设置。
准备好了吗？让我们一起用Home Assistant，把家里的智能设备彻底打通，实现跨品牌互联与全屋控制！
1 什么是Home Assistant？
开源项目地址：https://github.com/home-assistant/core
Home Assistant 是一款开源的智能家居自动化平台，专注于本地控制和隐私保护。项目托管在GitHub上，拥有超过 70,000+ Stars，由全球开发者社区共同维护。
它的核心优势在于：
- 跨品牌兼容：支持接入 2000+ 种设备和品牌（米家、Yeelight、飞利浦、vivo 等）
- 本地优先：所有数据处理在本地完成，无需上传云端
- 统一管理：通过 Web 界面集中控制全屋智能设备
- 自动化场景：支持自定义规则，实现设备智能联动
- 完全免费：开源项目，无需付费订阅
简单来说，Home Assistant 就像是一个”万能翻译官”，把不同品牌的设备语言统一翻译，让它们能够互相”对话”，实现真正的全屋智能。
2 使用Docker一键部署Home Assistant
本教程将以 Windows 系统上的 Docker 部署 Home Assistant 作为演示，其他系统如 飞牛NAS、群晖NAS 同样支持使用 Docker 一键部署。如果还没有安装 Docker 的小伙伴，可以参考这篇教程进行安装：https://www.cpolar.com/blog/docker-installation-linux-windows-macos
首先，电脑摁Win+R键，输入cmd回车，打开命令提示符窗口。然后输入如下命令一键部署Home Assistant服务：
docker run -d --name homeassistant --restart=always -p 8123:8123 -v C:\docker\homeassistant:/config --dns 223.5.5.5 --dns 119.29.29.29 --dns 8.8.8.8 docker.1ms.run/homeassistant/home-assistant:stable
如果是Linux系统请执行：
sudo docker run -d --name homeassistant --restart=always -p 8123:8123 -v /srv/homeassistant:/config --dns 223.5.5.5 --dns 119.29.29.29 --dns 8.8.8.8 docker.1ms.run/homeassistant/home-assistant:stable
执行完成后，可以使用如下命令查看Docker容器状态：
docker ps
可以看到status(状态)显示为UP，端口为8123，代表正常运行，接着，浏览器访问如下地址：
http://localhost:8123
这样，你就成功的部署好了Home Assistant啦，是不是很简单！接着点击页面上的创建我的智能家居按钮，进入如下页面创建一个管理员用户：
创建完成后，来到选取地理位置，搜索所在地址，选择后点击下一步即可：
一些相关用户体验计划信息，根据自行选择即可，继续下一步：
最后，点击完成即可跳转登录界面，登录即可进入主页：
3 安装HACS商店
官方仓库地址：https://github.com/hacs/integration
国内HACS极速版：https://gitee.com/hacs-china/integration
HACS (Home Assistant Community Store) 是 Home Assistant 的一个社区驱动的商店，用于扩展和管理 Home Assistant 的自定义集成和插件。它提供了一个简单的界面，可以帮助用户查找、安装、更新和管理各种第三方组件、卡片、主题等，极大地丰富了 Home Assistant 的功能。
首先，回到cmd终端，执行如下命令进入homeassistant容器内部：
docker exec -it homeassistant sh
进入容器内部后，执行如下命令一键安装HACS商店（由于国内用户访问GitHub可能存在网络问题，所以这里演示的是极速版的安装方式）：
wget -O - https://get.hacs.vip | bash -
# 或
curl -fsSL get.hacs.vip | bash
提示安装成功就可以啦：
接着输入如下命令退出容器内部：
exit
然后执行重启容器的命令：
docker restart homeassistant
回到Home Assistant 的Web页面，点击左下角的设置按钮，然后点击设备与服务：
进入到如下页面后，点击右下角的添加集成按钮，然后搜索hacs并点击进去：
点击后，弹出如下页面，勾选后点击提交按钮：
等待片刻即可成功安装，接着访问侧边栏的HACS即可访问到商店啦：
4 接入智能设备到Home Assistant
前面我们已经安装好了HACS插件商店，接下来演示以米家设备为例接入到Home Assistant中。
4.1 安装Xiaomi Home插件
在弹出的页面中点击DOWNLOAD按钮进行下载：
下载完成后，依次点击左下角设置，然后点击需要重启，点击提交进行重启：
4.2 配置接入米家设备
重启完成后，回到前面的添加集成页面，搜索Xiaomi Home即可看到：
点击进入，会弹出风险告知提示，点击勾选复选框，然后点击下一步：
接着勾选继承网络配置，然后继续点击下一步：
勾选检测网络依赖项，继续点击下一步：
点击跳转进行登录：
登录完成后，会跳转类似如下的地址，显示无法访问此网站：
http://homeassistant.local:8123/api/webhook/xxxxxxxxxxxx
这是因为域名显示的是homeassistant.local，我们需要修改域名为我们部署机器的IP地址方式，如：
192.168.50.222:8123/api/webhook/xxxxxxxxxxxx
修改完成后，直接回车后即可成功授权上，回到Home Assistant页面可以看到：
可以看到我当前的账号下是有8个智能设备的，勾选导入设备的家庭，然后点击下一步进行导入：
可以看到，所有的设备都同步过来啦！这里点击一个进去进行查看：
可以看到智能设备相关的功能也都进行同步过来了，非常的详细！
5 配置VivoHomeBridge实现跨品牌互联
如果你手上的手机是 vivo，而家里的智能设备大部分是 米家，就会遇到一个问题：无法直接通过 vivo 的语音助手“小V”控制这些设备。为了打通这一生态壁垒，实现跨品牌的智能家居控制，我们可以使用 vivohomebridge，它能够将 Home Assistant 中的米家设备桥接到 vivo 智慧生活 App，让“小V”也能轻松控制家里的智能设备。
5.1 什么是VivoHomeBridge？
vivohomebridge 是一个 Home Assistant 自定义集成插件，它可以将 Home Assistant 平台中的各种智能设备桥接到 vivo 智慧生活生态，让不同品牌的设备在 vivo App 中统一显示和控制，实现跨品牌联动和语音控制。
- 桥接 Home Assistant 与 vivo 智慧生活，实现设备同步
- 支持跨品牌设备在 vivo 平台统一控制和自动化联动
- 兼容 vivo 语音助手和快捷指令，融入 vivo 原生智能生态
5.2 安装VivoHomeBridge插件
进入HACS商店，搜索VivoHomeBridge，然后进行下载：
下载完成后，进入设置页面，点击需要重启，然后点击提交：
5.3 配置VivoHomeBridge
回到集成页面，点击添加集成，然后搜索VivoHomeBridge:
在弹出的集成须知中，勾选我已悉知，然后点击下一步：
点击后即可创建成功，然后点击进入VivoHomeBridge：
进入后，点击小齿轮图标，会弹出一个二维码：
在手机上应用商店下载一个【智慧生活】APP,然后
手机APP上点击继续后，回到Web页面即可选择想要加入的设备啦，然后点击提交按钮：
点击提交后，就可以看到设备啦：
回到手机端也可以看到，连接中心、APP内都显示了添加的设备，且可以正常控制：
5.4 配置蓝心小V快捷指令
前提条件：你的手机系统需要是 OriginOS 6.0 或更高版本。
配置步骤如下：
配置完成后，先别急着结束，点击执行按钮测试一下是否正常工作：
看到执行成功的提示后，打开米家App，你会发现暖气插座已经自动打开了！这说明蓝心小V已经成功控制了米家设备，跨品牌互联搞定啦！
6 下载安装cpolar
到这里，Home Assistant 的跨品牌互联已经跑起来了，但问题也随之而来——每次想查看 Home Assistant 的概览页面一目了然地看全屋设备状态，或者在地图视图中直观查看设备位置，甚至添加新的智能设备到 Home Assistant，都得守在家里操作。万一人在外面，想临时查看或管理，那就只能干着急。
有了 cpolar 内网穿透，这些烦恼就迎刃而解了。只需简单配置，就能随时随地通过公网访问 Home Assistant 管理面板，远程查看设备状态、控制全屋智能、修改自动化场景，统统不在话下。
6.1 什么是cpolar?
- cpolar 是一款内网穿透工具，可以将你在局域网内运行的服务（如本地 Web 服务器、SSH、远程桌面等）通过一条安全加密的中间隧道映射至公网，让外部设备无需配置路由器即可访问。
- 广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台，并提供一键安装脚本方便部署。
6.2 下载cpolar
打开cpolar官网的下载页面：https://www.cpolar.com/download
点击立即下载 64-bit按钮,下载cpoalr的安装包:
下载下来是一个压缩包,解压后执行目录种的应用程序,一路默认安装即可,安装完成后,打开cmd窗口输入如下命令确认安装:
cpolar version
出现如上版本即代表安装成功!
6.3 注册及登录cpolar web ui管理界面
官网链接：https://www.cpolar.com/
访问cpolar官网，点击免费注册按钮，进行账号注册
进入到如下的注册页面进行账号注册：
注册完成后,在浏览器中输入如下地址访问 web ui管理界面:
http://127.0.0.1:9200
输入刚才注册好的cpolar账号登录即可进入后台页面:
7 穿透Home Assistant实现公网访问
点击左侧菜单栏的隧道管理，展开进入隧道列表页面，页面下默认会有 2 个隧道：
- remoteDesktop隧道，指向3389端口，tcp协议
- website隧道，指向8080端口，http协议（http协议默认会生成2个公网地址，一个是http，另一个https，免去配置ssl证书的繁琐步骤）
点击编辑website的隧道，这里设置名称为homeassistant方便辨识，然后本地地址填写8123端口系统的访问地址，地区这里选择的China Top，然后点击更新：
接着，点击左侧菜单的状态菜单，接着点击在线隧道列表菜单按钮，可以看到有2个homeassistant的隧道，一个为http协议,另一个为https协议:
接下来在浏览器中访问homeassistant隧道生成的公网地址，这里以https为例：
可以发现报错出现了400异常，页面无法正常加载。原因是Home Assistant 默认不信任来自 反向代理或隧道的请求，所以我们需要写入写入反向代理信任配置来解决该问题。
首先，在cmd终端窗口中，输入如下命令进入容器内部：
docker exec -it homeassistant /bin/sh
然后向 configuration.yaml 写入反向代理信任配置：
cat << 'EOF' >> /config/configuration.yaml
http:
use_x_forwarded_for: true
trusted_proxies:
- 172.17.0.0/16
EOF
接着退出容器内部，重启容器：
exit
docker restart homeassistant
重启后，刷新页面再次访问：
可以看到成功访问到 Home Assistant 的页面啦！不过随机域名方式适合预算有限的用户。使用此方式时，系统会每隔 24 小时左右自动更换一次域名地址。对于长期访问的不太友好，但是该方案是免费的，如果您有一定的预算，可以查看大纲8的固定域名方式，且访问更稳定哦。
8 固定二级子域名
随机域名虽然免费，但每 24 小时左右会自动更换一次，每次变化都要重新记地址、重新分享链接，用起来确实不太方便。如果你希望拥有一个固定不变、简短易记的专属域名，只需升级 cpolar 任意付费套餐，即可配置固定二级子域名，彻底告别域名频繁变化的烦恼。下面我们来看看如何操作。
首先，进入官网的预留页面：
https://dashboard.cpolar.com/reserved
然后，选择预留菜单，即可看到保留二级子域名项，填写其中的地区、名称、描述（可不填）项，然后点击保留按钮，操作步骤图如下：
列表中显示了一条已保留的二级子域名记录：
- 地区：显示为China Top。
- 二级域名：显示为homeassistant。
注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主
接着，进入侧边菜单栏的隧道管理下的隧道列表，可以看到名为homeassistant的隧道：
点击编辑按钮进入编辑页面，修改域名类型为二级子域名，然后填写前面配置好的子域名，点击更新按钮：
接着来到状态菜单下的在线隧道列表可以看到隧道名称为homeassistant的公网地址已经变更为二级子域名+固定域名主体及后缀的形式了：
这里以https访问且登录测试一下：
访问成功！
总结
本教程带你从零搭建了一个基于 Home Assistant 的全屋智能管理系统，实现了跨品牌设备的统一接入与控制，并通过 cpolar 内网穿透让服务支持公网访问。从最初的品牌各自为阵、App 分散管理，到如今的统一调度、语音控制、远程管理，你的智能家居体验已经完成了质的飞跃。
- 核心部署：通过 Docker 一键安装 Home Assistant，30 分钟内即可完成基础环境搭建
- 跨品牌互联：借助 HACS 商店安装 Xiaomi Home 和 VivoHomeBridge 插件，轻松打通米家与 vivo 生态壁垒
- 公网访问：配置 cpolar 内网穿透，支持随机域名（免费）和固定二级子域名（付费）两种方案，随时随地远程管理全屋设备
通过本教程，你可以快速搭建一个真正跨品牌的全屋智能系统，既能统一管理米家、vivo、Yeelight 等不同品牌设备，也能通过蓝心小V语音助手实现快捷指令控制，还能在外出时随时查看和管理家里的智能设备，真正实现”智能家居，随心而动”。
感谢您阅读本篇文章，有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站
