diggewuff/fhem-docker

FHEM智能家居自动化系统Docker容器

镜像概述

本镜像基于Debian系统构建，适用于各类Docker主机，提供FHEM智能家居自动化系统的完整安装（包含所有依赖）。镜像支持配置持久化、多端口暴露、健康检查等功能，且持续维护优化，用户可通过GitHub提交需求或反馈问题。

核心功能

• 可映射并自动初始化的/opt/fhem卷，确保配置跨更新和重启持久化
• 暴露端口：7072（FHEM-Tellnet）、8083-8089（FHEM Web实例、Tablet UI及Webhooks）
• 预安装haus-automatisierung.com主题，预配置美观的FHEM Web界面
• 通过Docker可查看FHEM实时日志输出
• 可靠的启停脚本，支持优雅重启和关闭（无需发送kill信号）
• Docker健康检查，验证FHEM首个Web前端的可达性
• 支持两种配置方式：fhem.cfg文件或configDB
• 持续维护与优化，欢迎用户提交功能需求

使用场景

适用于家庭自动化场景，如智能家居设备（灯光、温控、传感器等）的集中控制、环境数据监控、自动化场景设置等，帮助用户快速搭建稳定的家庭自动化系统。

配置说明

持久化卷映射

将容器内/opt/fhem目录映射到主机目录，实现配置持久化：

bash
docker run -d --name fhem-docker -v /主机目录:/opt/fhem [端口映射] diggewuff/fhem-docker

首次运行时，若主机目录为空，容器会自动初始化默认配置。

USB设备映射

若需使用USB设备（如传感器），先通过lsusb查看设备路径，再添加--device参数：

bash
docker run -d --name fhem-docker --device=/dev/bus/usb/001/002 [其他参数] diggewuff/fhem-docker

环境变量配置

可通过环境变量自定义容器行为：

• TIMEOUT: FHEM进程意外终止后容器停止前的超时时间（秒），默认10
• TZ: 时区（POSIX格式，如Asia/Shanghai）
• HEALTHCHECKCREDENTIALS: FHEM Web前端的基础认证凭据（格式：user:password）
• CONFIGTYPE: 配置类型，可选fhem.cfg（默认）或configDB
• HEALTHCHECK_PORT: 使用configDB时指定Web端口
• HEALTHCHECK_HTTPS: 使用configDB且Web启用HTTPS时设为true

配置建议

迁移现有配置或初始化时，需确保配置中包含以下行：

attr global logfile /opt/fhem/log/fhem-%Y-%m.log
attr global modpath /opt/fhem
attr global nofork 0
attr global pidfilename /opt/fhem/log/fhem.pid
attr global updateInBackground 1
define telnetPort telnet 7072 global

同时，配置中需使用绝对路径（以/opt/fhem/开头）而非相对路径。

部署示例

基础运行

bash
docker run -d --name fhem-docker -p 7072:7072 -p 8083:8083 diggewuff/fhem-docker

带持久化卷运行

bash
docker run -d --name fhem-docker -v /my/host/directory:/opt/fhem -p 7072:7072 -p 8083:8083 diggewuff/fhem-docker

带USB设备和时区配置运行

bash
docker run -d --name fhem-docker --device=/dev/bus/usb/001/002 -e TZ=Asia/Shanghai -v /my/host/directory:/opt/fhem -p 7072:7072 -p 8083:8083 diggewuff/fhem-docker

常用命令

• 查看运行中的容器：docker ps
• 进入容器shell：docker exec -it fhem-docker /bin/bash
• 查看实时日志：docker logs -f fhem-docker
• 访问Web界面：http://主机IP:8083