instantlinux/dhcpd-dns-pxe

dhcpd-dns-pxe

镜像概述和主要用途

该镜像基于Alpine Linux，可在一个或多个小型容器中提供DNS、DHCP和TFTP服务。通过dnsmasq提供DNS和TFTP（用于网络PXE启动）功能，DHCP服务可选择kea或dnsmasq实现。三个服务均可独立启用或禁用。ISC dhcpd已被其维护者弃用，自2026年1月的3.0.2-r0-2.91-r0标签起，已由kea替代，使用时需注意子网和保留定义的变更。

核心功能和特性

• 多服务集成：整合DNS（dnsmasq）、DHCP（kea或dnsmasq）、TFTP（dnsmasq）服务，支持独立开关
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 灵活配置：支持静态IP分配、DNS主机条目自定义、PXE启动镜像挂载
• 高可用性：支持Kubernetes集群部署，实现DHCP服务故障转移
• 数据库支持：kea使用MariaDB/MySQL存储租约信息，确保数据持久化
• 多平台支持：兼容amd64、arm64、arm/v6、arm/v7架构

使用场景和适用范围

• 家庭或小型办公室网络的DNS和DHCP服务部署
• 企业内部网络的PXE启动环境搭建
• Kubernetes集群中的网络服务基础设施
• 需要高可用性的DHCP服务场景（如通过Swarm或K8s实现多实例部署）

使用方法和配置说明

基本配置

在docker-compose.yml或Helm配置中，需设置环境变量以适应具体环境。

挂载卷

需挂载以下路径至容器的/etc目录：

• /etc/kea.d/local/reserve-<net>.conf：添加静态IP分配的硬件MAC地址（参考dhcpd配置文档）
• /etc/dnsmasq.d/local/hosts：添加dnsmasq DNS服务的主机条目（参考hosts文件语法）

PXE启动镜像和客户端定义需挂载至/tftpboot/pxelinux。

数据库配置（kea使用）

kea需使用MariaDB/MySQL存储租约，需创建数据库及用户：

sql
CREATE DATABASE kea;
GRANT USAGE ON *.* TO `kea`@`%` IDENTIFIED BY '<password>';
GRANT ALL PRIVILEGES ON `kea`.* TO `kea`@`%`;

Docker Compose部署

参考源码目录中的docker-compose.yml文件。

Kubernetes部署

1. 克隆仓库：

bash
git clone https://github.com/instantlinux/docker-tools.git
cd docker-tools/k8s

2. 自定义https://github.com/instantlinux/docker-tools/blob/main/k8s/Makefile.vars
3. 部署：

bash
make dhcpd-dns-pxe

通过Helm chart或https://github.com/instantlinux/docker-tools/blob/main/images/dhcpd-dns-pxe/kubernetes.yaml%E9%83%A8%E7%BD%B2%EF%BC%8C%E9%9C%80%E5%AE%9A%E4%B9%89%E5%8C%85%E5%90%AB%E7%A7%9F%E7%BA%A6%E5%92%8C%E4%B8%BB%E6%9C%BA%E6%9D%A1%E7%9B%AE%E7%9A%84ConfigMap%E3%80%82%E5%A4%9A%E5%AE%9E%E4%BE%8B%E9%83%A8%E7%BD%B2%E6%97%B6%EF%BC%8CDHCP%E5%8D%8F%E8%AE%AE%E6%9C%BA%E5%88%B6%E5%8F%AF%E9%81%BF%E5%85%8D%E5%9C%B0%E5%9D%80%E5%86%B2%E7%AA%81%EF%BC%8C%E5%AE%A2%E6%88%B7%E7%AB%AF%E5%B0%86%E4%BD%BF%E7%94%A8%E9%A6%96%E4%B8%AA%E6%94%B6%E5%88%B0%E7%9A%84%E5%9C%B0%E5%9D%80%EF%BC%8C%E5%90%8E%E7%BB%AD%E8%AF%B7%E6%B1%82%E5%B0%86%E6%A3%80%E6%9F%A5%E7%A7%9F%E7%BA%A6%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82

高级配置

额外的dnsmasq选项可通过/etc/dnsmasq.d/local目录下的.conf文件定义（参考dnsmasq文档）；DHCP配置可通过/etc/dhcpd.d/local目录下的.conf文件扩展。

若习惯使用dnsmasq的DHCP功能，可设置DHCP_ENABLE=no，并将配置挂载为/etc/dnsmasq.d/local/dhcpd-options.conf，dnsmasq将在检测到相关配置时通过67端口提供DHCP服务。

环境变量配置

密钥配置

贡献指南

如需改进此镜像，参考https://github.com/instantlinux/docker-tools/blob/main/CONTRIBUTING.md%E3%80%82