智能家居 on 梓晨's Blog

Docker 部署 Zigbee2MQTT

Wed, 29 Mar 2023 00:00:00 +0000

安装命令

使用 Docker 部署，重启策略为 unless-stopped：

1
2
3
4
5
6
7


docker run -d \
 --name zigbee2mqtt \
 --restart unless-stopped \
 -p 8080:8080 \
 -e TZ=Asia/Shanghai \
 -v ~/zigbee2mqtt/data:/app/data \
 koenkk/zigbee2mqtt:latest

后台地址为 http://IP:8080/。配置文件位于 ~/zigbee2mqtt/data/configuration.yaml；MQTT 和网络协调器地址按自己的实际地址填写。

2.x 及后续版本配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


mqtt:
 base_topic: zigbee2mqtt
 server: mqtt://192.168.1.10:1883
 user: admin
 password: public
serial:
 port: tcp://192.168.1.20:8888
 adapter: zstack
advanced:
 channel: 15
frontend:
 enabled: true
 port: 8080
homeassistant:
 enabled: true

192.168.1.10:1883 是 MQTT 服务地址，192.168.1.20:8888 是网络协调器地址，均需替换为实际地址。账号和密码使用自己的 MQTT 凭据；adapter: zstack 对应 TI Z-Stack 协调器，其他类型使用对应的 adapter。

通过命令开启配对

2.0 起移除了配置文件中的 permit_join 和永久允许加入功能。可通过 MQTT 命令开启配对，无需手工点页面。安装了 mosquitto_pub 的机器上执行：

1
2


mosquitto_pub -h 192.168.1.10 -p 1883 -u admin -P public \
 -t zigbee2mqtt/bridge/request/permit_join -m '{"time":254}'

将地址和凭据替换为配置中的实际值；新版单次配对窗口最多 254 秒，时间到了可再次执行。也可在前端开启配对。

1.x 配置格式

使用 1.x 镜像的环境采用下面的格式。上面的 latest 部署使用新版格式，两组配置按镜像版本选择，不要合并：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


homeassistant: true
permit_join: true
mqtt:
 base_topic: zigbee2mqtt
 server: mqtt://192.168.1.10:1883
 user: admin
 password: public
serial:
 port: tcp://192.168.1.20:8888
advanced:
 channel: 15
frontend: true

USB 协调器

使用 USB 时，将 serial.port 改成容器内设备路径，例如 /dev/ttyUSB0，并在创建容器时加入实际设备映射：

1
2


--device=/dev/serial/by-id/实际设备ID:/dev/ttyUSB0
-v /run/udev:/run/udev:ro

参考：Docker 部署、2.0 配置迁移、MQTT 配对命令。

Docker 部署 Home Assistant Container

Wed, 29 Mar 2023 00:00:00 +0000

安装命令

1
2
3
4
5
6
7


docker run -d \
 --name homeassistant \
 --restart unless-stopped \
 -e TZ=Asia/Shanghai \
 -v ~/homeassistant/config:/config \
 --network=host \
 ghcr.io/home-assistant/home-assistant:stable

管理页面为 http://IP:8123/。此示例适用于 Linux 宿主机的 host 网络；Home Assistant Container 不包含 Supervisor 和附加组件商店。

验证运行状态

1
2


docker inspect -f '{{.State.Status}}' homeassistant
docker logs --tail=50 homeassistant

容器状态应为 running，然后访问管理页面完成初始化。若反复重启，先检查日志和配置目录权限。

备份与恢复

升级前备份 ~/homeassistant/config，并记录原镜像版本。升级回退需要按 Home Assistant 对应版本的要求恢复备份及镜像，避免仅切换标签后复用不兼容的数据。

临时停止容器

停止服务时执行，配置目录会保留：

1

docker stop homeassistant

iOS 16 保留旧版家庭架构的方法（历史记录）

Tue, 05 Apr 2022 00:00:00 +0000

历史记录：Apple 已于 2026-02-10 结束旧版家庭架构支持，详见官方说明。下方记录旧版系统使用描述文件的方法。

前言

由于苹果公司从IOS16版本开始对家庭架构进行了升级，并且升级后居然不能向下兼容，由于我手中还有低版本的旧设备所以我宁可不使用新特性也要兼容旧设备。

安装旧版架构描述文件

http://appldnld.apple.com/iOSProfiles/KeepLegacyHome.mobileconfig

这个描述文件的作用是保留使用旧版架构，安装完需要重新创建一个新的家庭才可以，会删除掉之前配置的所有配件以及自动化，降级的话不可以保留。

安装重置HomeKit描述文件

http://appldnld.apple.com/iOSProfiles/HomeKitReset.mobileconfig

这个描述文件是重置HomeKit的，非必装，作用就是自动重建HomeKit不需要手动去删除了。

智能家居 on 梓晨's Blog

Docker 部署 Zigbee2MQTT

安装命令

2.x 及后续版本配置

通过命令开启配对

1.x 配置格式

USB 协调器

延伸阅读

Docker 部署 Home Assistant Container

安装命令

验证运行状态

备份与恢复

临时停止容器

延伸阅读

iOS 16 保留旧版家庭架构的方法（历史记录）

前言

安装旧版架构描述文件

安装重置HomeKit描述文件