pnnlmiscscripts/dhcpd

镜像概述

dhcpd Docker镜像是一个容器化的DHCP（动态主机配置协议）服务器实现，用于为局域网中的设备自动分配IP地址、子网掩码、网关、DNS服务器等网络配置参数。该镜像基于https://github.com/pnnl-miscscripts/miscscripts%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E7%AE%80%E5%8C%96DHCP%E6%9C%8D%E5%8A%A1%E7%9A%84%E9%83%A8%E7%BD%B2%E4%B8%8E%E7%AE%A1%E7%90%86%EF%BC%8C%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E7%BA%A7%E3%80%81%E5%8F%AF%E7%A7%BB%E6%A4%8D%E7%9A%84%E7%BD%91%E7%BB%9C%E6%9C%8D%E5%8A%A1%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82

核心功能与特性

• 动态IP地址分配：支持为网络设备自动分配IP地址，减少手动配置工作量
• 标准DHCP协议支持：兼容DHCPv4标准，提供IP地址租约管理、地址释放与续约功能
• 网络配置参数管理：可配置并分发子网掩码、默认网关、DNS服务器、域名等网络参数
• 容器化部署：通过Docker容器隔离运行环境，简化安装流程，降低系统依赖
• 灵活配置：支持挂载外部配置文件，自定义DHCP服务规则与策略

使用场景

• 家庭网络或小型办公网络中提供自动IP分配服务
• 测试环境或临时网络快速部署DHCP服务
• 嵌入式设备或边缘计算场景中的轻量级网络配置服务
• 需要隔离运行的多实例DHCP服务部署
• 教学或实验环境中演示DHCP协议工作原理

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）
• 宿主机具备网络接口访问权限（DHCP服务需监听UDP 67端口）
• 准备DHCP服务配置文件（通常为dhcpd.conf）

基本部署命令

Docker Run 示例

bash
docker run -d \
  --name dhcpd-server \
  --net=host \  # 推荐使用host网络模式以直接访问宿主机网络接口
  -v /path/to/local/dhcpd-config:/etc/dhcp \  # 挂载本地配置目录
  -v /var/lib/dhcp:/var/lib/dhcp \  # 挂载租约数据库目录（可选，持久化租约记录）
  --restart unless-stopped \
  pnnl-miscscripts/miscscripts-dhcpd

参数说明：

• --net=host：使用主机网络模式，确保DHCP服务能监听宿主机网络接口并接收广播请求
• -v /path/to/local/dhcpd-config:/etc/dhcp：将本地配置目录挂载到容器内，配置文件需包含dhcpd.conf
• -v /var/lib/dhcp:/var/lib/dhcp：持久化存储DHCP租约数据库，避免容器重启后租约信息丢失

配置文件示例

dhcpd.conf 基础配置示例：

conf
# 全局设置
default-lease-time 600;  # 默认租约时间（秒）
max-lease-time 7200;     # 最大租约时间（秒）
option domain-name "example.com";  # 域名
option domain-name-servers 8.8.8.8, 8.8.4.4;  # DNS服务器

# 子网配置
subnet 192.168.1.0 netmask 255.255.255.0 {
  range 192.168.1.100 192.168.1.200;  # IP地址池范围
  option subnet-mask 255.255.255.0;   # 子网掩码
  option routers 192.168.1.1;         # 默认网关
  option broadcast-address 192.168.1.255;  # 广播地址
}

Docker Compose 配置

yaml
version: '3.8'

services:
  dhcpd:
    image: pnnl-miscscripts/miscscripts-dhcpd
    container_name: dhcpd-service
    network_mode: host
    volumes:
      - ./dhcpd-config:/etc/dhcp:ro  # 只读挂载配置目录
      - dhcpd-leases:/var/lib/dhcp  # 命名卷存储租约数据
    restart: unless-stopped
    # 如需指定监听接口（部分环境需要）
    # command: dhcpd -f -d eth0  # -f 前台运行，-d 调试模式，eth0 监听接口

volumes:
  dhcpd-leases:  # 持久化租约数据的命名卷

注意事项

1. 网络模式选择：由于DHCP服务依赖广播通信，推荐使用--net=host模式；若使用桥接模式，需确保容器能接收网络广播包并正确映射UDP 67端口

2. 权限配置：宿主机挂载目录需确保容器内进程有读取权限（配置文件）和写入权限（租约目录）

3. 防火墙设置：需开放宿主机UDP 67端口（入站）和UDP 68端口（出站），允许DHCP协议流量通过

4. 配置验证：启动前建议通过dhcpd -t -cf /path/to/dhcpd.conf验证配置文件语法正确性

5. 日志查看：通过docker logs dhcpd-server查看服务运行日志，排查配置或网络问题

扩展配置

如需自定义服务行为，可通过修改启动命令或添加环境变量实现（具体支持项请参考https://github.com/pnnl-miscscripts/miscscripts%E9%A1%B9%E7%9B%AE%E6%96%87%E6%A1%A3%EF%BC%89%EF%BC%8C%E5%B8%B8%E8%A7%81%E6%89%A9%E5%B1%95%E5%9C%BA%E6%99%AF%EF%BC%9A

• 指定监听网络接口：command: dhcpd -f eth0
• 启用调试日志：command: dhcpd -f -d（-d 开启调试模式）
• 限制租约数量：在dhcpd.conf中配置max-lease-time和地址池范围控制

完整配置参数与高级用法，请参考官方项目文档：https://github.com/pnnl-miscscripts/miscscripts