如何使用Docker容器部署HomeAssistant智能家居系统的控制中心

夏明吖_5963

夏明吖_5963

2026-05-07

609人浏览

原创

Docker部署HomeAssistant的核心是将HA环境打包为容器,实现开箱即用、配置隔离与便捷备份;只需宿主机运行Docker,几分钟即可通过http://localhost:8123访问Web界面。

如何使用docker容器部署homeassistant智能家居系统的控制中心

用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容器

推荐使用稳定版镜像,避免最新版潜在兼容问题:

Portainer Docker Control
Portainer Docker Control

使用 Portainer API 控制 Docker 容器和堆栈,包括列出容器、启停/重启、查看日志以及从 Git重新部署堆栈。

下载
  • 命令行方式(通用):
    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统一备份

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

docker

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

845

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

7059

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

8257

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

3313

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

379

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

511

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

480

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

365

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

585

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Docker Desktop故障排查手册
Docker Desktop故障排查手册

共0课时 | 0人学习

Docker镜像构建手册
Docker镜像构建手册

共0课时 | 0人学习