nastymorbol/fhem

FHEM家庭自动化系统Docker镜像

镜像概述

本镜像为官方FHEM Docker镜像的分叉版本，将基础镜像从Debian替换为Alpine以减少最终体积，适用于实验性使用。FHEM是开源家庭自动化系统，支持多种智能设备的集成与控制。

核心功能

• 多平台支持：覆盖AMD64、i386、ARM32v5/7、ARM64v8等架构
• 持久化存储：通过挂载卷保存配置，避免容器销毁后数据丢失
• 自定义包安装：自动安装Debian APT、Perl CPAN、Python PIP、Node.js NPM包
• 灵活配置：通过环境变量调整日志格式、用户/组ID、权限和时区等
• 健康检查：内置脚本验证FHEMWEB可用性及telnet设备配置
• USB映射：支持主机USB设备接入，用于连接智能硬件

使用场景

• 家庭自动化系统快速部署与测试
• 多平台环境下的智能家居设备控制
• FHEM功能实验与开发验证

配置说明

安装与启动

拉取镜像

console
docker pull docker.xuanyuan.run/nastymorbol/fhem:alpine

快速启动（无持久化）

console
docker run -d --name fhem -p 8083:8083 docker.xuanyuan.run/nastymorbol/fhem:alpine

持久化启动（推荐）

挂载主机目录保存配置：

console
docker run -d --name fhem -p 8083:8083 -v /some/host/directory:/opt/fhem docker.xuanyuan.run/nastymorbol/fhem:alpine

Docker Compose部署

1. 创建目录并下载配置：

console
sudo mkdir -p /docker/home
sudo curl -fsSL -o /docker/home/docker-compose.yml https://github.com/fhem/fhem-docker/raw/master/docker-compose.yml
sudo curl -fsSL -o /docker/home/.gitignore https://github.com/fhem/fhem-docker/raw/master/.gitignore

2. 启动服务：

console
cd /docker/home && sudo docker-compose up -d

自定义包安装

通过环境变量自动安装包：

• APT包：-e APT_PKGS="curl wget"
• CPAN模块：-e CPAN_PKGS="App::Name1 App::Name2"
• PIP包：-e PIP_PKGS="package1 package2"
• NPM包：-e NPM_PKGS="package1 package2"

示例：

console
docker run -d --name fhem -p 8083:8083 -e APT_PKGS="curl wget" docker.xuanyuan.run/nastymorbol/fhem:alpine

环境变量配置

常用变量：

• LOGFILE：日志格式（默认：./log/fhem-%Y-%m-%d.log）
• TZ：时区（如Asia/Shanghai）
• FHEM_UID/FHEM_GID：调整用户/组ID
• CONFIGTYPE：配置类型（configDB或fhem.cfg.demo）

示例：

console
docker run -d --name fhem -p 8083:8083 -e TZ=Asia/Shanghai -e FHEM_UID=1000 docker.xuanyuan.run/nastymorbol/fhem:alpine

USB设备映射

1. 查看主机USB设备：

console
lsusb -v | grep -E '\<(Bus|iProduct|bDeviceClass|bDeviceProtocol)' 2>/dev/null

2. 映射设备：

console
docker run -d --name fhem -p 8083:8083 --device=/dev/bus/usb/001/002 docker.xuanyuan.run/nastymorbol/fhem:alpine

健康检查控制

禁用特定FHEMWEB实例检查：在该设备设置用户属性DockerHealthCheck=0。