基于树莓派4B的智能家居中枢搭建指南

在SD卡 boot 分区根目录创建一个空文件，名为 ssh（无后缀）。这样系统首次启动时会自动开启SSH服务。

预设Wi-Fi信息

在同一目录下创建文件 wpa_supplicant.conf，内容如下：

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

保存后弹出SD卡，插入树莓派，通电启动。 几分钟后，通过路由器后台查看其分配的IP地址，即可用SSH登录：

ssh pi@<树莓派IP> # 默认密码：raspberry

登陆后的第一件事：更新系统

sudo apt update && sudo apt full-upgrade -y
sudo rpi-update # 更新固件（可选）
sudo reboot

同时建议修改默认密码，并设置静态IP，避免下次找不到它。

第二步：部署Home Assistant

为什么不直接刷HA OS？因为我们要的是 自由度。用Docker部署，既能享受隔离性，又能随时添加其他服务。

为什么用Docker？

安装Docker环境

curl -sSL https://get.docker.com | sh
sudo usermod -aG docker pi

重启终端后验证是否成功：

docker --version

启动Home Assistant容器

执行以下命令创建并运行容器：

docker run -d \
--name homeassistant \
--privileged \
--restart=unless-stopped \
-e TZ=Asia/Shanghai \
-v /home/pi/hass-config:/config \
-v /run/dbus:/run/dbus:ro \
--device=/dev/ttyUSB0 \
--device=/dev/ttyACM0 \
-p 8123:8123 \
ghcr.io/home-assistant/home-assistant:stable

解释几个关键参数：

• -v /home/pi/hass-config:/config：将配置文件存在外部目录，防止容器删除后丢失；
• --device=/dev/ttyUSB0：允许容器访问USB串口设备（比如Zigbee棒）；
• -p 8123:8123：开放Web界面端口；
• --privileged：赋予必要权限（安全起见，仅用于HA这类可信容器）。

等待几分钟，访问 http://<树莓派IP>:8123，你会看到熟悉的Home Assistant欢迎页面。 首次进入会引导你设置用户名、密码、位置信息等。完成后就能看到仪表盘了。

第三步：接入Zigbee设备

Wi-Fi设备虽多，但功耗大、电池撑不了几天。真正的智能家居传感器（门磁、人体感应、温控阀），大多走的是 Zigbee 协议。

但我们手里的树莓派并不原生支持Zigbee。怎么办？加个'翻译官'——Zigbee协调器。

选什么Zigbee棒？

我用的是 Sonoff Zigbee 3.0 USB Dongle Plus（CC2652P版），信号好、兼容性强，插上即用。

如何让它工作起来？Zigbee2MQTT登场

Home Assistant本身不能直接读取Zigbee信号，我们需要中间件—— Zigbee2MQTT。

它的作用是：

1. 通过串口与Zigbee棒通信；
2. 发现并管理Zigbee子设备；
3. 将所有状态变化发布到MQTT主题；
4. HA订阅这些主题，实现设备同步。

安装Node.js环境

Zigbee2MQTT基于Node.js开发，先装环境：

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs

克隆项目并安装依赖

git clone https://github.com/Koenkk/zigbee2mqtt.git /opt/zigbee2mqtt
cd /opt/zigbee2mqtt
npm install

编辑配置文件

编辑 /opt/zigbee2mqtt/data/configuration.yaml：

frontend:
  port: 8080
mqtt:
  base_topic: zigbee2mqtt
  server: 'mqtt://localhost'
serial:
  port: /dev/ttyUSB0

确保 port 正确指向你的设备（可用 ls /dev/tty* 查看）。

启动服务

npm start

打开浏览器访问 http://<树莓派IP>:8080，可以看到Zigbee2MQTT的管理界面。

搭建本地MQTT消息总线

Zigbee2MQTT需要一个MQTT Broker来转发消息。我们可以用Docker快速部署一个Mosquitto。

启动Mosquitto容器

docker run -d \
--name mosquitto \
--restart=unless-stopped \
-p 1883:1883 \
-p 9001:9001 \
-v /home/pi/mosquitto/config:/mosquitto/config \
eclipse-mosquitto

创建配置目录和基础配置文件：

mkdir -p /home/pi/mosquitto/config
echo "listener 1883" > /home/pi/mosquitto/config/mosquitto.conf
echo "allow_anonymous true" >> /home/pi/mosquitto/config/mosquitto.conf

⚠️ 生产环境中应关闭匿名访问并设置账号密码！

现在Zigbee2MQTT就能连接到 mqtt://localhost:1883 了。 重启Zigbee2MQTT服务后，在HA中添加MQTT集成，输入相同Base Topic（ zigbee2mqtt），所有已配对设备将自动出现在HA中。

动手实践：实现自动化场景

让我们来做一个实用又温馨的功能： 夜间起夜小夜灯。

场景描述

当晚上11点到早上6点之间，卧室的人体传感器检测到动作，且主灯关闭时，自动点亮走廊的小夜灯（亮度30%），5分钟后关闭。

实现步骤

1. 在Home Assistant中确认以下实体存在：
   • 二进制传感器： binary_sensor.motion_bedroom
   • 灯光： light.hallway_night_light
2. 进入 Settings > Automations & Scenes > Create Automation
3. 使用图形化编辑器填写：
   • Trigger: Event: State, From: off, To: on, Entity: binary_sensor.motion_bedroom
   • Conditions: Time: Between 23:00 and 06:00, AND State of light.bedroom_main is off
   • Action: Turn On light.hallway_night_light, Brightness: 30%, Then delay 5 minutes, Turn Off light.hallway_night_light

保存后，这个自动化就生效了。

进阶技巧：提升稳定性与安全性

一套好用的系统不仅要功能完整，还得经得起时间考验。

1. 摆脱SD卡，改用USB SSD启动

SD卡频繁读写容易损坏。树莓派4B支持USB启动，只需一次设置：

# 查看当前启动模式
vcgencmd bootloader_config
# 若返回 NO_EEPROM_UPDATE，则需更新固件
sudo rpi-eeprom-update -a
sudo reboot

更新后进入 raspi-config → Advanced Options → Boot Order → 设为'USB Boot First'。然后将系统克隆到SSD，拔掉SD卡也能正常启动。

2. 固定IP + 有线连接

无线网络不稳定会影响设备响应。建议：

• 使用网线连接路由器；
• 在路由器中为树莓派绑定固定IP；
• 关闭Wi-Fi以减少干扰（ sudo nmcli radio wifi off ）

3. 安全加固三件套

• 修改默认SSH端口；
• 禁用root远程登录；
• 安装fail2ban防暴力破解：

sudo apt install fail2ban

4. 远程访问怎么做？

想在外面控制家里设备？两种安全方式：

方案一：Tailscale（推荐）

零配置内网穿透，基于WireGuard加密隧道：

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

登录后，直接通过局域网IP访问HA，就像在家一样。

方案二：Nginx反向代理 + HTTPS

适合已有域名用户：

server {
    listen 443 ssl;
    server_name hass.yourdomain.com;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/privkey.pem;
    location / {
        proxy_pass http://localhost:8123;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

配合Let's Encrypt免费证书，既安全又专业。