isc-dhcp-server (dhcpd) Docker镜像文档

轻量级且安全的DHCP服务器（isc-dhcp-server）

!Docker镜像版本（最新日期） !Docker镜像大小（最新日期） !Docker拉取次数 !GitHub工作流状态 !运行身份

GitHub - 3x3cut0r/isc-dhcp-server - []
DockerHub - 3x3cut0r/isc-dhcp-server - []

1. 镜像概述和主要用途

本镜像基于ISC DHCP服务器（dhcpd）构建，提供轻量级、安全的动态主机配置协议（DHCP）服务。支持IPv4和IPv6协议，可通过自定义配置文件或环境变量灵活配置，适用于快速部署DHCP服务的场景。

2. 核心功能和特性

• 双协议支持：同时支持IPv4（默认）和IPv6网络环境
• 灵活配置：支持通过环境变量快速配置或挂载自定义dhcpd.conf文件实现高级配置
• 安全运行：采用非root用户权限运行，降低安全风险
• 时区定制：支持通过环境变量指定服务器时区
• 轻量级设计：镜像体积小，资源占用低
• 兼容性：兼容标准DHCP协议，支持租约管理、DNS服务器指定、网关配置等核心功能

3. 使用场景和适用范围

• 家庭网络：为家庭设备自动分配IP地址、DNS和网关信息
• 小型企业网络：快速部署DHCP服务，管理内部网络设备IP分配
• 测试环境：临时搭建网络环境时提供DHCP服务
• 定制化需求：需通过dhcpd.conf实现高级配置（如固定IP绑定、PXE启动支持）的场景

4. 使用方法和配置说明

4.1 快速开始

4.1.1 docker run 命令示例

示例1：IPv4 - 使用自定义dhcpd.conf（推荐）

这是推荐的使用方式，可支持dhcpd.conf的所有配置选项
注意：IFACE必须与您的主机接口匹配！！！

shell
docker run -d \
    --name isc-dhcp-server \
    --network=host \
    -e IFACE=eth0 \
    -v /本地路径/your/dhcpd.conf:/etc/dhcp/dhcpd.conf:ro \
    3x3cut0r/isc-dhcp-server:latest

示例2：IPv4 - 使用环境变量配置

注意：IFACE和SUBNET必须与您的主机接口匹配！！！

shell
docker run -d \
    --name isc-dhcp-server \
    --network=host \
    -e TZ="Asia/Shanghai" \
    -e IFACE=eth0 \
    -e SUBNET=192.168.0.0 \
    -e NETMASK=255.255.255.0 \
    -e RANGE_BEGIN=192.168.0.100 \
    -e RANGE_END=192.168.0.200 \
    -e ROUTERS=192.168.0.1 \
    -e DOMAIN_NAME_SERVERS="8.8.8.8,8.8.4.4" \
    3x3cut0r/isc-dhcp-server:latest

示例3：IPv6 - 使用自定义dhcpd.conf

注意：IFACE必须与您的主机接口匹配！！！

shell
docker run -d \
    --name isc-dhcp-server \
    --network=host \
    -e TZ="Asia/Shanghai" \
    -e IFACE=eth0 \
    -e PROTOCOL=6 \
    -v /本地路径/your/dhcpd.conf:/etc/dhcp/dhcpd.conf:ro \
    3x3cut0r/isc-dhcp-server:latest

示例4：IPv6 - 使用环境变量配置

注意：IFACE和SUBNET6必须与您的主机接口匹配！！！

shell
docker run -d \
    --name isc-dhcp-server \
    --network=host \
    -e TZ="Asia/Shanghai" \
    -e IFACE=eth0 \
    -e PROTOCOL=6 \
    -e SUBNET6="fe80::0/64" \
    -e RANGE6_BEGIN="fe80::1" \
    -e RANGE6_END="fe80::ffff" \
    -e DHCP6_NAME_SERVERS="2001:4860:4860::8888,2001:4860:4860::8844" \
    3x3cut0r/isc-dhcp-server:latest

4.1.2 docker-compose 配置示例

yaml
version: '3'

services:
  isc-dhcp-server:
    network_mode: host
    environment:
        TZ: Asia/Shanghai  # 时区
        IFACE: eth0        # 监听接口（需与主机接口匹配）
        PROTOCOL: 4        # IP协议（4=IPv4，6=IPv6）
    volumes:
        - /本地路径/your/dhcpd.conf:/etc/dhcp/dhcpd.conf:ro  # 挂载自定义配置文件
    image: 3x3cut0r/isc-dhcp-server:latest

4.2 配置参数说明

4.2.1 环境变量

更多配置细节可参考：dhcpd手册

4.2.2 数据卷

4.2.3 端口说明

无需端口绑定，因为容器需使用--network=host（主机网络模式）以正常监听DHCP广播包。

5. 相关链接

• GitHub仓库：3x3cut0r/docker
• DockerHub镜像：3x3cut0r/isc-dhcp-server

6. 许可证

![License: GPL v3]([***]
本项目基于GNU通用公共许可证v3.0授权，详情参见GPLv3协议。