jonasal/kea-dhcp4

docker-isc-kea (IPv4)

镜像概述

本镜像为ISC Kea DHCP服务器的Docker化实现，专注于提供IPv4 DHCP服务。基于ISC Kea开源DHCP服务器软件，提供Debian和Alpine两种基础镜像版本，满足不同场景下的部署需求。

核心功能与特性

• IPv4 DHCP服务：实现ISC Kea DHCP服务器的核心IPv4功能，支持地址分配、租约管理等标准DHCPv4特性。
• 多基础镜像版本：提供基于Debian（稳定、功能丰富）和Alpine（轻量级、资源占用低）的两种镜像版本，可根据实际需求选择。
• 配置灵活性：支持通过挂载外部配置文件自定义Kea服务参数，适应不同网络环境的DHCP策略。
• 数据持久化：可通过卷挂载实现配置文件、租约数据库等数据的持久化存储，确保服务重启后数据不丢失。

使用场景与适用范围

• 企业网络环境：为企业内部网络设备提供稳定的IPv4地址分配服务。
• 数据中心部署：在虚拟化或容器化环境中快速部署DHCPv4服务，简化网络配置。
• 家庭/小型网络：作为轻量级DHCP服务器替代路由器内置服务，提供更灵活的配置选项。
• 开发测试环境：快速搭建隔离的DHCP服务环境，用于网络应用测试。

使用方法与配置说明

镜像拉取

根据基础镜像版本选择拉取：

bash
# Debian版本
docker pull jonasal/kea-isc:debian

# Alpine版本（轻量级）
docker pull jonasal/kea-isc:alpine

基本运行示例

使用默认配置运行（仅用于测试）

bash
docker run -d \
  --name kea-dhcpv4 \
  -p 67:67/udp \
  jonasal/kea-isc:debian

挂载自定义配置文件运行

1. 准备本地配置目录（如./kea-config），并创建Kea配置文件kea-dhcp4.conf（配置示例参考ISC Kea官方文档）。

2. 运行容器并挂载配置目录：

bash
docker run -d \
  --name kea-dhcpv4 \
  -p 67:67/udp \
  -v $(pwd)/kea-config:/etc/kea \
  jonasal/kea-isc:alpine

持久化数据

为确保租约数据等持久化，可额外挂载数据目录：

bash
docker run -d \
  --name kea-dhcpv4 \
  -p 67:67/udp \
  -v $(pwd)/kea-config:/etc/kea \
  -v $(pwd)/kea-data:/var/lib/kea \
  jonasal/kea-isc:debian

环境变量（如有）

具体环境变量可参考GitHub仓库文档，常见可能包括：

• KEA_DHCP4_CONFIG：指定DHCPv4配置文件路径（默认通常为/etc/kea/kea-dhcp4.conf）
• TZ：设置时区，影响日志时间戳等

配置文件说明

Kea配置文件需遵循官方格式，典型的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"
          }
        ]
      }
    ]
  }
}

注意事项

• 确保宿主机网络允许UDP 67端口访问，容器需以适当权限运行（可能需要--cap-add=NET_ADMIN等权限，具体参考GitHub文档）。
• 生产环境中建议使用自定义配置文件，并通过卷挂载确保配置和数据持久化。
• 详细配置选项、高级用法及故障排除，请参考GitHub仓库完整文档：https://github.com/JonasAlfredsson/docker-isc-kea===SHORT_DESC=== ISC Kea DHCP服务的IPv4实例，提供Debian和Alpine两种版本。 ===FULL_DESC===

docker-isc-kea (IPv4)

镜像概述

本镜像为ISC Kea DHCP服务器的Docker化实现，专注于提供IPv4 DHCP服务功能。基于ISC Kea开源DHCP服务器软件构建，提供Debian和Alpine两种基础镜像版本，满足不同场景下的部署需求。

核心功能与特性

• IPv4 DHCP服务：实现ISC Kea DHCP服务器的IPv4核心功能，支持地址分配、租约管理、选项配置等标准DHCPv4特性
• 多基础镜像支持：提供基于Debian（稳定可靠，依赖完整）和Alpine（轻量级，资源占用低）两种版本，适应不同部署环境需求
• 配置灵活性：支持通过外部挂载自定义配置文件，实现DHCP服务参数的灵活定制
• 数据持久化：可通过卷挂载实现配置文件、租约数据库等关键数据的持久化存储

使用场景与适用范围

• 企业网络环境：为企业内部网络设备提供稳定的IPv4地址分配服务
• 数据中心部署：在虚拟化或容器化环境中快速部署DHCPv4服务节点
• 家庭/小型网络：作为轻量级DHCP服务器替代传统路由器内置服务，提供更灵活的配置选项
• 开发测试环境：快速搭建隔离的DHCP服务环境，用于网络应用测试验证

使用方法与配置说明

镜像拉取

根据基础镜像版本选择拉取：

bash
# Debian版本
docker pull jonasal/kea-isc:debian

# Alpine版本（轻量级）
docker pull jonasal/kea-isc:alpine

基本运行示例

简单测试运行

bash
docker run -d \
  --name kea-dhcpv4 \
  -p 67:67/udp \
  jonasal/kea-isc:debian

挂载自定义配置运行

1. 准备本地配置目录并创建配置文件（如./kea-config/kea-dhcp4.conf）

2. 运行容器并挂载配置目录：

bash
docker run -d \
  --name kea-dhcpv4 \
  -p 67:67/udp \
  -v $(pwd)/kea-config:/etc/kea \
  jonasal/kea-isc:alpine

持久化部署示例

bash
docker run -d \
  --name kea-dhcpv4 \
  --restart unless-stopped \
  -p 67:67/udp \
  -v $(pwd)/kea-config:/etc/kea \
  -v $(pwd)/kea-data:/var/lib/kea \
  jonasal/kea-isc:debian

配置文件说明

典型的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"
          }
        ]
      }
    ]
  }
}

注意事项

• 运行容器需要网络权限，可能需要添加--cap-add=NET_ADMIN等 capabilities（具体请参考项目GitHub文档）
• 生产环境建议使用自定义配置文件并通过卷挂载确保配置持久化
• 详细配置选项和高级用法请参考官方GitHub仓库文档：https://github.com/JonasAlfredsson/docker-isc-kea