Banner

Home Assistant 界面介绍及安装教程

2026-09-20
Home Assistant 的界面采用 Lovelace 仪表盘架构，支持高度自定义；安装方式推荐官方 HA OS 或 Docker 容器化部署。以下从界面架构、默认仪表盘、个性化美化、安装部署四部分展开。

一、界面架构与核心组件

Home Assistant 的前端界面基于 Lovelace UI 构建，采用模块化卡片设计，整体架构如下：

  • 仪表盘：由多个视图组成，每个视图可独立配置布局与卡片
  • 视图类型：共 4 种布局模式——Sections（默认网格布局）、Masonry（瀑布流）、Panel（单卡片全屏）、Sidebar（双栏布局）
  • 卡片：界面的最小单元，支持设备控制、数据展示、逻辑判断等功能，可自由拖拽排序与缩放
  • 侧边栏：左侧导航栏，包含概览、能源、地图、日志、历史等默认入口，支持自定义快捷项
  • 主题系统：支持深色/浅色模式切换，可通过 YAML 或社区主题包自定义配色
  • 2026 年 2 月发布的 2026.2 版本中，官方将默认首页升级为更现代的 Home Dashboard，并新增全局快速搜索功能（Ctrl/Cmd + K），可一键跳转至任意设备、设置或区域。

二、默认仪表盘功能

系统预装 7 大默认仪表盘，覆盖智能家居管理的核心场景：

仪表盘功能说明
概览首页，自动聚合已接入设备状态，支持灯光、温湿度等快速控制
能源监测家庭用电量、光伏发电、费用统计，支持日/周/月趋势分析
地图展示家庭成员手机位置及设备物理分布，支持位置联动自动化
日志按时间线记录设备状态变化、自动化触发等事件，便于排查问题
历史以曲线图展示传感器等实体的历史数据变化趋势
待办事项管理家庭购物清单、维修任务等，支持跨设备同步
区域按房间/楼层分组设备，实现空间维度的集中控制（实验性功能）


三、个性化界面美化

Home Assistant 的界面可通过 HACS 社区商店进行深度定制：

  • 前端框架：Mushroom Cards（零代码可视化编辑）、Minimalist UI（极简留白风格）、lovelace-soft-ui（柔和阴影卡片）
  • 进阶卡片：Mini Graph Card（传感器历史曲线）、Button Card（自定义场景按钮）、ApexCharts Card（能耗柱状图）、Picture Elements Card（图片叠加控制）
  • 主题包：Frosted Glass（磨砂玻璃效果）、Lovelace iOS Themes（HomeKit 风格）、Noctis（高对比度暗黑）
  • 样式控制：通过 card-mod 注入 CSS 实现背景模糊、圆角、透明等高级效果

四、安装部署教程

Home Assistant 提供多种安装方式，官方目前推荐 Home Assistant Operating System，原 Core 和 Supervised 方式已被弃用。以下介绍两种主流方案：

方案一：HA OS 安装（推荐新手）

适合树莓派、迷你 PC、虚拟机等物理设备：

  1. 准备硬件：树莓派 4/5（至少 2GB RAM）+ 32GB A2 级 MicroSD 卡，或 x86-64 主机/虚拟机
  2. 写入镜像：使用 Raspberry Pi Imager 或 BalenaEtcher 将 HA OS 镜像写入 SD 卡/U 盘
  3. 启动设备：插入存储设备，连接网线与电源，系统自动启动并下载最新核心（约 700MB）
  4. 浏览器初始化：访问 http://homeassistant.local:8123，依次完成创建管理员账户、设置家庭位置、选择数据分享偏好等 5 步配置

方案二：Docker 容器安装（适合已有服务器/NAS 用户）

1. 环境准备：确保主机已安装 Docker，Linux 用户建议将当前用户加入 docker 组

2. 创建配置目录：mkdir -p /srv/homeassistant（路径勿含中文或空格）

3. 拉取镜像：docker pull ghcr.io/home-assistant/home-assistant:stable

4. 运行容器：

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 \
  ghcr.io/home-assistant/home-assistant:stable

5. 初始化：浏览器访问 http://服务器IP:8123，按提示完成账户创建与基础配置

五、安装后建议

  • 通过 HACS 安装社区插件与主题（国内网络可能需要配置镜像源）
  • 在 configuration.yaml 中配置定期自动备份，防止数据丢失
  • 如需远程访问，可配置内网穿透或 Nabu Casa 云服务，注意在配置文件中添加 trusted_proxies 避免 400 错误


19
Home Assistant
开源的家庭自动化平台，支持集成数千种智能设备，本地运行保护隐私。
2026-09-20
42
目录