Docker部署HomeAssistant的核心是将HA环境打包为容器，实现开箱即用、配置隔离与便捷备份；只需宿主机运行Docker，几分钟即可通过http://localhost:8123访问Web界面。
用Docker部署HomeAssistant控制中心，核心是把HA运行环境打包进容器，实现开箱即用、配置隔离、便于备份。不需要编译或手动装依赖，只要Docker能跑起来，几分钟就能进入Web管理界面。
准备基础环境
确保宿主机已安装Docker并正常运行：
- Windows/macOS：安装Docker Desktop，启用WSL2（Win10/11）或Hyper-V（旧版Win10）
- Linux（如Ubuntu/CentOS）：安装Docker Engine，将当前用户加入docker组：
sudo usermod -aG docker $USER - 群晖NAS：在套件中心启用Docker，并确认DSM版本≥6.0（推荐7.2+）
- 软路由（如爱快、OpenWrt）：确认已安装并启用Docker插件，且分配了≥10GB专用存储空间
拉取并运行HA容器
推荐使用稳定版镜像，避免最新版潜在兼容问题：
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 命令行方式（通用）：
docker run -d \<br> --name home-assistant \<br> --restart unless-stopped \<br> -e TZ=Asia/Shanghai \<br> -v /path/to/ha_config:/config \<br> -p 8123:8123 \<br> --network host \<br> homeassistant/home-assistant:stable
- 关键说明：
•/path/to/ha_config必须是**绝对路径**，不能含中文或空格
•--network host模式利于设备自动发现（如米家、Zigbee网关）
• 若需接入串口设备（如Zigbee USB Dongle），加上--device=/dev/ttyUSB0
首次访问与初始化
容器启动后，浏览器打开 http://[宿主机IP]:8123（Windows/macOS可直接用 http://localhost:8123）：
- 首次加载需3–10分钟（取决于硬件性能），页面可能短暂空白，属正常现象
- 按提示创建管理员账户，密码建议强密码（后续API、远程访问会用到）
- 时区选
Asia/Shanghai，地理位置尽量精确（影响日出日落自动化、天气服务） - 初始化完成后，系统会自动生成
configuration.yaml和数据库，所有数据都落在你指定的/config映射目录中
后续维护要点
容器本身只是运行载体，真正重要的是你的配置和数据：
- 所有自定义集成、自动化、UI界面设置，都保存在映射的本地目录里，删容器不丢配置
- 升级HA：停止旧容器 →
docker pull homeassistant/home-assistant:stable→ 用相同参数重新docker run - 如需图形化管理（尤其多容器场景），可顺手部署Portainer：
docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer - 群晖用户建议为HA单独建共享文件夹（如
docker/homeassistant），方便用Hyper Backup统一备份
