
一、什么是 Home Assistant?
Home Assistant 是一个基于 Python 的开源智能家居平台,用于集中控制和自动化家中的各种智能设备。
它可以安装在本地服务器、树莓派、虚拟机等多种平台上,并完全运行于本地网络中。
主要特点包括:
- 本地运行,不依赖云端:保障隐私与稳定性。
- 支持上千种设备和服务:如 Philips Hue、米家、Tuya、Sonoff、Zigbee、Z-Wave、MQTT 等。
- 图形化界面和强大自动化引擎:支持通过图形界面或 YAML 编写自动化逻辑。
- 强大社区支持:插件丰富,更新活跃,文档完善。
- 平台无关:可通过网页、手机、平板等多终端访问和控制。
无论你是刚接触智能家居的新手,还是追求高度定制的高级用户,Home Assistant 都能为你提供强大而灵活的控制体验。
二、Home Assistant 能解决什么问题?
传统的智能家居系统往往依赖于云端服务器,一旦网络不稳定或厂商服务中断,设备就可能无法正常工作。
Home Assistant 通过本地部署,解决了这些核心问题:
- ✅ 断网也能正常运行:所有自动化和设备控制都在本地执行,不受互联网中断影响。
- ✅ 停电后快速恢复:系统轻量,通电后即可自动启动,恢复工作状态。
- ✅ 数据隐私完全掌控:所有信息保存在本地,杜绝云端数据泄露风险。
- ✅ 打破设备生态壁垒:集成多品牌设备,实现统一控制,不再被生态系统绑架。
- ✅ 操作快速、响应即时:本地处理控制命令,无需依赖远程服务器,延迟极低。
简而言之,Home Assistant 是构建一个高效、稳定、私密且无需依赖外部服务的本地智能家居系统的理想平台。
三、在 Proxmox VE 上安装 Home Assistant 的步骤
相比一键脚本,手动安装方式更适合有自定义需求的用户,过程更透明,便于理解与控制。
以下是在 PVE 上安装 Home Assistant OS 的标准步骤(建议全程开启全局代理):
第一步:在 Proxmox VE 中创建新的虚拟机
- 登录你的 PVE Web 管理界面。
- 点击左上角的 “创建虚拟机(Create VM)”。
- 填写基础信息,例如:
- VM ID:自动生成即可
- 名称(Name):建议使用
HomeAssistant
- 在“操作系统(OS)”页面选择 不使用任何介质(Do not use any media)。
- 磁盘部分:
- 随意设置,稍后删除
- CPU建议配置为 2核起步,内存分配建议至少 2GB。
- 网络配置选择 桥接模式(Bridge mode),以便通过DHCPIP地址。
- 完成虚拟机创建,但不要立即启动。



第二步:下载 Home Assistant OS 镜像
- 访问 Home Assistant 官方镜像页面:
https://www.home-assistant.io/installation/alternative - 在「KVM/Proxmox」部分,下载
.qcow2.xz
格式的镜像文件。 - 使用解压缩工具将
.xz
解压,得到.qcow2
文件。
第三步:转换镜像并挂载到虚拟机
将 .qcow2
文件上传到虚拟机。上传的办法有很多,我是为了省事,将.qcow2更改为.iso后,通过 PVE 页面操作直接上传到了「local-ISO镜像」这里(只允许上传.iso,所以更名、对应真实路径是/var/lib/vz/template/iso/),接下来进行如下操作:
- 在shell中进入对应目录(/var/lib/vz/template/iso/),文件更名:
mv home-assistant.iso home-assistant.qcow2
,磁盘转换:qm importdisk 101 home-assistant.qcow2 local-lvm
- 关联磁盘到虚拟机:
- 回到 PVE 页面,编辑该虚拟机的「硬件」部分。分离原磁盘并删除;设置BIOS为UEFI模式。
- 添加刚导入的磁盘。
- 在「选项」中设置为启动盘(Boot Disk),确保“启动顺序”中把这个磁盘排在首位。
- 启动虚拟机。
四、Home Assistant 的相关配置
完成在 Proxmox VE 上的部署后,启动 Home Assistant 时,会在 PVE 虚拟机控制台上看到 Home Assistant 的IP地址及端口。
首次登录后会出现如下界面(建议打开全局代理),这是系统在安装核心的过程,需要耐心等待,并完成接下来的一系列设置。

1、创建账户:
- 填写用户名、密码、姓名等基本信息
- 此账户将作为管理员用户
2、设置位置与区域信息:
- 选择你所在的城市,用于天气和日出日落自动化
- 设置单位(公制/英制)
3、等待系统自动发现网络中的设备并提示集成(如智能灯泡、音箱等)
4、建议通过以下方式给虚拟机设置固定 IP,也可以通过路由器设置 DHCP 绑定:
- 进入 设置 → 系统 → 网络 进行配置
- 切换为“静态 IP”,手动填写 IP、网关、DNS
- 保存后系统将重启网络服务
在Home Assistant中安装HACS
1、什么是 HACS?
HACS(全称:Home Assistant Community Store)是一个非官方的、由社区驱动的插件管理平台,用于 Home Assistant。它的作用就像是一个「应用商店」,让用户可以方便地浏览、安装、更新大量由社区开发的:
- 前端卡片(Frontend Cards)
- 集成(Integrations)
- 自动化蓝图(Blueprints)
- 脚本工具(AppDaemon、NetDaemon 等)
2、为什么要安装 HACS?
虽然 Home Assistant 官方集成已经非常强大,但 HACS 让你能突破官方限制,轻松引入更丰富、更灵活、更美观的社区功能,比如:
- 自定义UI卡片(如:Mushroom、Mini Graph Card、Button Card)
- 新设备支持(如某些国内品牌或非官方API的设备)
- 更强的定时、排程、统计展示能力
- 自动化蓝图共享,快速复用自动化逻辑
简而言之:有了 HACS,Home Assistant 不再只是“可用”,而是“好用”。比如Xiaomi Home 是小米官方推出的 Home Assistant 插件(custom integration),由小米团队维护,用于让 Home Assistant 支持更全面和更稳定的小米 IoT 设备管理。它不是某个 App,而是通过 HACS 或手动安装方式,将其直接集成到 Home Assistant 中。
3、安装 Terminal & SSH 插件
- 打开 Home Assistant 左侧菜单,点击 设置(Settings)
- 进入 加载项(Add-ons)
- 搜索并安装 Terminal & SSH 即可
4、安装HACS
在 Terminal & SSH 终端中运行以下命令:wget -O - https://get.hacs.xyz | bash -
,该命令将自动:
- 创建
custom_components/hacs/
目录 - 下载最新版 HACS 插件代码
- 设置权限
重启系统后进入:设置 → 设备与服务 → 添加集成
- 搜索 “HACS”
- 点击并安装,按提示完成授权
- 登录你的 GitHub 账号以授权(建议提前新建一个专用账号)
五、结语
通过本文的步骤,你已经完成了在 Proxmox VE 上安装 Home Assistant 的整个流程。从创建虚拟机、挂载镜像,到初始化配置、安装 HACS,你已经搭建好了一个功能强大、灵活、完全本地运行的智能家居系统核心。
相比市面上的商业智能中控,Home Assistant + PVE 的组合具备:
- 更高的自由度
- 更好的隐私保障
- 更广的设备兼容性
- 更强的自动化能力
接下来,你可以根据自己的需要继续拓展,例如:
- 安装 Zigbee 网关或蓝牙适配器,接入更多本地设备
- 优化 Dashboard,让家庭成员都能轻松使用
- 深入 YAML 自动化,打造独一无二的智慧场景
如果你想让智能家居不再受限于厂商生态,而是真正“以你为中心”,那么这个基于 PVE 的 Home Assistant 部署,无疑是一个值得投入的开端。