jonasal/kea-dhcp4-slim

ISC Kea DHCP (IPv4, 无钩子库) 镜像文档

镜像概述

本镜像提供ISC Kea DHCP服务的IPv4实例，专注于核心DHCP功能，不包含任何钩子库文件。Kea是ISC推出的新一代开源DHCP服务器，支持IPv4和IPv6，提供灵活的配置和管理能力。本镜像精简了钩子库组件，适用于对基础DHCP服务有需求、不需要扩展功能的场景。

核心功能与特性

• 纯IPv4支持：专注于IPv4 DHCP服务，包含DHCPv4服务器核心功能
• 无钩子库设计：不包含任何钩子库文件，减小镜像体积，降低潜在依赖冲突
• 配置灵活性：支持通过外部配置文件自定义DHCP服务参数
• 轻量级部署：基于精简基础镜像，适合容器化环境快速部署
• 标准化接口：遵循ISC Kea官方配置规范，兼容标准DHCP服务场景

使用场景

• 小型网络环境的DHCP服务部署
• 测试或开发环境中的临时DHCP服务
• 对镜像体积有严格要求的容器化部署
• 不需要钩子扩展功能的基础DHCP服务场景
• 需自定义配置的IPv4地址分配场景

使用方法与配置说明

基本使用 (docker run)

bash
docker run -d \
  --name kea-dhcp4 \
  -p 67:67/udp \
  -v /path/to/kea-dhcp4.conf:/etc/kea/kea-dhcp4.conf \
  jonasal/kea:latest

Docker Compose 配置

yaml
version: '3'
services:
  kea-dhcp4:
    image: jonasal/kea:latest
    container_name: kea-dhcp4
    ports:
      - "67:67/udp"
    volumes:
      - ./kea-dhcp4.conf:/etc/kea/kea-dhcp4.conf
      - kea-data:/var/lib/kea
    restart: unless-stopped

volumes:
  kea-data:

配置文件说明

核心配置文件为kea-dhcp4.conf，典型配置示例：

json
{
  "Dhcp4": {
    "interfaces-config": {
      "interfaces": ["eth0"]
    },
    "subnet4": [
      {
        "subnet": "192.168.1.0/24",
        "range": [
          {
            "min-address": "192.168.1.100",
            "max-address": "192.168.1.200"
          }
        ],
        "option-data": [
          {
            "name": "routers",
            "data": "192.168.1.1"
          },
          {
            "name": "domain-name-servers",
            "data": "8.8.8.8,8.8.4.4"
          }
        ]
      }
    ],
    "loggers": [
      {
        "name": "kea-dhcp4",
        "output_options": [
          {
            "output": "stdout"
          }
        ],
        "severity": "INFO"
      }
    ]
  }
}

环境变量

数据持久化

建议挂载以下目录以实现数据持久化：

• /etc/kea: 配置文件目录
• /var/lib/kea: 租约数据库等持久化数据目录

日志配置

默认日志输出到stdout，可通过配置文件中的loggers部分自定义日志输出方式、级别和格式。