henfri/knxd

knxd Docker镜像文档

镜像概述

henfri/knxd:v0.12.6是KNX守护进程（knxd）的Docker镜像，用于实现KNX总线与IP网络的桥接，支持KNX设备间的通信和控制，是智能家居和建筑自动化系统的核心组件。

核心功能与特性

• 实现KNX总线与IP网络的协议转换
• 支持多种接口类型（IP、USB、路由器等）
• 可配置本地和外部KNX地址
• 提供灵活的命令行参数调整通信参数（如发送延迟）
• 支持容器自动重启，确保服务持续可用

使用场景

• 智能家居系统中KNX设备的集中控制
• 家庭或商业建筑的自动化系统集成
• KNX总线网络的远程监控与管理

使用方法

1. 容器配置

创建docker-compose.yaml文件，配置如下：

yaml
version: "2"
services:
    knxd:
      image: docker.xuanyuan.run/henfri/knxd:v0.12.6
      network_mode: "host"
      command: knxd -e 1.0.200 -E 1.0.201:8 -DTRS -c -i --send-delay=120 -B single -b ipt:192.168.177.8
      restart: always

参数说明：

• network_mode: "host": 使用主机网络模式，确保KNX通信正常
• command: knxd启动命令，关键参数解释：
  • -e 1.0.200: 设置本地KNX物理地址
  • -E 1.0.201:8: 设置外部KNX地址及端口
  • -DTRS: 启用调试、跟踪、路由和服务器模式
  • --send-delay=120: 设置发送延迟（毫秒）
  • -B single: 设置接口模式为单一接口
  • -b ipt:192.168.177.8: 指定KNX IP接口地址，需替换为实际IP

提示：根据实际网络环境调整IP地址，若使用USB或路由器接口，需参考knxd手册修改command参数。

2. 启动容器

在docker-compose.yaml所在目录执行以下命令启动容器：

bash
docker-compose up

3. 测试容器

若需控制KNX组地址（GA）1/1/180（例如开关灯），执行以下命令：

bash
docker exec -it [ContainerID] knxtool groupswrite ip:localhost 1/1/180 1

说明：

• [ContainerID]: 替换为实际容器ID，可通过docker ps命令查看
• 1/1/180: 目标KNX组地址
• 1: 发送的值（1表示开启，0表示关闭）

执行后，连接到该组地址的设备（如灯光）应相应动作。