1. 香橙派Zero3开箱与硬件准备
第一次拿到香橙派Zero3时，确实被它的小巧惊艳到了。整块开发板只有信用卡大小，却集成了四核ARM Cortex-A53处理器和2GB/4GB内存选项。我选择的是2GB版本，对于运行Homeassistant来说完全够用。包装内除了主板外，还附带了一个5V3A电源适配器——这里要特别提醒，虽然官方推荐3A电源，但实测2A电源也能稳定运行，只是在高负载时可能会有轻微发热。
散热是这类迷你开发板需要特别注意的问题。原装附赠的散热片效果有限，长时间运行Homeassistant时温度会升到60℃左右。后来我加装了第三方散热片（某宝20元就能买到带风扇的套装），温度直接降了15℃。如果打算7×24小时运行，建议考虑带散热孔的外壳，既能保证散热又能防尘。
硬件连接方面，由于Zero3没有HDMI接口，需要使用Micro-HDMI转接线才能连接显示器。不过作为智能家居中枢，我更推荐完全通过SSH操作。只需要准备：
- 8GB以上的高速TF卡（建议选择Class10以上规格）
- 网线（用于初次配置时的有线连接）
- 5V电源（2A以上输出电流）
- 可选：USB转TTL模块（用于串口调试）
2. 系统安装与基础配置
2.1 制作系统镜像
官方推荐使用Ubuntu或Armbian系统，我选择了Armbian因为其对ARM架构优化更好。具体步骤：
- 下载Armbian镜像（建议选择Bullseye稳定版）
- 使用balenaEtcher将镜像写入TF卡
- 写入完成后不要急着拔卡，在电脑上找到boot分区，新建一个名为
ssh的空文件（无扩展名），这样系统首次启动时会自动开启SSH服务
# Windows下创建ssh文件的PowerShell命令 fsutil file createnew X:\ssh 02.2 无屏幕初始化配置
插入TF卡通电启动后，通过路由器管理界面查找Zero3获取的IP地址。使用MobaXterm或Putty等工具SSH连接（用户名root，初始无密码）：
ssh root@192.168.x.x首次登录会提示设置新密码和创建普通用户。建议完成以下基础配置：
- 更换国内软件源加速下载
sed -i 's|deb.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list- 更新系统并安装必要工具
apt update && apt upgrade -y apt install -y vim curl git net-tools2.3 无线网络配置
智能家居中枢通常需要稳定的WiFi连接。配置方法：
nmtui # 使用文本界面配置工具或者直接修改配置文件：
vim /etc/NetworkManager/system-connections/你的WiFi名.nmconnection添加如下内容（记得替换你的WiFi信息）：
[connection] id=你的WiFi名 uuid=随机生成UUID type=wifi [wifi] mode=infrastructure ssid=你的WiFi名 [wifi-security] auth-alg=open key-mgmt=wpa-psk psk=你的WiFi密码 [ipv4] method=auto [ipv6] addr-gen-mode=stable-privacy method=auto3. Docker环境部署
3.1 安装Docker引擎
Homeassistant官方推荐使用Docker部署，安装步骤如下：
# 卸载旧版本 apt remove docker docker-engine docker.io containerd runc # 安装依赖 apt install -y ca-certificates curl gnupg lsb-release # 添加Docker官方GPG密钥 mkdir -p /etc/apt/keyrings curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 设置稳定版仓库 echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/debian \ $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null # 安装Docker apt update apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin # 验证安装 docker run hello-world3.2 配置Docker加速
国内用户建议配置镜像加速：
mkdir -p /etc/docker tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://registry.cn-hangzhou.aliyuncs.com"], "log-driver": "json-file", "log-opts": { "max-size": "10m", "max-file": "3" } } EOF systemctl restart docker4. Homeassistant核心安装
4.1 使用Docker安装
推荐使用官方提供的容器镜像：
docker run -d \ --name homeassistant \ --privileged \ --restart=unless-stopped \ -e TZ=Asia/Shanghai \ -v /home/hass/config:/config \ -v /run/dbus:/run/dbus:ro \ --network=host \ ghcr.io/home-assistant/home-assistant:stable关键参数说明：
-v /home/hass/config:/config：将配置目录映射到宿主机--network=host：使用主机网络模式，方便设备发现TZ=Asia/Shanghai：设置时区为上海
首次启动需要等待5-10分钟初始化，可以通过日志查看进度：
docker logs -f homeassistant4.2 访问Web界面
在浏览器输入http://香橙派IP:8123即可进入初始化向导。建议：
- 创建管理员账户
- 设置位置信息（影响天气等组件）
- 选择推荐的集成（如移动端应用）
5. 小米设备集成实战
5.1 安装Xiaomi Gateway3插件
对于小米/米家设备，最稳定的集成方式是使用第三方插件：
- 进入Homeassistant容器内部：
docker exec -it homeassistant bash- 安装依赖：
apk add --no-cache build-base linux-headers- 退出容器后，在宿主机下载插件：
cd /home/hass/config/custom_components wget https://github.com/AlexxIT/XiaomiGateway3/releases/latest/download/xiaomi_gateway3.zip unzip xiaomi_gateway3.zip rm xiaomi_gateway3.zip- 重启Homeassistant：
docker restart homeassistant5.2 配置小米设备
在Web界面依次点击：
- 配置 -> 设备与服务
- 右下角"添加集成"
- 搜索"Xiaomi Gateway 3"
- 按照向导添加设备（需要小米账号和密码）
常见问题处理：
- 如果设备未发现，尝试关闭路由器5GHz频段
- 蓝牙设备需要确保网关在有效范围内
- Zigbee设备可能需要重置后重新配对
6. 系统优化与维护
6.1 自动备份配置
使用crontab设置每日自动备份：
# 安装压缩工具 apt install -y zip # 创建备份脚本 vim /usr/local/bin/hass_backup.sh脚本内容：
#!/bin/bash BACKUP_DIR="/home/hass/backups" CONFIG_DIR="/home/hass/config" TIMESTAMP=$(date +"%Y%m%d_%H%M%S") mkdir -p $BACKUP_DIR zip -r $BACKUP_DIR/hass_backup_$TIMESTAMP.zip $CONFIG_DIR # 保留最近7天备份 find $BACKUP_DIR -type f -name "hass_backup_*.zip" -mtime +7 -delete添加执行权限并设置定时任务：
chmod +x /usr/local/bin/hass_backup.sh (crontab -l ; echo "0 3 * * * /usr/local/bin/hass_backup.sh") | crontab -6.2 性能监控
安装Glances实时监控系统状态：
docker run -d \ --name glances \ --restart unless-stopped \ -v /var/run/docker.sock:/var/run/docker.sock:ro \ -v /etc/localtime:/etc/localtime:ro \ -p 61208-61209:61208-61209 \ -e GLANCES_OPT="-w" \ nicolargo/glances:alpine访问http://香橙派IP:61208即可查看实时监控面板。
7. 进阶功能扩展
7.1 安装Node-RED实现自动化
Node-RED是强大的可视化自动化工具：
docker run -d \ --name=nodered \ --restart unless-stopped \ -v /home/hass/node-red:/data \ -e TZ=Asia/Shanghai \ -p 1880:1880 \ nodered/node-red安装后需要在Homeassistant中配置http集成，并在Node-RED中安装node-red-contrib-home-assistant-websocket节点。
7.2 使用ESPHome管理DIY设备
对于自制智能设备，ESPHome是绝佳选择：
docker run -d \ --name="esphome" \ --restart unless-stopped \ -v /home/hass/esphome:/config \ -v /etc/localtime:/etc/localtime:ro \ --net=host \ esphome/esphome访问http://香橙派IP:6052即可通过Web界面管理ESP设备。
