简介这份资源是面向SDN与可编程数据平面学习者的P4开发环境离线安装包针对P4初学者及需要搭建实验平台的网络研究人员解决bmv2、p4c等组件版本匹配繁琐、依赖编译易出错的问题。压缩包为gz格式整体约147.8MB内含behavioral-model、gmock-1.7.0、p4c、protobuf-3.2.0与thrift-0.9.2等源码组件覆盖P4软件交换机、编译器及底层序列化与RPC依赖便于一次性配齐工具链。目前已有609人学习下载说明该组合在P4社区中具有一定参考价值。借助这些组件读者可完成P4程序的编译、下发与仿真验证理解bmv2的行为模型与p4c的编译流程并规避protobuf、thrift版本不兼容导致的构建失败为后续实验与项目开发打好环境基础。1. P4 开发环境搭建为什么这套 2017 年的老版本组合至今还在被反复下载如果你最近在搜 behavioral-model、p4c、protobuf-3.2.0 这几个词大概率是拿到了一个 P4 的课程设计或者实验环境包然后发现按官方最新文档走根本跑不起来。这不是你的问题。P4 生态在 2017 到 2019 年之间经历了一次剧烈的版本断层p4c 的很多经典教程和论文复现都锁死在 protobuf 3.2.0 thrift 0.9.2 gmock 1.7.0 这个组合上。你手上这个安装包本质上是一套经过验证的依赖快照把 behavioral-modelbmv2、p4c 编译器、protobuf、thrift、gmock 五个组件的版本关系固定下来省去你逐个试错的时间。它适合正在做 P4 入门实验、SDN 课程设计、或者需要复现早期 P4 论文的工程师和学生。不适合已经在用 P4-16 最新规范做生产部署的人那套流程完全不同。2. 五个组件到底在干什么从源码到数据平面的完整链路2.1 bmv2 是软件交换机p4c 是编译器其余三个是它们的“地基”先把角色分清楚。behavioral-model通常叫 bmv2是一个用 C 写的 P4 软件交换机它实现了 P4 的抽象转发模型让你在没有硬件的情况下跑通 P4 程序。p4c 是 P4 编译器负责把你写的 P4 代码翻译成 bmv2 能识别的 JSON 配置。protobuf 在这里不是用来做 RPC 的而是 p4c 和 bmv2 之间传递中间表示IR的序列化工具。thrift 则是 bmv2 对外提供管理接口的 RPC 框架你用simple_switch_CLI或者 Python 脚本控制交换机时底层走的就是 thrift。gmock 是 Google Mockp4c 和 bmv2 的单元测试依赖它。这五个东西的版本必须严格匹配。protobuf 3.2.0 是 p4c 早期版本硬编码依赖的版本thrift 0.9.2 是 bmv2 的--enable-thrift选项默认查找的版本gmock 1.7.0 则是为了兼容当时 C11 的编译环境。你如果换成 protobuf 3.20 或者 thrift 0.13编译阶段就会报一堆undefined reference或者protoc version mismatch。常见做法是先装 gmock再装 protobuf然后 thrift最后 bmv2 和 p4c。顺序反了链接器会找不到符号。2.2 安装顺序与依赖检查一条命令确认你的系统缺什么在开始编译之前先确认系统里没有残留的新版本库。我一般会跑一遍下面的检查脚本把常见的冲突项列出来。# 检查是否已安装冲突版本的 protobuf 和 thrift which protoc protoc --version which thrift thrift --version # 检查动态库链接情况 ldconfig -p | grep -E protobuf|thrift|gmock # 检查 pkg-config 路径 pkg-config --list-all | grep -E protobuf|thrift逻辑说明which protoc和thrift --version用来确认系统 PATH 里有没有其他版本。如果输出是 3.20 或者 0.13你需要先卸载或者把它们移出 PATH。ldconfig -p看的是动态链接库缓存如果里面有libprotobuf.so.20之类的编译时链接器可能优先找到它而不是你刚装的 3.2.0。pkg-config是很多构建脚本用来找头文件和库路径的工具如果它指向了错误版本./configure阶段就会失败。参数说明grep -E是扩展正则用来同时匹配多个关键词。ldconfig -p不需要 root 权限但输出较多建议配合 grep 使用。如果你在容器里操作注意基础镜像可能已经带了 protobuf 的运行时库需要手动清理。提示不要用apt remove protobuf这种粗暴方式很多系统组件依赖它。正确做法是编译安装到/usr/local下然后调整LD_LIBRARY_PATH和PKG_CONFIG_PATH。2.3 从 gmock 到 p4c逐组件编译的命令与参数假设你已经把安装包解压到了~/p4-env目录下面按顺序给出每个组件的编译命令。注意每个组件的--prefix都指向同一个自定义目录避免污染系统路径。# 1. 编译安装 gmock-1.7.0 cd ~/p4-env/gmock-1.7.0 mkdir -p build cd build cmake .. -DCMAKE_INSTALL_PREFIX/usr/local/p4env make -j$(nproc) sudo make install # 2. 编译安装 protobuf-3.2.0 cd ~/p4-env/protobuf-3.2.0 ./autogen.sh ./configure --prefix/usr/local/p4env make -j$(nproc) sudo make install # 3. 编译安装 thrift-0.9.2 cd ~/p4-env/thrift-0.9.2 ./configure --prefix/usr/local/p4env --without-python --without-java make -j$(nproc) sudo make install # 4. 编译安装 behavioral-model cd ~/p4-env/behavioral-model ./autogen.sh ./configure --prefix/usr/local/p4env --with-p4cno --enable-debugger make -j$(nproc) sudo make install # 5. 编译安装 p4c cd ~/p4-env/p4c mkdir -p build cd build cmake .. -DCMAKE_INSTALL_PREFIX/usr/local/p4env -DENABLE_BMV2ON make -j$(nproc) sudo make install逻辑说明gmock 用 cmake 构建因为它的源码包里没有 configure 脚本。protobuf 和 thrift 用 autotoolsautogen.sh用来生成 configure 脚本。bmv2 的--with-p4cno表示不依赖 p4c 的安装路径因为我们后面会单独装 p4c。--enable-debugger打开调试器支持方便你用p4db单步跟踪。p4c 的-DENABLE_BMV2ON让编译器生成 bmv2 后端。参数说明-j$(nproc)用满所有 CPU 核心编译 protobuf 和 thrift 时能省不少时间。--prefix/usr/local/p4env是自定义安装路径后面需要把这个路径下的bin和lib加到环境变量里。--without-python和--without-java是为了减少 thrift 的编译依赖如果你需要 Python 绑定可以去掉这两个选项但要确保系统里有对应的开发包。编译完成后把环境变量写进~/.bashrcexport PATH/usr/local/p4env/bin:$PATH export LD_LIBRARY_PATH/usr/local/p4env/lib:$LD_LIBRARY_PATH export PKG_CONFIG_PATH/usr/local/p4env/lib/pkgconfig:$PKG_CONFIG_PATH然后source ~/.bashrc再跑protoc --version确认输出是libprotoc 3.2.0。如果还是旧版本检查which protoc的路径优先级。3. 跑通第一个 P4 程序从编译到交换机加载的完整验证3.1 写一个最小 P4 程序并编译成 JSON装完环境不验证等于没装。下面这个 P4 程序只做一件事把从端口 1 进来的包从端口 2 发出去。保存为forward.p4。#include core.p4 #include v1model.p4 header ethernet_t { bit48 dstAddr; bit48 srcAddr; bit16 etherType; } struct metadata { } parser MyParser(packet_in packet, out headers hdr, inout metadata meta, inout standard_metadata_t standard_metadata) { state start { packet.extract(hdr.ethernet); transition accept; } } control MyIngress(inout headers hdr, inout metadata meta, inout standard_metadata_t standard_metadata) { action forward(bit9 port) { standard_metadata.egress_spec port; } table ipv4_routing { key { hdr.ethernet.dstAddr : exact; } actions { forward; } default_action forward(2); } apply { ipv4_routing.apply(); } } control MyEgress(inout headers hdr, inout metadata meta, inout standard_metadata_t standard_metadata) { apply { } } control MyDeparser(packet_out packet, in headers hdr) { apply { packet.emit(hdr.ethernet); } } control MyComputeChecksum(inout headers hdr, inout metadata meta) { apply { } } V1Switch(MyParser(), MyIngress(), MyEgress(), MyComputeChecksum(), MyDeparser()) main;编译命令p4c-bm2-ss --std p4-16 forward.p4 -o forward.json逻辑说明p4c-bm2-ss是 p4c 安装后提供的 bmv2 后端编译器。--std p4-16指定 P4 语言版本。-o forward.json输出 bmv2 能加载的 JSON 文件。如果报错error: unknown command p4c-bm2-ss说明 p4c 的 bmv2 后端没编译进去回到 p4c 的 cmake 步骤检查-DENABLE_BMV2ON是否生效。参数说明--std可以省略默认就是 p4-16但显式写出来避免歧义。如果你的 P4 程序用了 v1model 之外的架构需要换对应的后端命令。3.2 启动 bmv2 并加载 JSON用 CLI 验证转发编译出 JSON 之后用simple_switch启动软件交换机。sudo simple_switch -i 0veth0 -i 1veth1 forward.json 逻辑说明-i 0veth0把 bmv2 的端口 0 绑定到 Linux 的 veth0 接口。你需要提前用ip link add创建一对 veth 设备。让交换机在后台运行。启动后bmv2 会监听 thrift 端口 9090。验证步骤# 进入 CLI simple_switch_CLI --thrift-port 9090 # 在 CLI 里查看表项 table_dump ipv4_routing # 添加一条表项目的 MAC 为 00:00:00:00:00:02 的包从端口 1 发出 table_add ipv4_routing forward 00:00:00:00:00:02 1逻辑说明table_dump显示当前表的内容默认只有default_action。table_add插入一条精确匹配表项。如果你看到RuntimeError: Invalid table name说明 JSON 里的表名和 CLI 里输入的不一致用table_dump确认实际表名。参数说明--thrift-port默认是 9090如果你启动 bmv2 时改了端口这里要对应。table_add的参数顺序是表名、动作名、匹配键、、动作参数。不同版本的 bmv2 对的解析可能有差异如果报语法错误试试用table_add ipv4_routing forward 00:00:00:00:00:02 1。注意veth 设备需要 root 权限创建但 bmv2 本身可以用普通用户跑只要 thrift 端口不被占用。如果你在虚拟机里确保内核支持 veth 模块。4. 避坑与排查五个让编译和运行翻车的典型场景4.1 现象protoc 报 “Unrecognized syntax identifier proto3”原因系统里存在两个 protobuf 版本protoc命令实际调用的是旧版 2.x而 p4c 的.proto文件用了 proto3 语法。解决用which -a protoc列出所有路径确认/usr/local/p4env/bin/protoc排在第一位。如果/usr/bin/protoc还在前面调整PATH顺序或者临时用绝对路径调用。4.2 现象thrift 编译到一半报 “error: ‘uint64_t’ does not name a type”原因thrift 0.9.2 的源码没有包含cstdint头文件在较新的 GCC9 以上上会报这个错。解决在thrift-0.9.2/lib/cpp/src/thrift/下的相关头文件里手动加#include cstdint或者编译时加-include cstdint标志。常见做法是直接改configure.ac里的CXXFLAGS加上-include cstdint。4.3 现象bmv2 启动时报 “error while loading shared libraries: libthrift-0.9.2.so”原因LD_LIBRARY_PATH没有包含/usr/local/p4env/lib或者ldconfig缓存没更新。解决先确认echo $LD_LIBRARY_PATH里有自定义路径然后跑sudo ldconfig刷新缓存。如果还是不行在/etc/ld.so.conf.d/下新建一个p4env.conf写入/usr/local/p4env/lib再sudo ldconfig。4.4 现象p4c 编译 P4 程序时报 “Unknown extern type standard_metadata_t”原因v1model.p4的 include 路径没被 p4c 找到。p4c 默认会在安装目录下的share/p4c/p4include里找标准库。解决用-I参数显式指定路径例如p4c-bm2-ss -I /usr/local/p4env/share/p4c/p4include forward.p4 -o forward.json。或者把P4C_INCLUDE_PATH环境变量设成这个目录。4.5 现象simple_switch_CLI 连接被拒绝 “Connection refused”原因bmv2 没有启动成功或者 thrift 端口被防火墙拦截。解决先看 bmv2 的启动日志确认没有报错退出。然后用netstat -tlnp | grep 9090检查端口是否在监听。如果 bmv2 是用sudo启动的而 CLI 是普通用户检查 thrift 的绑定地址是不是127.0.0.1。常见做法是启动 bmv2 时加--thrift-ip 0.0.0.0但生产环境不建议这么做。5. 进阶技巧用 Python 脚本批量下发流表并验证转发路径环境跑通之后手动敲 CLI 效率太低。我一般会写一个 Python 脚本通过 thrift 接口批量下发流表然后用scapy构造测试包验证转发路径。下面这个脚本演示了如何连接 bmv2、清空表、插入两条表项并发送一个包。import sys import time from scapy.all import Ether, IP, UDP, sendp # 添加 bmv2 的 thrift 生成代码路径 sys.path.append(/usr/local/p4env/lib/python3.8/site-packages) from bm_runtime.simple_switch import SimpleSwitch def add_flow(client, table, key, action, params): 向指定表添加流表项 client.table_add(table, action, key, params) def main(): # 连接 bmv2 的 thrift 服务 client SimpleSwitch(localhost, 9090) client.connect() # 清空所有表项 client.table_clear(ipv4_routing) # 添加表项目的 MAC 00:00:00:00:00:02 - 端口 1 add_flow(client, ipv4_routing, [00:00:00:00:00:02], forward, [1]) # 添加表项目的 MAC 00:00:00:00:00:03 - 端口 2 add_flow(client, ipv4_routing, [00:00:00:00:00:03], forward, [2]) # 构造测试包从 veth0 发出 pkt Ether(dst00:00:00:00:00:02, src00:00:00:00:00:01) / \ IP(src10.0.0.1, dst10.0.0.2) / \ UDP(sport1234, dport5678) / bhello sendp(pkt, ifaceveth0, count1, verboseFalse) print(Flow entries installed and test packet sent.) client.disconnect() if __name__ __main__: main()逻辑说明SimpleSwitch是 thrift 生成的客户端类connect()建立连接。table_clear清空指定表避免旧表项干扰。table_add的参数是表名、动作名、匹配键列表、动作参数列表。sendp从veth0发送一个以太网帧目的 MAC 匹配我们刚加的表项bmv2 应该把它从端口 1 转发出去。你可以在veth1上用tcpdump抓包验证。参数说明sys.path.append的路径取决于你的 Python 版本和 thrift 安装位置常见是/usr/local/p4env/lib/python3.x/site-packages。table_add的匹配键格式要和 P4 程序里的key类型一致MAC 地址用字符串列表传入。sendp的iface参数要和你创建 veth 设备时绑定的名称一致。验证方法开两个终端一个跑sudo tcpdump -i veth1 -e -c 5另一个跑上面的 Python 脚本。如果tcpdump抓到了目的 MAC 为00:00:00:00:00:02的包说明转发路径正确。如果没抓到先检查table_dump确认表项存在再用simple_switch_CLI的register_read看端口计数器。从那以后我每次配 P4 环境都强制走一遍这个验证流程先protoc --version确认版本再编译一个最小 P4 程序然后启动 bmv2 加表转发最后用 Python 脚本自动化。这套习惯帮我省掉了至少三次重装系统的时间。希望帮到你。本文还有配套的精品资源点击获取