Question

原生 Raspbian 系统

方法一：All-in-one 一键安装（失效）

注意

此安装方法已停止维护，不保证对 0.55.0 及之后 Home Assistant 的可用性。

安装方法

• 下载并烧录 官方 Raspbian 系统，推荐新手使用带有图形化操作界面的 Raspbian with Desktop。

• 如需使用无线网，请在初次启动前，将 TF 卡接入电脑。在 boot 目录下新建 wpa_supplicant.conf 文件，添加以下字段：

country=CN
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
        ssid="WIFI名称"
        psk="WIFI密码"
        key_mgmt=WPA-PSK
        priority=1
    }

• 如需默认开启 SSH 服务，请在 boot 目录下新建名为 ssh 的空白文件；
• 之后插卡正常启动树莓派；
• 进行初始化设置后，任意方式连接使用树莓派终端；
• 在『终端』中输入以下『指令』正式安装 Home Assistant：

curl -O https://raw.githubusercontent.com/home-assistant/fabric-home-assistant/master/hass_rpi_installer.sh && sudo chown pi:pi hass_rpi_installer.sh && bash hass_rpi_installer.sh

---

实现效果

• 创建相关文件夹
• 创建所需的用户账户
• 安装系统及 Python 所需的依赖
• 创建 Python 虚拟环境
• 以 Homeassistant 用户在虚拟环境中安装 Home Assistant
• 安装 Mosquitto 服务，运行在 1883 及 9001 端口上
• 安装 Python-openzwave，创建 OpenZWave 控制面板运行在 /srv/homeassistant/src/open-zwave-control-panel
• 将 Home Assistant 添加至系统自启任务中

---

方法二：手动安装

• 下载并烧录 官方 Raspbian 系统，推荐入门者使用带有图形化操作界面的 Raspbian with Desktop。
• 如需使用无线网，请在初次启动前，将 TF 卡接入电脑。在 boot 目录下新建 wpa_supplicant.conf 文件，添加以下字段：

country=CN
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
        ssid="WIFI名称"
        psk="WIFI密码"
        key_mgmt=WPA-PSK
        priority=1
    }

• 如需默认开启 SSH 服务，请在 boot 目录下新建名为 ssh 的空白文件；
• 插卡正常启动树莓派；
• macOS 用户打开『Terminal』应用，其他系统用户使用任意终端工具（如 putty） ssh 至树莓派：ssh pi@树莓派的IP地址。连接显示器使用的用户请打开桌面 终端 应用
• 建议更改 pi 用户密码: passwd
• 抓取最新源数据：sudo apt-get update，如果速度太慢请参考 此处 更换软件源
• 更新系统：sudo apt-get upgrade -y
• 安装依赖：sudo apt-get install python3 python3-venv python3-pip
• 创建名为 homeassistant 的用户：sudo useradd -rm homeassistant
• 创建安装文件夹

    cd /srv
    sudo mkdir homeassistant
    sudo chown homeassistant:homeassistant homeassistant

• 创建虚拟环境

    sudo su -s /bin/bash homeassistant
    cd /srv/homeassistant
    python3 -m venv .
    source bin/activate

• 安装 Home Assistant：pip3 install homeassistant
• 初次启动 Home assistant：hass
• 等待几分钟让后台下载依赖，之后你便可以从局域网内任意终端浏览器访问 http://树莓派的 IP 地址:8123，进入 Home Asssitant

---