2. DPDK环境搭建

在开始 DPDK 应用开发之前，搭建一个正确、稳定的运行环境是首要任务。本章将带领你在 Ubuntu 和 CentOS 两大主流 Linux 发行版上，完成 DPDK 的安装、大页内存配置、网卡驱动绑定，并最终编译运行经典的 helloworld 示例程序，验证整个环境是否就绪。

2.1 环境准备与依赖安装

DPDK 对系统内核和编译工具有明确要求。在开始安装前，请确保你的系统满足以下最低条件：

安装基础依赖（Ubuntu）：

sudo apt update
sudo apt install -y build-essential linux-headers-$(uname -r) \
  python3-pip python3-dev pkg-config libnuma-dev
pip3 install meson ninja

安装基础依赖（CentOS）：

sudo yum install -y epel-release
sudo yum install -y gcc gcc-c++ make kernel-devel python3-pip \
  python3-devel numactl-devel pkgconfig
pip3 install meson ninja

2.2 下载与编译 DPDK

我们以 DPDK 22.11 LTS 版本为例，演示从源码编译的完整流程。该版本是目前最稳定的长期支持版本，广泛应用于生产环境。

# 下载源码
wget https://fast.dpdk.org/rel/dpdk-22.11.tar.xz
tar -xf dpdk-22.11.tar.xz
cd dpdk-22.11

# 配置构建目录
meson setup build

# 编译
ninja -C build

# 安装到系统目录（可选，但推荐）
sudo ninja -C build install
sudo ldconfig

2.3 配置大页内存（HugePages）

大页内存是 DPDK 性能的核心基石。它减少了 TLB（Translation Lookaside Buffer）未命中次数，显著提升内存访问效率。DPDK 通常需要 2MB 或 1GB 的大页。

配置 2MB 大页（推荐用于学习和开发）：

# 临时分配 1024 个 2MB 大页（共 2GB）
echo 1024 | sudo tee /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages

# 永久配置（Ubuntu - 编辑 /etc/default/grub）
# 在 GRUB_CMDLINE_LINUX 中添加：default_hugepagesz=2M hugepagesz=2M hugepages=1024
# 然后执行：sudo update-grub && sudo reboot

# 挂载 hugetlbfs
sudo mkdir -p /mnt/huge
sudo mount -t hugetlbfs nodev /mnt/huge
# 永久挂载：在 /etc/fstab 中添加一行：nodev /mnt/huge hugetlbfs defaults 0 0

验证大页配置：

# 查看大页分配情况
cat /proc/meminfo | grep Huge

# 输出示例：
# AnonHugePages:         0 kB
# ShmemHugePages:        0 kB
# HugePages_Total:    1024
# HugePages_Free:     1024
# HugePages_Rsvd:        0
# HugePages_Surp:        0
# Hugepagesize:       2048 kB

2.4 网卡驱动绑定：uio_pci_generic 与 vfio-pci

DPDK 需要将网卡从内核原生驱动（如 igb、ixgbe、i40e）解绑，并绑定到用户态驱动框架。两种主流选择对比如下：

方法一：绑定到 uio_pci_generic（简单通用）

# 加载内核模块
sudo modprobe uio
sudo modprobe uio_pci_generic

# 使用 dpdk-devbind.py 工具绑定网卡（以 ens3f0 为例）
# 首先查看当前网卡驱动状态
sudo dpdk-devbind.py --status

# 解绑内核驱动并绑定到 uio_pci_generic
sudo dpdk-devbind.py -b uio_pci_generic 0000:02:00.0

# 验证绑定结果
sudo dpdk-devbind.py --status

方法二：绑定到 vfio-pci（推荐生产环境）

# 加载 vfio 相关模块
sudo modprobe vfio
sudo modprobe vfio-pci
sudo modprobe vfio_iommu_type1

# 如果系统支持 IOMMU，需在 GRUB 中开启：
# GRUB_CMDLINE_LINUX="... intel_iommu=on iommu=pt"
# 然后 sudo update-grub && sudo reboot

# 绑定网卡到 vfio-pci
sudo dpdk-devbind.py -b vfio-pci 0000:02:00.0

2.5 编译与运行 helloworld 示例

helloworld 是 DPDK 的“入门仪式”，它验证了环境搭建、大页配置、驱动绑定和基础 API 调用是否全部正确。

编译 helloworld：

# 进入示例程序目录
cd dpdk-22.11/examples/helloworld

# 使用 meson 编译（如果之前编译时未启用 examples）
# 回到 DPDK 根目录，重新配置
cd ../..
meson configure -Dexamples=helloworld build
ninja -C build

# 编译后的二进制位于 build/examples/helloworld

运行 helloworld：

# 切换到 root 用户（DPDK 需要 root 权限操作大页和硬件）
sudo -i

# 设置大页挂载点环境变量（可选，但建议）
export DPDK_HUGE_DIR=/mnt/huge

# 运行 helloworld
cd /path/to/dpdk-22.11/build/examples
./helloworld -l 0-1 -n 2

# 预期输出：
# EAL: Detected 4 lcore(s)
# EAL: Detected 1 NUMA nodes
# EAL: Multi-process socket /var/run/dpdk/rte/mp_socket
# EAL: Selected IOVA mode 'VA'
# EAL: No available 2048 kB hugepages reported
# ...（如果大页配置正确，则不会出现上述警告）
# hello from core 0
# hello from core 1

2.6 环境搭建全流程 SVG 架构图

下图总结了从系统准备到 helloworld 运行的整体流程，帮助你建立全局视角：

2.7 环境验证清单

完成上述步骤后，建议使用以下清单逐项确认环境状态，避免后续开发中遇到基础问题：