detecmedia/openhab

OpenHAB Docker镜像文档

镜像概述和主要用途

本镜像为OpenHAB的容器化部署方案，目前处于开发状态。OpenHAB是一款开源智能家居自动化平台，该镜像提供了便捷的容器化运行方式，支持通过环境变量配置SSH认证、Git仓库集成、Samba服务等功能，适用于本地智能家居系统的部署与测试。

核心功能和特性

• SSH认证：支持通过公钥（PUB_KEY）实现SSH免密登录，或使用默认用户名密码登录控制台
• Git仓库集成：可配置Git仓库地址（GIT_REPO），实现配置文件的版本控制与同步
• Samba服务：支持启用/禁用Samba服务（SMB），方便文件共享
• 灵活网络配置：支持端口映射或host网络模式，满足不同网络环境需求
• 多种部署模式：提供独立运行、带控制台交互、进入容器Bash等多种启动方式

使用场景和适用范围

• 智能家居自动化系统的本地容器化部署
• OpenHAB应用的开发与测试环境搭建
• 需要便捷配置管理（如Git集成、Samba共享）的智能家居场景

详细使用方法和配置说明

环境变量配置

网络配置

端口映射模式

需映射以下端口：

bash
-p 445:445/tcp \  # 仅在启用Samba时需要
-p 5007:5007/tcp -p 8080:8080/tcp -p 8101:8101/tcp -p 8443:8443/tcp

Host网络模式

当需要回调功能（如homematic-bridge）时，使用host网络：

bash
--network=host

卷配置

暂无指定卷配置。

Samba访问

• 用户名：openhab
• 密码：openhab

SSH控制台访问（端口8101）

方式一：使用默认用户名密码

• 用户名：openhab
• 密码：habopen

方式二：使用公钥认证

1. 准备SSH公钥（仅需公钥内容，如AAAAB3NzaC1yc2EAAAADAQABAAACAQD部分）
2. 通过环境变量传入公钥：

bash
-e PUB_KEY="AAAAB3NzaC1yc2EAAAADAQABAAACAQD"

启动容器示例

独立运行

bash
docker run --rm -d -p 445:445/tcp -p 5007:5007/tcp \
-p 8080:8080/tcp -p 8101:8101/tcp -p 8443:8443/tcp \
detecmedia/openhab:latest

带OpenHAB控制台运行

bash
docker run --rm -i -p 445:445/tcp -p 5007:5007/tcp \
-p 8080:8080/tcp -p 8101:8101/tcp -p 8443:8443/tcp \
detecmedia/openhab:latest

进入容器Bash

bash
docker run --rm -it detecmedia/openhab:latest bash

带回调功能独立运行（使用host网络）

bash
docker run --rm -d --network=host \
detecmedia/openhab:latest