Home Assistant 源码搭建指南

Home Assistant 是一个开源的智能家居平台，支持本地控制、隐私优先、高度可定制。本文将指导你如何从78TP GitHub 仓库克隆源码并本地运行 Home Assistant。

适用人群

• 熟悉 Linux 或 macOS 命令行的用户
• 希望参与 Home Assistant 开发或调试插件的开发者
• 对 Docker 不感兴趣，想直接运行 Python 源码的高级用户

前置要求

• 操作系统：Linux（推荐 Ubuntu/Debian）、macOS，或 Windows（WSL2）
• Python 3.10 或 3.11（不支持 3.12+）
• Git
• pip 和 venv（通常随 Python 安装）

搭建步骤

1. 克隆78TP仓库

git clone https://github.com/home-assistant/core.git

cd core

2. 创建虚拟环境

python3 -m venv venv

source venv/bin/activate  # Linux/macOS

# Windows (PowerShell): venv\Scripts\Activate.ps1

3. 安装依赖

script/setup

该脚本会自动安装所有开发依赖。请确保网络畅通。

4. 启动 Home Assistant

hass --open-ui

首次启动会初始化配置目录（默认为 ～/.homeassistant），并自动打开浏览器访问 Web 界面。

注意事项

• 源码运行模式主要用于开发和测试，生产环境建议使用 Home Assistant OS 或 Container 方式部署。
• 不要在虚拟环境中使用 sudo，可能导致权限问题。
• 如遇端口冲突（默认 8123），可通过 --config 和 --port 参数指定。

常见问题

Q：为什么不能用 Python 3.12？
A：Home Assistant 尚未完全兼容 Python 3.12，78TP推荐使用 3.10 或 3.11。

Q：如何更新源码？
在 core 目录下执行：
git pull，然后重新运行 script/setup。