云原生网络后端【免费下载链接】cniContainer Network Interface - networking for Linux containers项目地址https://gitcode.com/gh_mirrors/cn/cni点击查看免费下载cnitool是 CNIContainer Network Interface官方仓库内置的命令行工具用于在**已创建的网络命名空间network namespace**中直接执行 CNI 配置对网络接口执行add、check、del、gc、status等操作全程不需要任何容器运行时如 Docker、containerd。阅读本文后你将掌握cnitool的全部环境变量与子命令用法能够脱离容器运行时独立搭建「配置 命名空间 插件」的最小调试环境并理解其底层如何通过libcni加载配置、注入参数并调用插件。一、cnitool 是什么面向插件开发者的最小测试工具cnitool是一个简单程序它的职责是执行一份 CNI 配置——将配置中声明的网络接口加入add、检查check、移除del、垃圾回收gc或查询状态status于一个已经创建好的网络命名空间中。这一点与容器运行时如 Kubernetes 的 kubelet、containerd、CRI-O扮演的角色完全一致区别在于cnitool只接收两个位置参数——网络名network name与网络命名空间路径因此非常适合在开发、调试 CNI 插件时快速验证插件行为在无容器环境裸机、CI中复现网络配置问题作为 CNI 规范学习的最小可运行示例理解 CNI 的配置加载与插件调用协议。从源码看cnitool的入口位于 cnitool/main.gomain()直接调用cmd.Execute()命令框架基于 Cobra见 cnitool/cmd/root.go 中rootCmd的定义而真正的插件调用全部委托给仓库的libcni包完成。libcni是 CNI 规范的实际实现libcni/api.go 注释明确说明这一点通常被 containerd、CRI-O 等运行时库嵌入使用cnitool则是它最直观的命令行外壳。二、环境变量详解cnitool 的五大输入通道cnitool不通过配置文件传递运行时信息而是依赖操作系统环境变量向插件传递协议参数。这些常量的定义见 cnitool/cmd/root.go 的const块环境变量作用默认值NETCONFPATHCNI 配置文件搜索目录/etc/cni/net.dCNI_PATHCNI 插件二进制搜索路径无需显式设置CNI_ARGS传递给插件的普通参数格式KEY1VALUE1;KEY2VALUE2;...无CAP_ARGS传递给插件的 capability 参数JSON 格式无CNI_IFNAME待配置的接口名eth01. NETCONFPATH配置文件目录与搜索优先级NETCONFPATH指向一个目录默认是/etc/cni/net.d。cnitool按如下优先级在该目录中查找 CNI 配置优先搜索扩展名为*.conflist的文件——它代表一组插件配置的列表list若目录中不存在任何*.conflist文件则回退搜索扩展名为*.conf或*.json的文件——它代表单个插件的配置。cnitool会加载该目录下的全部 CNI 配置文件当找到name字段与命令行传入的网络名一致的配置时返回对应配置否则返回nil。这一先 conflist、后 conf/json的优先级与libcni的实现完全对应libcni/conf.go 中的LoadNetworkConf(dir, name)先通过ConfFiles(dir, [.conflist])收集并排序所有.conflist文件逐一匹配网络名若全部不匹配再回退到LoadConf(dir, name)去扫描*.conf/*.json并将单个插件配置升级upconvert为NetworkConfigListConfListFromConf。找不到时分别抛出NotFoundErrorno net configuration with name ... in ...或NoConfigsFoundErrorno net configurations found in ...错误。值得补充的细节加载.conflist时若未启用loadOnlyInlinedPluginslibcni还会顺带读取「配置文件同目录下、以网络名命名的子目录」中的*.conf作为附加插件定义见 libcni/conf.go 的NetworkPluginConfsFromFiles。2. CNI_PATH插件二进制在哪里对于给定的 CNI 配置cnitool会沿CNI_PATH搜索对应的插件可执行文件。root.go中的getCNIConfig()通过filepath.SplitList(os.Getenv(EnvCNIPath))解析该变量——这意味着它支持系统路径分隔符Linux 下为冒号:分隔的多个目录最终构造出libcni.NewCNIConfig(path, nil)由libcni负责在路径列表中查找并执行插件默认执行器为invoke.DefaultExec见 libcni/api.go 的ensureExec()。3. CNI_ARGS普通键值对参数CNI_ARGS以KEY1VALUE1;KEY2VALUE2;...的格式向插件传递普通参数。root.go的parseArgs()按分号;切分出键值对、再按等号拆分为 key/value若某个分段的格式非法不是恰好一个、或 key/value 为空会直接报错invalid CNI_ARGS pair。解析结果被放入RuntimeConf.Args最终以CNI_ARGS环境变量的形式传给插件。4. CAP_ARGSJSON 格式的 capability 参数CAP_ARGS是可选的 capability 参数采用JSON 格式例如{portMappings:[...],bandwidth:{...}}。root.go用json.Unmarshal将其解析为map[string]interface{}存入RuntimeConf.CapabilityArgs。底层机制libcni/api.go 的injectRuntimeConfig是只有插件在配置中声明支持、且运行时确实提供了对应数据的 capability 键才会被注入到插件 stdin 配置的runtimeConfig字典中——避免把插件不认识的参数传下去。5. CNI_IFNAME接口名指定要配置的网络接口名称。其取值遵循三级回退链见root.go的setupRuntimeConfig命令行-i/--ifname优先 → 其次CNI_IFNAME环境变量 → 最后回退为默认值eth0。三、命令行用法与全部子命令cnitool的完整帮助信息如下与 cnitool/README.md 记录一致cnitool: CNI Tool for managing network interfaces in a network namespace Usage: cnitool [command] Available Commands: add Add network interface to a network namespace check Check network interface in a network namespace completion Generate the autocompletion script for the specified shell del Delete network interface from a network namespace gc Garbage collect network interfaces help Help about any command status Get status of network interfaces Flags: -h, --help help for cnitool -i, --ifname string Interface name (defaults to env var CNI_IFNAME or eth0) Use cnitool [command] --help for more information about a command.除completionCobra 框架自带的 shell 自动补全脚本生成器和help外其余五个子命令均要求至少两个位置参数network-name网络名对应NETCONFPATH目录下某份配置的name字段和netns网络命名空间路径会被转换为绝对路径。各子命令与libcniAPI 的对应关系如下子命令语法底层调用说明addcnitool add network-name netnsAddNetworkList创建网络接口并加入指定命名空间成功后打印 CNI 结果见 cnitool/cmd/add.gocheckcnitool check network-name netnsCheckNetworkList校验接口是否按预期配置仅适用于 spec v0.4.0见 cnitool/cmd/check.godelcnitool del network-name netnsDelNetworkList从命名空间中移除接口见 cnitool/cmd/del.gogccnitool gc network-name netnsGCNetworkList垃圾回收网络接口当前实现以nil参数调用源码注释表明所有网络接口都应被回收见 cnitool/cmd/gc.gostatuscnitool status network-name netnsGetStatusNetworkList获取网络接口的状态见 cnitool/cmd/status.go运行时配置是如何拼装出来的每次执行root.go的setupRuntimeConfig()都会做同一套准备工作理解它有助于排查问题校验位置参数数量取netName与netNS确定配置目录NETCONFPATH为空则用默认/etc/cni/net.d调用libcni.LoadNetworkConf加载网络配置解析CAP_ARGSJSON与CNI_ARGS;分隔键值对按-i标志 →CNI_IFNAME→eth0的顺序确定接口名将netNS转换为绝对路径用 netns 路径的 SHA-512 哈希生成稳定的容器 IDcontainerID : fmt.Sprintf(cnitool-%x, s[:10])即cnitool-前缀加哈希前 10 字节的十六进制串——这也是 CNI 缓存默认缓存目录/var/lib/cni见 libcni/api.go 的CacheDir中该次操作的关联标识。随后拼装libcni.RuntimeConf{ContainerID, NetNS, IfName, Args, CapabilityArgs}交给CNIConfig对应的AddNetworkList/CheckNetworkList/DelNetworkList/GCNetworkList/GetStatusNetworkList执行。四、完整实战示例用 ptp 插件给网络命名空间加网卡下面按 cnitool/README.md 的示例走一遍「安装 → 建配置 → 建命名空间 → add → check → 验证 → 清理」的完整流程。第一步安装 cnitoolgo get github.com/containernetworking/cni go install github.com/containernetworking/cni/cnitoolcnitool是本仓库go.mod中 module 为github.com/containernetworking/cniGo 版本要求 1.21的一个独立可执行包位于cnitool/目录。第二步获取并构建插件示例需要使用真实的 CNI 插件。按原文档步骤检出 containernetworking/plugins 插件集并构建所有命令在该目录下执行git clone https://github.com/containernetworking/plugins.git cd plugins ./build_linux.sh # 或Windows 环境 ./build_windows.sh构建产物位于plugins/bin目录稍后通过CNI_PATH./bin提供给cnitool。本仓库的plugins/目录下也自带noop、sleep、debug等测试用插件实现见 plugins/test/noop/main.go可作为最小插件的阅读参考。第三步创建网络配置echo {cniVersion:0.4.0,name:myptp,type:ptp,ipMasq:true,ipam:{type:host-local,subnet:172.16.29.0/24,routes:[{dst:0.0.0.0/0}]}} | sudo tee /etc/cni/net.d/10-myptp.conf这是一份典型的单插件配置*.confcniVersion声明 CNI 规范版本0.4.0name为网络名myptptype指向ptp插件点对点接口ipMasq开启 IP 伪装ipam使用host-local分配172.16.29.0/24子网并添加默认路由。由于该目录此时没有.conflist文件cnitool会按第二条优先级规则命中这份*.conf。第四步创建网络命名空间sudo ip netns add testingcnitool要求命名空间已经存在——它只负责在网络命名空间内操作接口不负责创建命名空间。创建后其路径为/var/run/netns/testing。第五步把容器命名空间加入网络sudo CNI_PATH./bin cnitool add myptp /var/run/netns/testingCNI_PATH指向构建好的插件目录网络名myptp对应配置中的name第二个参数是命名空间路径。成功执行后add命令会打印 CNI 返回结果接口、IP、路由等。整个流程需要 root 权限因为要操作网络命名空间与内核网络栈。第六步校验网络是否符合预期仅 spec v0.4.0sudo CNI_PATH./bin cnitool check myptp /var/run/netns/testingcheck操作依赖 CNI spec v0.4.0 引入的 CHECK 命令因此示例配置特意声明cniVersion:0.4.0。若插件不支持 CHECKlibcni会返回does not support the CHECK command错误见 libcni/api.go 的ErrorCheckNotSupp。第七步验证网络确实可用sudo ip -n testing addr sudo ip netns exec testing ping -c 1 4.2.2.2第一条命令查看testing命名空间内的接口与 IP应能看到ptp创建的 veth 对与172.16.29.x地址第二条命令从命名空间内部向外发起一次 ping验证 IP 分配与路由、NAT 链路是否真正打通。第八步清理sudo CNI_PATH./bin cnitool del myptp /var/run/netns/testing sudo ip netns del testingdel调用DelNetworkList释放插件资源删除 veth、回收 IP随后删除命名空间本身。此时配置目录/etc/cni/net.d/10-myptp.conf仍可保留方便反复试验。五、capability 与参数传递的底层机制进阶使用CAP_ARGS时需要理解libcni的 capability 注入协议插件的配置 JSON 中会声明capabilities字段如{portMappings: true}运行时通过CAP_ARGS提供的数据只会被挑选出「插件声明支持」的部分写入插件 stdin 配置的顶层runtimeConfig字典后再调用插件。相关逻辑在 libcni/api.go 的buildOneConfig与injectRuntimeConfig中实现——每个插件收到的 stdin 配置还会被统一注入网络name与cniVersion链路中的前序插件结果则会作为prevResult传给下一个插件这正是*.conflist多插件串联的基础。六、使用注意事项权限操作网络命名空间和内核网络栈需要 root示例统一使用sudocheck 版本限制check仅对 CNI spec v0.4.0 及更高版本有效低版本配置或旧插件会报不支持命名空间必须预先创建cnitool不创建、也不删除命名空间只在其内部增删接口配置目录默认值不设置NETCONFPATH时默认读取/etc/cni/net.d需要 root 写入权限开发期也可改用其他目录并通过环境变量指定gc 的当前行为从 cnitool/cmd/gc.go 源码可见目前以空参数调用GCNetworkList即默认回收该网络配置相关的全部接口符合预期后再逐步精细化跨平台插件构建脚本同时提供build_linux.sh与build_windows.shcnitool本身也可在 Windows 上使用配套的命名空间处理见 pkg/ns/ns_windows.go。七、延伸阅读Documentation/cnitool.md仓库 docs 中对cnitool的概述强调它无需容器运行时即可测试 CNI 插件的定位libcni/api.go、libcni/conf.gocnitool背后的 CNI 规范实现含配置加载、capability 注入、结果缓存与 GC 全流程SPEC.mdCNI 规范全文可对照理解add/check/del/gc/status各操作与配置、结果格式的规范语义pkg/invoke/delegate.go插件进程的实际调用与参数封装细节cnitool/cmd/root.go环境变量解析、容器 ID 生成与运行时配置拼装的核心逻辑。赞分享云原生网络后端【免费下载链接】cniContainer Network Interface - networking for Linux containers项目地址https://gitcode.com/gh_mirrors/cn/cni点击查看免费下载相关推荐cnitool 使用指南用 CNI 官方命令行工具零容器运行时测试与调试 CNI 插件cnitool 使用指南用 CNI 官方命令行工具零容器运行时测试与调试 CNI 插件 本指南围绕容器网络接口Container Network Inter云原生网络后端TUnit与Kubernetes在容器编排环境中运行测试TUnit与Kubernetes在容器编排环境中运行测试 容器化测试架构概述 现代软件开发中将测试环境与生产环境对齐已成为质量保障的关键实践。TUnit作为Hummingbot 测试环境搭建指南在 VS Code / Cursor 中运行与调试 pytestHummingbot 测试环境搭建指南在 VS Code / Cursor 中运行与调试 pytest 本指南基于仓库根目录下的 CURSOR_VSCODE_金融科技CLI上一篇Penzai可视化工具Treescope让你的神经网络一目了然下一篇react-jsonschema-form表单性能分析Lighthouse报告解读创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考