aojea/kindnetd

Kindnet：支持IPv4、IPv6及双栈的简单CNI插件

镜像概述和主要用途

Kindnet是一个适用于Kubernetes集群的简单CNI（容器网络接口）插件，核心目标是提供支持IPv4、IPv6及双栈网络的集群网络功能，实现Kubernetes集群网络要求。该项目源于现有CNI插件普遍缺乏IPv6支持，且缺乏自动创建多节点IPv6 Kubernetes集群的解决方案。

Kindnet仅适用于"简单"网络环境，即所有集群节点属于同一子网。随着功能演进，它已集成ipmasq代理，目前是https://github.com/kubernetes-sigs/kind%EF%BC%88Kubernetes IN Docker）的默认CNI插件。所有稳定代码已迁移至KIND项目中，本仓库仅用于新功能开发及在"真实"集群中进行实验。

核心功能和特性

Kindnet组件

Kindnet使用以下https://github.com/containernetworking/plugins%EF%BC%9A

• ptp：创建veth对，并将主机和容器添加到其中
• bridge：创建网桥，将主机和容器添加到网桥中
• host-local：维护本地IP分配数据库，利用ipRanges功能为Pod子网提供动态配置
• portmap：基于iptables的端口映射插件，将主机地址空间的端口映射到容器

此外，Kindnet包含名为kindnetd的守护进程，具备以下功能：

• CNI配置：通过生成/etc/cni/net.d/10-kindnet.conflist文件配置CNI插件
• 路由管理：在节点上安装指向其他节点Pod子网的路由
• ip-masq：不对指向Pod的流量进行网络地址转换（NAT）伪装

使用场景和适用范围

• 适用于需要IPv4、IPv6或双栈网络支持的Kubernetes集群
• 适合所有节点处于同一子网的简单网络环境
• 特别适合KIND环境（作为默认CNI插件）
• 可用于实验性"真实"集群部署，验证新功能

使用方法和配置说明

安装方式

基本安装（默认使用ptp插件）

通过以下命令使用官方manifest安装Kindnet：

bash
kubectl create -f https://raw.githubusercontent.com/aojea/kindnet/master/install-kindnet.yaml

使用bridge插件安装

若需使用bridge插件而非默认的ptp，可通过设置kindnet-cni容器的CNI_BRIDGE环境变量实现，直接使用专用manifest：

bash
kubectl create -f https://raw.githubusercontent.com/aojea/kindnet/master/install-kindnet-bridge.yaml

手动安装CNI二进制文件

Kindnet安装manifest包含一个初始化容器，负责将CNI二进制文件部署到/opt/cni/bin/目录。若需手动安装CNI二进制文件，可移除manifest中的初始化容器，然后执行以下步骤：

bash
export ARCH="amd64"
export CNI_VERSION="v1.1.1"
export CNI_TARBALL="${CNI_VERSION}/cni-plugins-linux-${ARCH}-${CNI_VERSION}.tgz"
export CNI_URL="https://github.com/containernetworking/plugins/releases/download/${CNI_TARBALL}"
curl -sSL --retry 5 --output /tmp/cni.tgz "${CNI_URL}"
mkdir -p /opt/cni/bin
tar -C /opt/cni/bin -xzf /tmp/cni.tgz
rm -rf /tmp/cni.tgz

配置参数

• CNI_BRIDGE：环境变量，设置后将使用bridge插件替代默认的ptp插件，需在kindnet-cni容器中配置