molobrakos/home-assistant

molobrakos/home-assistant Docker镜像文档

镜像概述

molobrakos/home-assistant是Home Assistant智能家居控制中心的Docker镜像，提供多个版本标签以适应不同使用场景。该镜像基于不同的Linux发行版构建，区分最新稳定发布版和开发版，便于用户根据实际需求选择合适的部署方案。

镜像标签说明

核心功能和特性

• 智能家居集成：支持数千种智能家居设备和服务的集成与控制
• 多基础系统支持：提供Debian和Alpine两种基础系统选择
  • Debian版本：兼容性更强，适合需要丰富系统依赖的场景
  • Alpine版本：轻量级，资源占用更低，适合资源受限环境
• 版本区分：
  • 稳定发布版（debian/alpine）：适合生产环境使用
  • 开发版（debian-dev/alpine-dev）：包含最新功能，适合测试和开发

使用场景和适用范围

• 家庭日常智能家居控制：选择debian或alpine标签的稳定版，构建可靠的家庭自动化系统
• 功能开发与测试：使用debian-dev或alpine-dev标签，体验最新功能并参与测试
• 资源受限环境：优先选择Alpine系列标签，减少系统资源占用
• Debian生态依赖场景：需要特定Debian系统库或工具时，选择Debian系列标签

使用方法和配置说明

拉取镜像

根据需求选择合适的标签拉取镜像：

bash
# 拉取基于Debian的最新稳定版
docker pull molobrakos/home-assistant:debian

# 拉取基于Alpine的最新稳定版
docker pull molobrakos/home-assistant:alpine

# 拉取基于Debian的开发版
docker pull molobrakos/home-assistant:debian-dev

# 拉取基于Alpine的开发版
docker pull molobrakos/home-assistant:alpine-dev

运行容器

基本运行命令（以Debian稳定版为例）：

bash
docker run -d \
  --name home-assistant \
  -p 8123:8123 \
  -v /path/to/your/config:/config \
  --restart unless-stopped \
  molobrakos/home-assistant:debian

参数说明：

• -p 8123:8123：映射Home Assistant默认Web端口
• -v /path/to/your/config:/config：挂载本地目录用于持久化配置
• --restart unless-stopped：设置容器自动重启策略

docker-compose配置示例

yaml
version: '3'
services:
  home-assistant:
    image: molobrakos/home-assistant:alpine  # 使用Alpine稳定版
    container_name: home-assistant
    ports:
      - "8123:8123"
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro  # 同步本地时间
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 设置时区

标签选择建议

• 生产环境：优先选择debian或alpine稳定版
• 资源有限设备（如树莓派）：推荐alpine标签
• 测试新功能：选择对应的-dev标签
• 需要特定Debian系统库：选择debian或debian-dev标签

注意事项

• 首次运行时，需通过Web界面完成初始配置
• 配置目录需确保有适当的读写权限
• 开发版可能包含未稳定功能，不建议用于关键生产环境
• 不同基础系统（Debian/Alpine）可能需要不同的依赖处理方式