duffbeer2000/iobroker

ioBroker Docker镜像

镜像概述

该Docker镜像容器化了ioBroker GmbH开发的ioBroker软件，是一款专注于物联网（IoT）集成的平台，覆盖楼宇自动化、智能计量、环境辅助生活、过程自动化、可视化和数据记录等领域。支持amd64、armv7hf（如树莓派2/3）和aarch64架构，可从Docker Hub拉取：duffbeer2000/iobroker，当前ioBroker版本为2.0.2。

核心功能

• 多架构适配：兼容主流硬件架构，满足不同设备部署需求；
• 灵活配置：支持自定义端口、时区、蓝牙等功能参数；
• 持久化存储：通过卷挂载实现数据持久化，避免数据丢失；
• 权限自动修复：纠正ioBroker目录的权限问题，确保正常运行；
• 版本多样化：提供标准（latest）、完整（full）、最小（min）版本，适配不同场景。

使用场景

• 智能家居系统搭建与设备管理；
• 楼宇自动化控制与监控；
• 智能计量数据采集与分析；
• 物联网设备集成与数据可视化。

配置说明

命令行运行

bash
docker run -d \
    --name=iobroker \
    --net=host \
    --restart=always \
    -v /etc/localtime:/etc/localtime:ro \
    -v /your/iobroker/folder:/opt/iobroker \
    duffbeer2000/iobroker

命令行参数说明

环境变量

Docker Compose配置

yaml
version: "2"
services:
  iobroker:
    image: duffbeer2000/iobroker
    container_name: iobroker
    network_mode: host
    restart: always
    volumes:
      - /your/iobroker/folder:/opt/iobroker
    environment:
      - LANG=de_DE.UTF-8
      - TZ=Europe/Berlin
      - IOBROKER_ADMIN_PORT=8081
      - IOBROKER_WEB_PORT=8082
      - AVAHI=0
      - BT_ENABLE=0
      - ASTERISK=0

使用命令：docker-compose pull拉取镜像，docker-compose up -d启动服务，docker-compose down停止服务。

Mac/Windows平台运行

Mac/Windows不支持--net=host，需显式映射端口：

bash
docker run -d \
    --name=iobroker \
    -p 8081:8081 \
    -p 8082:8082 \
    --restart=always \
    -v /your/iobroker/folder:/opt/iobroker \
    -e IOBROKER_ADMIN_PORT=8081 \
    -e IOBROKER_WEB_PORT=8082 \
    duffbeer2000/iobroker

镜像标签

不同版本特性

latest（标准版本）：

• 支持AVAHI启用（用于yahka适配器）；
• 可修改管理和Web UI端口；
• 首次启动时若目录为空则恢复默认配置；
• 检测到UPGRADE文件时执行npm rebuild；
• 支持预脚本、自定义包列表、后脚本；
• 修复ioBroker目录权限；
• 以iobroker用户身份启动。

full（完整版本）：

• 包含标准版本所有特性；
• 扫描已安装适配器并自动安装依赖；
• 支持蓝牙和asterisk集成；
• 自动检测yahka适配器并启用AVAHI。

min（最小版本）：

• 仅包含基础功能；
• 需自行配置依赖；
• 支持端口修改和AVAHI启用；
• 首次启动时恢复默认配置；
• 以iobroker用户身份启动。

已知问题

当前语言设置通过环境变量修改可能无效，正在测试中。

问题反馈与贡献

若遇到问题，请在GitHub仓库提交Issue：https://github.com/duffbeer2000/docker-iobroker%EF%BC%88%E6%8F%90%E4%BA%A4%E5%89%8D%E8%AF%B7%E5%85%88%E6%9F%A5%E7%9C%8B%E5%B7%B2%E7%9F%A5%E9%97%AE%E9%A2%98%EF%BC%89%E3%80%82
贡献代码请Fork仓库，创建特性分支并提交Pull Request。

本地构建

推荐从Docker Hub拉取镜像，也可本地构建：

bash
git clone https://github.com/duffbeer2000/docker-iobroker.git
cd dockertravis
docker build -t "[your-user/]iobroker[:local]" ./[arch]

参数说明：

• [your-user/]：可选，Docker用户名；
• iobroker：镜像名称；
• [:local]：可选，添加本地标签；
• [arch]：架构（支持amd64、armhf）。

致谢

• ioBroker GmbH开发ioBroker平台；
• @buanet的ioBroker容器提供灵感：https://github.com/buanet/docker-iobroker%E3%80%82