roobbb/owserver

One-Wire Docker容器

镜像概述和主要用途

本容器基于debian-slim:stable，通过apt-get从官方debian仓库安装owserver、owhttpd和owftpd，用于运行1-wire服务器。主要设计用于在Raspberry Pi或其他设备上与智能家居系统配合使用，支持多种主流智能家居平台集成。

核心功能和特性

• 官方包安装：使用debian官方仓库的owserver、owhttpd和owftpd软件包，确保稳定性和安全性
• 灵活配置：支持通过环境变量自定义端口、设备路径、服务器地址等核心参数
• 服务级别控制：可选择启动owserver单独服务，或同时启动owhttpd和owftpd
• 自定义配置支持：允许挂载自定义owfs.conf配置文件，满足特殊需求
• 多平台兼容：适用于Raspberry Pi及其他支持Docker的设备

使用场景和适用范围

主要适用于需要集成1-wire设备的智能家居系统，支持以下平台：

• FHEM
• OpenHAB
• Home Assistant
• ioBroker
• HomeBridge.io
• Node Red

使用方法和配置说明

环境变量

Dockerfile中声明的默认变量

这些变量可在启动容器时通过-e参数覆盖，新值将自动更新容器内的/etc/owfs.conf文件。

启动脚本(start.sh)评估的变量

运行示例

标准配置启动（使用udev规则设置设备为/dev/onewire）

首先在主机上设置udev规则（以Denkovi设备为例）：

bash
ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", ATTRS{serial}=="DAE001xy", SUBSYSTEMS=="usb", ACTION=="add", MODE="0660", GROUP="plugdev", SYMLINK+="onewire"

启动容器：

bash
docker run -d \
   --name=owserver \
   --net=host \
   --restart=always \
   -v /etc/localtime:/etc/localtime:ro \
   --device=/dev/onewire \
roobbb/owserver

• 标准配置将owserver绑定到localhost:4304，owhttpd绑定到2121端口
• 使用--net=host选项时，本地进程可通过127.0.0.1:4304访问owserver

验证udev规则是否生效：ls -l /dev/onew*，如未创建正确链接，尝试将SUBSYSTEMS=="usb"改为SUBSYSTEM=="tty"

仅启动owserver服务

bash
docker run -d \
   --name=owserver \
   --net=host \
   --restart=always \
   -v /etc/localtime:/etc/localtime:ro \
   --device=/dev/onewire \
   -e SERVICES_LVL=1 \
roobbb/owserver

覆盖默认参数

当设备路径不是默认的/dev/onewire时，需设置OW_DEVICE变量：

bash
docker run -d \
   --name=owserver \
   --net=host \
   --restart=always \
   -v /etc/localtime:/etc/localtime:ro \
   --device=/dev/ttyUSB0 \
   -e WEB_PORT=1234 \
   -e OW_DEVICE=ttyUSB0 \
   -e FTP_PORT=21 \
roobbb/owserver

• 此示例保持OWFS_PORT默认值4304，修改了其他端口和设备路径
• 可根据需要设置部分或全部参数

使用自定义配置文件

bash
docker run -d \
   --name=owserver \
   --net=host \
   --restart=always \
   -v /etc/localtime:/etc/localtime:ro \
   -v /mypath/to_my_config:/root/.local/share \
   --device=/dev/ttyS0 \
   -e CUSTOM_CONFIG_ENABLED=1 \
   -e CUSTOM_CONFIG_FILE=/root/.local/share/owfs.example \
roobbb/owserver:dev

• 使用dev版本和自定义配置文件"owfs.example"
• 即使没有连接真实1-wire设备，仍可通过[***]

容器管理命令

进入运行中的容器

bash
docker exec -it owserver /bin/bash

停止容器

bash
docker stop owserver

与FHEM集成示例

FHEM本地安装时

bash
define myOWServer OWServer 127.0.0.1:4304
attr myOWServer room OneWire

更多详情参见FHEM文档：[] 或 []

FHEM也运行在容器中

1. 创建自定义网络：

bash
docker network create mynet

2. 启动owserver容器（使用自定义配置）：

bash
docker run -d \
  --rm \
  --name=owserver \
  --net=mynet \
  --network-alias myserver \
  -p 2121:2121 \
  -v /etc/localtime:/etc/localtime:ro \
  -v /mypath/to_my_config:/root/.local/share \
  --device=/dev/ttyUSB0 \
  -e CUSTOM_CONFIG_ENABLED=1 \
  -e CUSTOM_CONFIG_FILE=/root/.local/share/owfs.example \
roobbb/owserver:dev

3. 启动FHEM容器：

bash
docker run -d --rm --net=mynet -p 8083:8083 --name fhem fhem/fhem

4. 在FHEM中定义设备：

bash
define myLocalOWServer OWServer myserver:4304
attr myLocalOWServer room OWDevice
attr myLocalOWServer nonblocking 1

带网络别名的标准配置示例

bash
docker run -d --rm \
  --name=owserver \
  --net=testnet \
  --network-alias tryme \
  -p 1234:1234 \
  -v /etc/localtime:/etc/localtime:ro \
  -v ~/dockertests/owserver:/root/.local/share \
  --device=/dev/ttyS0 \
  -e OW_SERVER=tryme \
  -e WEB_PORT=1234 \
roobbb/owserver:dev

• 映射端口必须与WEB_PORT一致
• 网络别名应与OW_SERVER值相同，如未指定网络别名，则OW_SERVER需设为容器名称

故障排除

2021-09-05：无法读取实时时钟问题

在DietPi系统的Raspberry Pi上可能出现以下错误：

cannot read realtime clock: Operation not permitted

即使使用--privileged选项也无法解决，这是由于libseccomp2版本过旧导致。解决方法：

1. 检查当前安装版本：

bash
dpkg -l | grep libsecc

2. 下载最新armhf版本（示例版本，具体请查看官方源）：

bash
wget http://ftp.debian.org/debian/pool/main/libs/libseccomp/libseccomp2_2.5.1-1_armhf.deb

3. 安装更新：

bash
sudo dpkg -i libseccomp2_2.5.1-1_armhf.deb

更多故障排除信息参见GitHub Wiki：https://github.com/roobbb/owserver/wiki/6.-Troubleshooting#2022-06-22

更多信息

• 项目主页：[***]
• GitHub仓库：https://github.com/roobbb/owserver
• GitHub Wiki：https://github.com/roobbb/owserver/wiki

注：latest标签对应main分支，dev标签仅用于测试目的