jonasal/kea-dhcp-ddns

docker-isc-kea 镜像文档

镜像概述

docker-isc-kea是一个为ISC Kea DHCP服务器提供动态DNS（DDNS）服务的Docker镜像。该镜像旨在简化Kea DHCP与DDNS集成的部署流程，提供Debian和Alpine两种基础镜像版本，满足不同环境下的轻量化需求。

核心功能与特性

• DDNS服务集成：无缝对接ISC Kea DHCP服务器，实现IP地址与域名的动态映射
• 多版本支持：提供基于Debian和Alpine的两种镜像版本，Alpine版本体积更小，适合资源受限环境
• 配置灵活性：支持通过环境变量和挂载配置文件自定义DDNS服务参数
• 轻量级部署：容器化设计，简化依赖管理和跨平台部署
• 日志支持：提供可配置的日志输出，便于问题排查和服务监控

使用场景与适用范围

• 企业网络环境中，需要将DHCP分配的IP地址自动更新到DNS服务器
• 家庭网络或小型办公网络的动态DNS管理
• 需要自动化IP与域名映射的网络服务部署
• 基于ISC Kea DHCP构建的网络基础设施

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name kea-ddns \
  -v /path/to/kea/ddns/config:/etc/kea \
  -e KEA_DDNS_CONFIG_FILE=/etc/kea/ddns.conf \
  -e LOG_LEVEL=info \
  jonasal/isc-kea:latest

Docker Compose 配置

yaml
version: '3'
services:
  kea-ddns:
    image: jonasal/isc-kea:latest
    container_name: kea-ddns
    volumes:
      - ./kea-config:/etc/kea
    environment:
      - KEA_DDNS_CONFIG_FILE=/etc/kea/ddns.conf
      - LOG_LEVEL=info
    restart: unless-stopped

环境变量说明

配置文件挂载

推荐将自定义的Kea DDNS配置文件通过卷挂载到容器中，示例配置文件结构：

/path/to/kea/ddns/config/
  ├── ddns.conf        # DDNS服务主配置文件
  └── hooks/           # 可选的钩子脚本目录

版本选择

• Debian版本：jonasal/isc-kea:debian
• Alpine版本：jonasal/isc-kea:alpine
• 最新版本：jonasal/isc-kea:latest（默认指向Debian版本）

注意事项

• 确保Kea DHCP服务器与DDNS服务网络互通
• 配置文件需符合ISC Kea官方规范，详细配置参考Kea DDNS文档
• 生产环境建议使用固定版本标签，避免因版本更新导致配置不兼容

更多信息

完整配置指南和最新更新请参考项目GitHub仓库：https://github.com/JonasAlfredsson/docker-isc-kea