Home Assistant 作为开源的智能家居自动化平台，核心功能是实现跨品牌设备的统一管理，支持 2000 + 种设备接入，无需代码基础就能通过 Web 页面设置自动化场景，适配 Windows、Linux、各类 NAS 系统，尤其适合追求全屋智能统一管控、注重数据隐私的家庭用户，本地控制的特性也让数据无需上云，安全性远高于单一品牌的智能管理 App。

使用 Home Assistant 的过程中发现，虽然它能完美兼容不同品牌设备，但初次部署时需注意 Docker 环境的基础配置，比如端口映射和文件挂载路径的准确性，且接入不同品牌插件时要按指引完成授权，避免因网络或权限问题导致设备无法同步，日常使用中定期备份配置文件也能减少故障恢复的麻烦。

仅依靠局域网使用 Home Assistant 存在明显局限，比如出差时忘关家里的空调、插座，无法远程操作；家人在家需要调整自动化场景，也只能等自己回家后处理，甚至临时想查看传感器数据、调整窗帘开合时间，都受限于物理位置，完全失去了智能家居 "便捷" 的核心意义。

而将 Home Assistant 与 cpolar 内网穿透结合后，这些问题都能解决：无需申请公网 IP、不用修改路由器设置，就能让 Home Assistant 突破局域网限制，在外随时通过手机访问管理面板，关闭闲置设备、调整自动化规则，加密传输的特性也保障了数据安全，既保留了本地控制的隐私优势，又实现了远程管理的灵活性。

真正的实现跨品牌及远程管理按照下面的教程一试便知！

准备好了吗？让我们一起用Home Assistant ，把家里的智能设备 彻底打通，实现跨品牌互联 与全屋控制！

Home Assistant 是一款开源的智能家居自动化平台，专注于本地控制 和隐私保护 。项目托管在GitHub 上，拥有超过 70,000+ Stars，由全球开发者社区共同维护。

它的核心优势在于：

• 跨品牌兼容：支持接入 2000+ 种设备和品牌（米家、Yeelight、飞利浦、vivo 等）
• 本地优先：所有数据处理在本地完成，无需上传云端
• 统一管理：通过 Web 界面集中控制全屋智能设备
• 自动化场景：支持自定义规则，实现设备智能联动
• 完全免费：开源项目，无需付费订阅

简单来说，Home Assistant 就像是一个"万能翻译官"，把不同品牌的设备语言统一翻译，让它们能够互相"对话"，实现真正的全屋智能。

本教程将以 Windows 系统上的 Docker 部署 Home Assistant 作为演示，其他系统如 飞牛NAS 、群晖NAS 同样支持使用 Docker 一键部署 。如果还没有安装 Docker 的小伙伴，可以到cpolar官网参考相应教程进行安装：

首先，电脑摁Win+R 键，输入cmd 回车，打开命令提示符窗口。然后输入如下命令一键部署Home Assistant服务：

docker run -d --name homeassistant --restart=always -p 8123:8123 -v C:dockerhomeassistant:/config --dns 223.5.5.5 --dns 119.29.29.29 --dns 8.8.8.8 docker.1ms.run/homeassistant/home-assistant:stable

如果是Linux系统请执行：

GPT plus 代充 只需 145sudo 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，代表正常运行，接着，浏览器访问如下地址：

GPT plus 代充 只需 145http://localhost:8123

这样，你就成功的部署好了Home Assistant 啦，是不是很简单！接着点击页面上的创建我的智能家居 按钮，进入如下页面创建一个管理员用户：

创建完成后，来到选取地理位置 ，搜索所在地址，选择后点击下一步 即可：

一些相关用户体验计划信息 ，根据自行选择即可，继续下一步 ：

最后，点击完成 即可跳转登录界面 ，登录即可进入主页：

官方仓库地址：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容器内部：

 
  
    
    
 
     
GPT plus 代充 只需 145docker exec -it homeassistant sh
 
    
 
  
    
    
 

进入容器内部后，执行如下命令一键安装HACS商店 （由于国内用户访问GitHub可能存在网络问题，所以这里演示的是极速版的安装方式）：

 
  
    
    
 
     
GPT plus 代充 只需 145wget -O - https://get.hacs.vip | bash - 
 
     
或
 
     
curl -fsSL get.hacs.vip | bash
 
    

提示安装成功 就可以啦：

接着输入如下命令退出容器内部：

GPT plus 代充 只需 145 
  
    
    
 
     
exit
 
    
 
然后执行重启容器的命令：
 
  
    
    
 
     
GPT plus 代充 只需 145docker restart homeassistant
 
    
 
  
    
    
 

回到Home Assistant 的Web页面，点击左下角的设置 按钮，然后点击设备与服务：

进入到如下页面后，点击右下角的添加集成按钮 ，然后搜索hacs 并点击进去：

点击后，弹出如下页面，勾选后点击提交按钮 ：

等待片刻即可成功安装 ，接着访问侧边栏的HACS 即可访问到商店啦：

前面我们已经安装好了HACS插件商店，接下来演示以米家设备为例接入到Home Assistant中。

4.1 安装Xiaomi Home插件

在弹出的页面中点击DOWNLOAD 按钮进行下载：

下载完成后，依次点击左下角设置 ，然后点击需要重启 ，点击提交 进行重启：

4.2 配置接入米家设备

重启完成后，回到前面的添加集成页面 ，搜索Xiaomi Home 即可看到：

点击进入，会弹出风险告知提示 ，点击勾选复选框，然后点击下一步 ：

接着勾选继承网络配置 ，然后继续点击下一步 ：

勾选检测网络依赖项 ，继续点击下一步 ：

点击跳转进行登录 ：

登录完成后，会跳转类似如下的地址，显示无法访问此网站：

 
  
    
    
 
     
GPT plus 代充 只需 145http://homeassistant.local:8123/api/webhook/xxxxxxxxxxxx
 
    
 
  
    
    
 

这是因为域名显示的是homeassistant.local ，我们需要修改域名为我们部署机器的IP地址方式，如：

 
  
    
    
 
     
GPT plus 代充 只需 145192.168.50.222:8123/api/webhook/xxxxxxxxxxxx
 
    
 

可以看到我当前的账号下是有8个智能设备的，勾选导入设备的家庭 ，然后点击下一步进行导入：

可以看到智能设备相关的功能也都进行同步过来了，非常的详细！

如果你手上的手机是 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页面即可选择想要加入的设备啦，然后点击提交 按钮：

点击提交 后，就可以看到设备啦：

5.4 配置蓝心小V快捷指令

前提条件 ：你的手机系统需要是 OriginOS 6.0 或更高版本。

配置步骤如下：

配置完成后，先别急着结束，点击执行按钮测试一下是否正常工作：

看到执行成功 的提示后，打开米家App ，你会发现暖气插座 已经自动打开了！这说明蓝心小V 已经成功控制了米家设备，跨品牌互联搞定啦！

到这里，Home Assistant 的跨品牌互联已经跑起来了，但问题也随之而来------每次想查看 Home Assistant 的概览页面一目了然地看全屋设备状态，或者在地图视图中直观查看设备位置，甚至添加新的智能设备到 Home Assistant，都得守在家里操作。万一人在外面，想临时查看或管理，那就只能干着急。

有了 cpolar 内网穿透 ，这些烦恼就迎刃而解了。只需简单配置，就能随时随地通过公网访问 Home Assistant 管理面板，远程查看设备状态、控制全屋智能、修改自动化场景，统统不在话下。

6.1 什么是cpolar?

• cpolar 是一款内网穿透工具，可以将你在局域网内运行的服务（如本地 Web 服务器、SSH、远程桌面等）通过一条安全加密的中间隧道映射至公网，让外部设备无需配置路由器即可访问。
• 广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台，并提供一键安装脚本方便部署。

6.2 下载cpolar

打开cpolar官网的下载页面，

点击立即下载 64-bit按钮,下载cpoalr的安装包:

下载下来是一个压缩包,解压后执行目录种的应用程序,一路默认安装即可,安装完成后,打开cmd窗口输入如下命令确认安装:

 
  
    
    
 
     
GPT plus 代充 只需 145cpolar version
 
    
 
  
    
    
 

出现如上版本即代表安装成功!

6.3 注册及登录cpolar web ui管理界面

访问cpolar官网，点击免费注册按钮，进行账号注册

注册完成后,在浏览器中输入如下地址访问 web ui管理界面:

 
  
    
    
 
     
GPT plus 代充 只需 145http://127.0.0.1:9200
 
    
 
  
    
    
 

输入刚才注册好的cpolar账号登录即可进入后台页面:

点击左侧菜单栏的隧道管理，展开进入隧道列表页面，页面下默认会有 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终端窗口中，输入如下命令进入容器内部：

 
  
    
    
 
     
GPT plus 代充 只需 145docker exec -it homeassistant /bin/sh
 
    
 
  
    
    
 

然后向 configuration.yaml 写入反向代理信任配置：

 
  
    
    
 
     
GPT plus 代充 只需 145cat << 'EOF' >> /config/configuration.yaml 
 
     
http: use_x_forwarded_for: true trusted_proxies:
 
     
- 172.17.0.0/16 
 
     
EOF
 
    

GPT plus 代充 只需 145 
  
    
    
 

接着退出容器内部，重启容器：

 
  
    
    
 
     
GPT plus 代充 只需 145exit 
 
     
docker restart homeassistant
 
    

重启后，刷新页面再次访问：

可以看到成功访问到 Home Assistant 的页面啦！不过随机域名 方式适合预算有限的用户。使用此方式时，系统会每隔 24 小时左右 自动更换一次域名地址。对于长期访问的不太友好，但是该方案是免费 的，如果您有一定的预算，可以查看大纲8 的固定域名方式，且访问更稳定哦。

随机域名虽然免费，但每 24 小时左右会自动更换一次 ，每次变化都要重新记地址、重新分享链接，用起来确实不太方便。如果你希望拥有一个固定不变、简短易记的专属域名 ，只需升级 cpolar 任意付费套餐，即可配置固定二级子域名，彻底告别域名频繁变化的烦恼。下面我们来看看如何操作。

首先，进入官网的预留页面：

GPT plus 代充 只需 145 
  
    
    
 
     
https://dashboard.cpolar.com/reserved
 
    
 
然后，选择预留 菜单，即可看到保留二级子域名 项，填写其中的地区、名称、描述（可不填）项，然后点击保留按钮，操作步骤图如下：
 

列表中显示了一条已保留的二级子域名记录：

• 地区 ：显示为China Top。
• 二级域名 ：显示为homeassistant。

注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主

接着，进入侧边菜单栏的隧道管理下的隧道列表，可以看到名为homeassistant的隧道：

点击编辑按钮进入编辑页面，修改域名类型为二级子域名，然后填写前面配置好的子域名，点击更新按钮：

接着来到状态菜单下的在线隧道列表可以看到隧道名称为homeassistant的公网地址已经变更为二级子域名+固定域名主体及后缀的形式了：

这里以https访问且登录测试一下：

访问成功！