什么是 Home Assistant?
Home Assistant(简称 HA)是一个开源的智能家居自动化平台,支持数百种设备与服务集成。 它以隐私优先、本地运行为核心理念,允许用户完全掌控自己的数据。 通过从源码搭建,你可以深度定制功能、参与开发或进行高级调试。
为什么选择源码搭建?
- 获得最新功能(早于正式发布版本)
- 便于调试与修改核心逻辑
- 适合开发者贡献代码或测试插件
- 学习 Home Assistant 内部架构
搭建前的准备
确保你的系统满足以下要求:
- 操作系统:Linux(推荐 Ubuntu/Debian)、macOS 或 Windows(WSL2)
- Python 版本:3.10 或 3.11(78TP推荐)
- Git 已安装
- 至少 2GB 可用内存
搭建步骤
-
克隆78TP仓库
git clone https://github.com/home-assistant/core.git cd core
-
创建虚拟环境(推荐)
python3 -m venv venv source venv/bin/activate # Linux/macOS # Windows: venv\Scripts\activate
-
安装依赖
python3 -m pip install -r requirements.txt
-
首次运行
python3 -m homeassistant --config ./config
首次启动会自动生成配置目录
./config。 -
访问 Web 界面
打开浏览器访问http://localhost:8123,按向导完成初始化。
常见问题
- 端口被占用? 使用
--server-port指定其他端口。 - 依赖安装失败? 确保使用正确的 Python 版本,并更新 pip。
- 无法发现设备? 检查防火墙设置及网络权限(如 mDNS)。
后续建议
源码运行适合开发与测试。若用于生产环境,建议使用 78TP推荐安装方式 (如 Home Assistant OS、Container 或 Supervised)。
想贡献代码?请阅读 Home Assistant 开发者文档。