jonasal/kea-hooks

镜像概述

该镜像为Kea DHCP服务的辅助镜像，主要用于提供开源钩子（hooks），帮助扩展和自定义Kea DHCP服务的功能。通过集成这些钩子，用户可根据实际需求增强Kea的动态配置、租约管理、日志记录等能力。

核心功能和特性

• 包含开源钩子集合：集成Kea DHCP服务常用的开源钩子，如动态DNS（DDNS）更新、租约查询、自定义事件处理等
• 功能扩展支持：通过钩子机制扩展Kea DHCP的原生功能，满足个性化业务需求
• 兼容性保障：与Kea官方镜像及社区维护的Kea容器化部署方案（如JonasAlfredsson/docker-kea）兼容
• 轻量级设计：专注于钩子文件提供，镜像体积小，易于集成和分发

使用场景和适用范围

• 企业网络环境：需自定义DHCP租约分配策略、实现IP与DNS动态绑定的场景
• 数据中心部署：需要增强DHCP服务日志分析、租约生命周期管理的大规模网络
• 定制化DHCP服务：对Kea DHCP有功能扩展需求的场景，如对接外部系统（监控平台、CMDB）等

使用方法和配置说明

前提条件

• 已部署Kea DHCP主服务（推荐使用与钩子版本匹配的Kea镜像）
• 熟悉Kea DHCP服务的配置文件结构（如kea-dhcp4.conf、kea-dhcp6.conf）

基本使用方式

与Kea主容器配合使用

通常需将钩子文件从该辅助镜像挂载到Kea主容器的钩子目录，示例如下：

bash
# 1. 启动钩子辅助容器（作为数据卷提供钩子文件）
docker run -d --name kea-hooks-vol jonasal/kea-hooks:latest

# 2. 启动Kea主容器并挂载钩子目录
docker run -d \
  --name kea-dhcp4 \
  --volumes-from kea-hooks-vol \
  -v /path/to/kea-config:/etc/kea \
  jonasal/kea:latest \
  kea-dhcp4 -c /etc/kea/kea-dhcp4.conf

Docker Compose配置示例

yaml
version: '3'
services:
  kea-hooks:
    image: jonasal/kea-hooks:latest
    volumes:
      - kea-hooks-lib:/usr/local/lib/kea/hooks  # 钩子文件存储路径

  kea-dhcp4:
    image: jonasal/kea:latest
    depends_on:
      - kea-hooks
    volumes:
      - ./kea-config:/etc/kea  # 本地Kea配置文件
      - kea-hooks-lib:/usr/local/lib/kea/hooks  # 挂载钩子文件
    command: kea-dhcp4 -c /etc/kea/kea-dhcp4.conf

volumes:
  kea-hooks-lib:

钩子配置说明

在Kea配置文件中需显式声明使用的钩子，示例（kea-dhcp4.conf）：

json
{
  "Dhcp4": {
    "hooks-libraries": [
      {
        "library": "/usr/local/lib/kea/hooks/libdhcp_ddns.so",  # DDNS钩子
        "parameters": {
          "ddns-send-updates": true,
          "ddns-server-ip": "192.168.1.10",
          "ddns-zone": "example.com"
        }
      },
      {
        "library": "/usr/local/lib/kea/hooks/libdhcp_stat_cmds.so"  # 租约统计命令钩子
      }
    ],
    # 其他Dhcp4配置...
  }
}

钩子文件路径说明

默认钩子文件存储路径：/usr/local/lib/kea/hooks/，包含的钩子文件可通过以下命令查看：

bash
docker exec kea-hooks-vol ls /usr/local/lib/kea/hooks/

版本兼容性

钩子版本需与Kea主服务版本匹配，具体版本对应关系可参考https://github.com/JonasAlfredsson/docker-kea#kea-hooks%E3%80%82