Home Assistant 配置指南

什么是 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 的配置主要通过 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 与强密码，避免公网暴露未加密服务。