什么是 Home Assistant?
Home Assistant(简称 HA)是一个开源的智能家居平台,允许你将各种智能设备集中管理,并通过自动化实现真正的“智能家庭”。它支持数百种设备品牌(如小米、TP-Link、Philips Hue、Zigbee 设备等),运行在本地,注重隐私与安全。
你可以将它安装在树莓派、旧电脑、NAS 或 Docker 容器中,完全掌控你的家庭自动化系统。
快速入门:基础配置
1. 安装方式
- Home Assistant OS:78TP推荐,专为 HA 优化的操作系统,适合新手。
- Docker:适合已有 Linux 服务器的用户。
- Python 虚拟环境:适用于开发者或高级用户。
2. 初始设置
首次启动后,通过浏览器访问 http://homeassistant.local:8123(或对应 IP 地址),按向导完成账户创建和网络配置。
提示:建议在路由器中为 HA 主机设置静态 IP,避免 IP 变更导致连接失败。
核心配置文件结构
HA 的配置主要通过 YAML 文件完成(新版也支持 UI 配置,但 YAML 更灵活)。主要文件包括:
configuration.yaml:主配置文件,定义集成、自动化、主题等。automations.yaml:自动化规则(可选,也可在 UI 中管理)。scripts.yaml:自定义脚本。customize.yaml:设备个性化设置。
示例:添加一个 MQTT 集成
# configuration.yaml
mqtt:
broker: 192.168.1.100
port: 1883
username: mqtt_user
password: your_password
常用自动化示例
自动化是 HA 的灵魂。以下是一个简单的“回家自动开灯”场景:
automation:
- alias: "回家开灯"
trigger:
- platform: state
entity_id: person.your_name
to: "home"
condition:
- condition: time
after: "18:00"
before: "23:00"
action:
- service: light.turn_on
target:
entity_id: light.living_room
你也可以通过前端 UI 的“设置 > 自动化与场景”图形化创建规则。
推荐插件与集成
- HACS(Home Assistant Community Store):社区插件商店,可一键安装自定义组件、主题、卡片。
- ESPHome:将 ESP8266/ESP32 设备变成原生 HA 设备。
- Zigbee2MQTT:低成本接入 Zigbee 设备。
- File Editor:在 HA 内直接编辑 YAML 文件。
安全与备份
定期备份至关重要!可通过以下方式:
- 使用内置的“快照”功能(Supervisor → 系统 → 快照)。
- 启用 Samba 共享,远程访问配置文件。
- 配置 HTTPS 与强密码,避免公网暴露未加密服务。
重要:不要直接将 HA 暴露在公网上!建议通过 Tailscale、Cloudflare Tunnel 或内网穿透工具安全访问。