nipar44/predbat_addon

Predbat Home Assistant 插件

Predbat Home Assistant插件，运行在独立Docker容器中。完整说明请参见 https://github.com/nipar4/predbat_addon%E3%80%82

概述与主要用途

该镜像提供Predbat Home Assistant插件的独立Docker容器部署方案，方便用户在Home Assistant中集成Predbat功能，支持通过配置文件自定义设置，适用于多种系统环境。

核心功能与特性

• 独立容器运行：作为独立Docker容器部署，不依赖主机系统环境
• 多标签支持：提供多种镜像标签，满足不同系统需求（标准版本、轻量级版本等）
• 配置持久化：支持通过卷挂载本地配置目录，实现配置文件持久化与自定义修改
• 时间同步：通过挂载/etc/localtime确保容器内时间与主机一致

使用场景与适用范围

适用于需要在Home Assistant中集成Predbat功能，并希望通过独立Docker容器进行部署的用户。特别适合：

• 需要隔离部署环境的场景
• 对镜像体积有要求的系统（可选择轻量级标签）
• 希望自定义插件配置的高级用户

使用方法与配置说明

Docker 运行命令

使用以下命令启动独立容器：

bash
docker run -d --name predbat -v /etc/localtime:/etc/localtime nipar44/predbat_addon:tag

注：需将tag替换为具体标签（详见标签说明）

Docker Compose 配置

推荐使用Docker Compose进行部署，示例配置如下：

yaml
services:
  predbat:
    container_name: predbat
    image: nipar44/predbat_addon:tag  # 替换为具体标签
    restart: unless-stopped
    ports:
      - 5052:5052  # 端口映射
    user: predbat  # 可选：指定运行用户
    volumes:
      - /path/to/local/config:/config:rw  # 本地配置目录挂载（替换/path/to/local/config）
      - /etc/localtime:/etc/localtime:ro  # 只读挂载主机时间

配置文件处理

• 容器日志会报错，直到apps.yaml模板配置完成。可通过以下方式修改配置：
  1. 直接在容器内修改apps.yaml
  2. 通过docker cp命令将本地更新后的配置文件复制到容器/config目录：

     bash
     docker cp /本地路径/apps.yaml predbat:/config/
     

• 注意：每次容器升级重建后，需重新将apps.yaml复制到容器/config目录

标签说明

• latest & 版本标签：基于predbat_addon Git仓库中Docker.standalone的未修改构建
• alpine-latest & slim-latest：针对需要更小镜像体积的系统的修改构建（轻量级版本）
• test：测试版本，可能存在功能不稳定问题

其他说明

Predbat及predbat_addon的所有功劳归于Trefor Southwell。