ISC Kea 控制代理服务镜像

1. 镜像概述

本镜像提供ISC Kea DHCP服务器的控制代理（Control Agent）服务，用于管理和控制Kea DHCP服务器实例。支持基于Debian和Alpine两种基础镜像构建，满足不同场景下的部署需求，兼顾稳定性（Debian）和轻量级（Alpine）选择。

2. 核心功能与特性

• 控制代理服务：实现Kea DHCP服务器的远程管理与控制，支持通过REST API与Kea服务交互
• 多版本支持：提供Debian（稳定版）和Alpine（轻量级）两种基础镜像版本
• 灵活部署：支持自定义配置文件挂载，适应不同网络环境的管理需求
• 轻量级选项：Alpine版本镜像体积更小，资源占用更低，适合资源受限环境

3. 使用场景

• 企业网络中Kea DHCP服务器的集中化管理
• 数据中心内多Kea实例的远程控制与配置
• 需要通过API自动化管理DHCP服务的场景
• 对镜像体积有严格要求的轻量级部署环境（优先选择Alpine版本）

4. 使用方法与配置说明

4.1 基本使用（Docker Run）

Debian版本

docker run -d \
  --name kea-control-agent \
  -p 8000:8000 \
  -v /path/to/kea-ctrl-agent.conf:/etc/kea/kea-ctrl-agent.conf \
  jonasal/kea-control-agent:debian

Alpine版本

docker run -d \
  --name kea-control-agent \
  -p 8000:8000 \
  -v /path/to/kea-ctrl-agent.conf:/etc/kea/kea-ctrl-agent.conf \
  jonasal/kea-control-agent:alpine

4.2 Docker Compose配置示例

version: '3'
services:
  kea-control-agent:
    image: jonasal/kea-control-agent:debian  # 或使用 alpine 标签
    container_name: kea-control-agent
    ports:
      - "8000:8000"
    volumes:
      - ./kea-ctrl-agent.conf:/etc/kea/kea-ctrl-agent.conf
    restart: unless-stopped

4.3 配置文件说明

控制代理服务依赖kea-ctrl-agent.conf配置文件，需通过挂载方式提供。典型配置示例：

{
  "Control-agent": {
    "http-host": "0.0.0.0",
    "http-port": 8000,
    "control-sockets": {
      "dhcp4": {
        "socket-type": "unix",
        "socket-name": "/tmp/kea-dhcp4-ctrl.sock"
      }
    },
    "loggers": [
      {
        "name": "kea-ctrl-agent",
        "severity": "INFO",
        "output_options": [
          {
            "output": "stdout"
          }
        ]
      }
    ]
  }
}

4.4 端口说明

默认暴露控制代理服务端口：8000/tcp（可通过配置文件修改）

5. 注意事项

• 确保挂载的配置文件路径与容器内路径一致（默认/etc/kea/kea-ctrl-agent.conf）
• 如需与Kea DHCP服务器容器协同工作，需确保控制套接字（Unix socket或TCP端口）可互通（如通过共享卷或同一网络）
• Alpine版本基于轻量级基础镜像，可能缺少部分系统工具，如需调试建议优先使用Debian版本