一、Docker 下部署 HomeAssistant

docker run -d 
  --name homeassistant 
  --privileged 
  --restart=unless-stopped 
  -e TZ=Asia/Shanghai 
  -v /home/yujj/homeassistant/config:/config 
  -v /home/yujj/share/娱乐/:/media 
  --network=host 
  ghcr.io/home-assistant/home-assistant:stable

参数说明：

• --privileged：赋予容器特权模式，方便访问硬件
• --restart=unless-stopped：除非手动停止，否则自动重启
• --network=host：使用主机网络模式，方便发现局域网设备
• -v：挂载配置和媒体目录

二、安装 HACS（社区商店）

创建目录

mkdir -p '/home/yujj/homeassistant/config/www'
mkdir -p '/home/yujj/homeassistant/config/custom_components'

之后所有的开源插件安装在 custom_components 目录下。

三、更新 HomeAssistant

docker pull ghcr.io/home-assistant/home-assistant:stable

拉取最新镜像后重新运行第一步的创建命令即可。

四、插件推荐（长期更新）

• 🔊 文本转语音模块：hass-edge-tts
• 📱 小米物联网模块：xiaomi_miot_raw