modem7/dhcprelay

ISC DHCP中继代理

!https://img.shields.io/docker/pulls/modem7/dhcprelay !https://img.shields.io/docker/image-size/modem7/dhcprelay/latest 

!["Buy Me A Coffee"]([***]

镜像概述和主要用途

ISC DHCP中继代理（dhcrelay）提供了一种将DHCP和BOOTP请求从无直接连接DHCP服务器的子网中继到其他子网的一个或多个DHCP服务器的方法。它同时支持DHCPv4/BOOTP和DHCPv6协议。

更多信息可参考：[***]

核心功能和特性

• 支持DHCPv4/BOOTP和DHCPv6协议的中继
• 可监听指定网络接口上的DHCP请求
• 支持将请求转发到指定的DHCP服务器
• 支持在前台运行模式，便于调试和进程管理

标签

使用场景和适用范围

适用于需要在不同子网间中继DHCP请求的网络环境，例如：

• 跨子网的DHCP服务部署
• Docker网络与主机网络间的DHCP请求中继
• 需要集中管理DHCP服务的复杂网络架构

使用方法和配置说明

配置要求

在配置中，主机上的UDP端口67必须保持空闲。

Docker Compose配置示例

bash
version: "2.4"

services:

 #############
 ##DHCPRelay##
 #############
 
 #DHCPRelay - 主机网络与Docker桥接网络间的DHCP中继
  dhcprelay:
    image: docker.xuanyuan.run/modem7/dhcprelay:latest
    container_name: DHCPRelay
    command: ["-id", "eno1", "-iu", "br_pihole", "172.33.0.100"] #参考: https://fedoramagazine.org/build-network-bridge-fedora/
    cap_add:
      - NET_ADMIN
    network_mode: host
    restart: always
    mem_limit: 20m
    mem_reservation: 5m

命令参数解释

详细命令说明可参考：[***]

• -i ifname: 在接口ifname上监听DHCPv4/BOOTP查询。可通过多个-i选项指定多个接口。若未指定接口，dhcrelay将识别所有网络接口，尽可能排除非广播接口并尝试监听所有接口。
• -d: 强制dhcrelay以前台进程运行。在调试或System V系统的inittab中运行时非常有用。
• eno1: 网络接口名称（可通过ifconfig -a命令查看）。
• -u [address%]ifname: 指定DHCPv6中继模式的"上层"网络接口：客户端和其他中继代理的查询应转发到该接口。在DHCPv6模式下，命令行中至少需包含一个-u选项。接口名称ifname是必填参数。可通过address%指定目标单播或多播地址；若未指定，中继代理将转发到DHCPv6的All_DHCP_Relay_Agents_and_Servers多播地址。
• br_pihole: Docker网络桥接名称。
• 172.33.0.100: 数据包的目标IP地址，通常是PiHole桥接IP地址。