phfouquet/dhcpd

phfouquet/dhcpd镜像中文文档

镜像概述

本Docker镜像基于最新Ubuntu LTS发行版构建，集成ISC DHCP服务器，适用于在Docker主机网络环境中运行DHCP服务。镜像支持自定义配置、权限管理，并提供带LDAP扩展的变体版本，满足不同场景需求。

核心功能

1. 标准DHCP服务：提供稳定的动态主机配置协议服务，支持子网、租约等常见配置。
2. 权限一致性：根据数据文件夹所有者身份运行DHCP服务，确保文件权限统一，避免权限冲突。
3. LDAP扩展：提供:ldap标签版本，包含isc-dhcp-server-ldap包，支持LDAP集成的企业级场景。
4. 网络模式检测：若未使用--net host模式启动，会发出警告提示，避免配置错误。
5. 配置校验：若未挂载包含dhcpd.conf的/data卷，容器会提前退出并报错，确保配置有效性。

使用场景

1. 为Docker主机所在的本地网络提供DHCP服务。
2. 快速测试DHCP配置文件的语法和有效性。
3. 需要LDAP集成的企业级DHCP部署场景。
4. 临时搭建DHCP服务用于网络调试或测试环境。

配置说明

步骤1：准备配置文件

1. 创建本地数据目录：mkdir -p ./data
2. 在./data目录下创建dhcpd.conf配置文件（可通过docker run -it --rm phfouquet/dhcpd man dhcpd.conf查看语法说明）。示例配置：

   conf
   subnet 192.168.1.0 netmask 255.255.255.0 {
     range 192.168.1.100 192.168.1.200;
     option routers 192.168.1.1;
     option domain-name-servers 8.8.8.8, 8.8.4.4;
   }
   

步骤2：启动容器

基础版本启动命令

bash
docker run -it --rm --init --net host -v "$(pwd)/data":/data phfouquet/dhcpd eth0

参数说明：

• --net host：使用主机网络模式（必须，否则DHCP服务无法正常广播）
• -v "$(pwd)/data":/data：挂载本地数据目录到容器内
• eth0：指定提供DHCP服务的网络接口（需替换为实际接口名）

LDAP变体启动命令

bash
docker run -it --rm --init --net host -v "$(pwd)/data":/data phfouquet/dhcpd:ldap eth0

步骤3：使用辅助脚本

镜像提供run脚本简化启动流程：

1. 获取脚本（从镜像仓库克隆或提取）
2. 执行./run启动容器（需确保./data目录及配置文件存在）

注意事项

• 必须使用--net host模式，否则DHCP服务无法正常工作。
• 确保./data目录及dhcpd.conf的权限设置正确，镜像会自动适配运行用户。
• LDAP变体需额外配置LDAP相关参数到dhcpd.conf中（如ldap-server、ldap-base-dn等）。
• 容器启动后会输出日志，按Ctrl-C可终止服务。