企业官网建设流程全解析

Home Assistant 入门教程：本地智能家居自动化搭建的 7 步路线图

【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core

Home Assistant 是一款开源的本地智能家居平台：把各品牌的智能设备收进一块本地面板，用免代码自动化代替手动切 APP。只要你有一台树莓派、NAS 或闲置小主机，跟着这篇文章走，10 分钟能跑通第一个联动。

30 秒自测：本地智能家居适合你吗

先做一道判断题。同样一个"回家开灯"，两套体系的差别是这样的：

适合你，如果：设备来自 2 个以上品牌、想要跨品牌联动、在意数据不出门、家里有一台可以 7×24 通电的机器。

不适合你，如果：只有 1~2 台设备且无联动需求、找不到一台常开主机、无法接受哪怕半小时的初始配置。

判断结果明确再继续。装错的代价不是钱，是闲置的硬件。

Home Assistant 装之前备什么：硬件与网络清单

硬件三选一：

网络三件事：

1. 路由器上留一个 2.4G 频段的 SSID，绝大多数智能设备只认它；
2. 主机本身走有线，别和 WiFi 设备抢信道；
3. 给主机分配固定 IP（DHCP 保留），不然面板地址会飘。

可验证结果：手机和主机同网段，ping 主机IP能通；2.4G 列表里能看到设备要连的那个 SSID。两项都过了再往下走。

Home Assistant 怎么装：三条路径选一条

路径一：官方镜像（纯新手，推荐）

从官方渠道下载对应机型的镜像（树莓派选raspberrypi4-64或raspberrypi5-64），写入存储卡/SSD，通电。浏览器访问http://主机IP:8123，初始向导约 5 分钟：填地理位置、时区、创建账号。

路径二：Docker（有 NAS 或闲置主机）

一条命令，配置目录持久化，时区按自己改：

# 后台运行 Home Assistant 容器，配置保存在 /data/homeassistant docker run -d --name homeassistant \ --restart=unless-stopped -e TZ=Asia/Shanghai \ -v /data/homeassistant:/config \ --network=host ghcr.io/home-assistant/home-assistant:stable

路径三：源码（开发者）

克隆仓库https://gitcode.com/GitHub_Trending/co/core，建虚拟环境，依赖清单见 requirements.txt，然后用python -m homeassistant --config config启动。适合要读代码或提 PR 的人，日常使用不必走这条路。

可验证结果：无论哪条路径，http://主机IP:8123能登录、看到状态总览页，安装就算完成。

Home Assistant 自动化配置：日落自动开灯 🌆

第一个自动化只做一件事：日落前 20 分钟，书房台灯自动亮到 60%。全程不碰代码。

界面路径：设置 → 自动化与场景 → 自动化 → 新建 → 使用对话式编辑器：

1. 触发条件选"时间"类，事件选"日落"，偏移量填-00:20:00；
2. 动作选"打开灯"，目标实体填你的台灯，亮度设 60%；
3. 保存。不等天黑：开发者工具 → 操作里手动调用一次light.turn_on，确认实体和动作都对。

可验证结果：当晚日落前 20 分钟台灯自己亮起；或者手动测试时灯真的开了。

偏爱 YAML 的话，效果等价的写法：

# automations.yaml：日落前 20 分钟点亮书房台灯 - alias: 日落开灯 trigger: - trigger: sun event: sunset offset: "-00:20:00" action: - action: light.turn_on target: entity_id: light.study data: brightness_pct: 60

之后 90% 的自动化都是这三个槽位的组合：什么时候发生（trigger）、要不要执行（condition）、执行什么（action）。

智能家居设备怎么接入 Home Assistant：五类设备逐个说

统一入口：设置 → 设备与服务 → 添加集成，输入品牌名，多数设备会被自动发现。components 集成目录 里有 1500 多个内置集成；买设备前可以先翻 brands 品牌目录，上百个品牌文件在，基本意味着有官方集成可用。

灯光

Hue 同网段会自动弹出，按一下网桥按钮完成配对；小米系走 Xiaomi Miio / Xiaomi Aqara 集成，输入账号或扫码；被 Tuya 生态覆盖的国产 WiFi 灯直接走 Tuya 集成。注意：灯先确认连的是 2.4G 频段，5G 频段很多灯根本搜不到。

窗帘

多数走品牌云集成（如 Aqara、Dooya）；追求稳定性的，刷 ESPHome 固件后本地接入，响应和可靠性最好。首次配网尽量站在窗边操作，信号弱的房间配网会反复失败。

音箱与投屏

Sonos、Apple TV 等都有官方集成，接入后自动化可以直接调音量、播播单。投屏类设备记得走 Google Cast 集成，而不是品牌 APP 的私有协议，否则只能"看到"不能"控制"。

传感器

温湿度、门窗、人体这类，Zigbee 协议建议先把协调器配好再让 Home Assistant 接管（ZHA），比逐台走云省事得多。电池供电的传感器别开高频轮询，否则电池寿命直接砍半。

门锁

支持 HomeKit 或 Matter 的锁最省心，一次配对全屋可用。门锁是高敏感设备，建议单独建一个只有家庭成员可操作的分组，不要混进"全部设备"。

可验证结果：五类设备都能在"实体"列表里找到，并且能被自动化引用——接一个设备，顺手给它配一条最小自动化，别囤积。

Home Assistant 长期运营：每季度花 30 分钟做的五件事 🛡️

1. 备份：设置 → 系统 → 备份，手动存一份，再打开自动备份。每季度把备份文件下载一次，确认能解开，才算真备份。
2. 只记该记的：recorder配置里用include白名单，只收传感器和关键开关，purge_keep_days设为 7。一周后观察历史表体积，应该稳住了。
3. 清理无用集成：多启用一个集成就多一份发现和轮询开销，不用的删掉，别囤。
4. 更新走官方渠道：系统页有更新提示时，先读更新日志再动手，不要手动改源码里的版本号。
5. 本地优先：能走 Zigbee、Matter、ESPHome 这类本地协议的就不走云集成；云集成在你确认过其数据用途之前保持关闭。

可验证结果：备份列表里有一周内生成的文件；跑满一周，历史数据体积不再线性增长。

Home Assistant 问题速查表

把一盏灯交给自动化，剩下的交给路线图：判断、准备、安装、首跑、扩展、运营、排错，每步都有可验证的终点。配置细节各集成都有自己的手册，官方文档入口在 home-assistant.io 网站的 docs 栏目，社区论坛在 community.home-assistant.io，卡住时按品牌关键词搜一下，多半有人踩过同款坑。

【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core