LinuxKit dhcpcd 镜像文档

镜像概述

本镜像基于 LinuxKit 项目的 dhcpcd 软件包构建，集成了轻量级DHCP客户端工具 dhcpcd，主要用于在容器环境中实现网络配置的自动获取与管理。

核心功能与特性

• 自动网络配置：通过DHCP协议自动获取IP地址、子网掩码、默认网关及DNS服务器信息
• 双协议支持：兼容IPv4和IPv6网络环境
• 后台运行模式：支持作为守护进程在后台运行，持续维护网络配置状态
• 配置灵活性：可通过配置文件自定义DHCP行为（如请求特定IP、设置租约期限等）
• 轻量级设计：基于LinuxKit最小化基础镜像，资源占用低，适合容器化部署

使用场景与适用范围

• 容器网络自动配置：在无静态IP分配的环境中，为容器提供自动网络参数获取能力
• 边缘计算设备：边缘节点或嵌入式设备中，需动态适应网络环境变化的场景
• 临时网络测试：快速部署DHCP客户端以验证网络DHCP服务可用性
• LinuxKit系统组件：作为LinuxKit构建的定制化操作系统中的网络配置组件

使用方法与配置说明

基本运行示例

通过以下命令启动dhcpcd容器，默认将尝试通过主机网络接口获取DHCP配置：

bash
docker run --rm --net=host linuxkit/dhcpcd

注意：使用--net=host模式可让容器直接访问主机网络接口，确保DHCP客户端能正常与网络中的DHCP服务器通信

自定义配置

可通过挂载本地配置文件来自定义dhcpcd行为。dhcpcd默认配置文件路径为/etc/dhcpcd.conf，示例如下：

1. 创建本地配置文件 dhcpcd.conf：

conf
# 为eth0接口配置DHCP
interface eth0
  request subnet_mask, broadcast_address, routers, domain_name_servers
  timeout 30
  retry 5

2. 挂载配置文件启动容器：

bash
docker run --rm --net=host -v $(pwd)/dhcpcd.conf:/etc/dhcpcd.conf linuxkit/dhcpcd

常用运行参数

• --net=host：使用主机网络模式，允许直接访问主机网络接口（必需）
• -d：启用调试模式，输出详细日志信息用于问题排查
• -1：获取一次DHCP租约后立即退出（非守护进程模式）
• -q：静默模式，仅输出错误信息

配置文件说明

dhcpcd配置文件（默认/etc/dhcpcd.conf）支持多种自定义指令，常用选项包括：

• interface <ifname>：指定要配置的网络接口（如eth0、wlan0）
• static ip_address=<ip>/<cidr>：设置静态IP（与DHCP共存时优先生效）
• routers <gateway>：手动指定默认网关
• domain_name_servers <dns1> <dns2>：指定DNS服务器地址
• leasehours <hours>：设置DHCP租约请求时长（默认24小时）

更多配置细节可参考dhcpcd***文档