前阵子课题需要做信息中心网络相关的实验我花了不少时间折腾ndnSIM——基于NS-3的命名数据网络Named Data NetworkingNDN模拟器。网上关于ndnSIM的资料虽然不少但大多偏零散新手光是把环境跑起来就要卡好几天。这篇文章是我的ndnSIM学习笔记第一篇记录我从零开始安装、理解原理、跑通第一个仿真脚本的全过程。如果你正准备做NDN方向的仿真实验或者想找一个能支撑网络层协议研究的模拟器这篇应该能帮你省下不少时间。1. 初识ndnSIM先搞懂我们在模拟什么1.1 一切从“内容名”开始NDN的核心思路传统IP网络是“主机到主机”的通信模型每台设备有一个IP地址通信前先建立到目标地址的连接然后按地址转发数据包。NDN的思路完全反过来它不关心数据存在哪台机器上只关心“内容本身”。每个内容有一个唯一的名字比如/myhome/video/intro.mp4接收方发送一个Interest包兴趣包按名字请求内容网络中的路由器根据名字查询自己的转发信息库找到能返回该内容的接口把Interest转出去内容提供方收到Interest后沿着原路径返回一个Data包数据包。整个过程和“按书名找书”很相似——你不需要知道书在哪个书架的哪一层只需要给管理员报书名他会带你去取。这个设计带来几个非常实际的好处。一是天然支持多路径和多源获取同一个内容在网络里可以有多个副本消费者就近取不用管源在哪二是在网缓存NDN路由器转发数据时会把内容留在缓存里下一个请求相同内容的消费者直接从缓存拿到数据这对视频分发、物联网数据共享这类以内容为主的场景很友好。三是安全性绑定在内容本身而不是信道数据包带签名名字和内容绑定任何人拿到的数据都能验签。1.2 为什么要选ndnSIM而不是其他模拟器NDN方向的研究者在选择实验工具时通常绕不开三个选择用真实路由器部署比如Named Data Networking Forwarding DaemonNFD、用Mininet跑真实协议栈、或者用网络模拟器。前两种方法更接近真实环境但要搭建多节点实验拓扑很费劲尤其是在没有硬件设备的情况下。模拟器最大的优势是成本低、可重复、规模可控几百个节点的实验拓扑用脚本几分钟就能生成。ndnSIM是目前NDN研究社区最主流的模拟器之一。它是NS-3的一个外部模块继承了NS-3的事件驱动模拟机制和丰富的网络组件库同时又实现了完整的NDN协议栈包括命名数据包的转发管道、CS缓存、PIT待定兴趣表、FIB转发信息库、各种转发策略和缓存替换算法。和CCNx或ICN-Sim这类独立模拟器相比ndnSIM的好处是第一它建立在NS-3庞大的生态上物理层、链路层、传输层组件可以随意组合第二它的模块化程度高你可以在不修改核心代码的情况下替换策略算法或缓存策略这对做对比实验很重要第三社区活跃代码持续更新论文里的复现资源很多都基于ndnSIM。2. 环境搭建从零开始装一个能跑的ndnSIM2.1 版本选择与依赖准备别在版本坑里浪费一天ndnSIM的版本问题是我觉得新手最容易栽跟头的地方。ndnSIM目前主流版本是2.x系列它对应不同版本的NS-3。你如果用ndnSIM 2.8版本需要配NS-3.29如果源码版本和下层的NS-3版本不匹配会直接出现编译错误。我一开始图省事直接从GitHub上拉了一个默认分支结果编译时跑出来一堆莫名其妙的类型错误后来才发现是版本号对齐问题。建议直接去官方文档页面查清版本对应表再动手。系统依赖方面在Ubuntu 20.04上需要先装这些包sudo apt-get install build-essential python3 g pkg-config sudo apt-get install libboost-all-dev libsqlite3-dev libssl-dev sudo apt-get install libpcre3-dev flex bisonBoost库是必须的ndnSIM底层大量使用Boost的数据结构和算法SQLite用来存储仿真数据和管理内容存储OpenSSL负责签名和哈希相关的操作。如果是在老版本Ubuntu上装还要注意Python的版本ndnSIM 2.x的构建脚本依赖Python 3别用Python 2硬顶。2.2 编译安装的具体步骤ndnSIM的安装方式有两种一种是把它作为NS-3的独立模块编译另一种是用NS-3自带的模块机制加载。最常用的是第一种步骤如下mkdir ndnsim-workspace cd ndnsim-workspace git clone https://github.com/named-data-ndnSIM/ns-3-dev.git ns-3 git clone https://github.com/named-data-ndnSIM/pybindgen.git pybindgen git clone https://github.com/named-data-ndnSIM/ndnSIM.git ns-3/src/ndnSIM克隆完以后进入ns-3目录配置编译cd ns-3 ./waf configure --enable-examples --enable-tests ./waf build这里有个小细节--enable-examples会编译ndnSIM自带的示例程序强烈建议第一次装的时候加上后面学习可以直接运行示例验证安装是否正确。编译时间取决于机器性能我当时的服务器是8核大概编了十几分钟。如果你的机器内存不够可以在configure时加上-j4限制并行编译数量避免内存溢出。2.3 验证环境跑通官方示例编译完成后可以用ndnSIM自带的简单示例验证环境是否正常./waf --runndn-simple如果编译和安装都没问题运行后你会在终端里看到仿真输出信息包括节点创建记录、Interest和Data包的转发日志等。我第一次看到那些日志的时候说实话是有点懵的输出信息非常多而且很多是NS-3框架自己打印的运行状态。不用急着全部看懂只要确认没有报错、能正常结束就说明环境已经可用。3. 核心架构拆解弄懂ndnSIM的骨架3.1 它是NS-3的“寄居蟹”ndnSIM不是独立运行的模拟器而是作为NS-3的一个外部模块存在。这个关系经常被刚接触的人搞混。NS-3本身是一个网络模拟框架它提供了节点Node、信道Channel、网络设备NetDevice、事件调度器等基础设施ndnSIM在NS-3的节点上装载了一套独立的NDN协议栈相当于在模拟器里“寄生”了一套NDN网络。你可以把NS-3当作操作系统内核ndnSIM就是运行其上的一个完整的应用程序生态。ndnSIM的关键设计是NDN的协议栈并没有挂在传统IP的Socket接口上而是作为NS-3协议栈中一个独立的层次。NS-3的应用层发出的包不走IP协议栈而是直接进入ndnSIM的转发管道Forwarding Pipeline。这样做的好处是仿真的NDN流量不会受到TCP/IP协议机制的干扰实验结果更纯粹也方便研究者单独分析和优化NDN的每个环节。3.2 核心模块和类从Helper到Strategy第一次看ndnSIM源码时我被它的代码组织方式绕了一阵后来理清了几条主线再看就顺多了。第一个要认识的是协议栈Helper类。Helper是NS-3的常用设计模式它的作用是把复杂的安装过程封装起来你只需要调用一个方法系统就自动创建协议栈、设置参数。ndnSIM中核心的Helper是ndn::StackHelper它负责创建和安装NDN的L3协议栈实例并且初始化内容存储Content StoreCS、PIT、FIB这些基础数据结构。还有一个ndn::AppHelper用来安装业务应用比如消费者和生产者应用的参数配置、启动时间、停止时间。第二个核心是应用层。ndnSIM自带了两类常用应用ndn::ConsumerCbr和ndn::Producer。ConsumerCbr周期性地发送Interest包模拟一个持续请求内容的用户Producer负责响应Interest生成对应的Data包返回。这两个应用类足够支撑大部分基础仿真实验。如果要做更复杂的业务逻辑可以在它们的基础上继承改写这也是ndnSIM相对灵活的地方。第三个核心是策略模块。NDN的核心机制之一就是转发策略同一个内容名可能匹配FIB中的多条路由选择哪个接口转发、要不要发送到上游所有接口都是策略层决定的。ndnSIM默认的策略是BestRoute它会从FIB中选择一条到内容提供方的最优路径。做研究时可以自定义策略类比如做多路径转发、概率转发、基于延迟反馈的动态调整策略这些都只需要继承ndn::fw::Strategy类并实现相关方法。3.3 一个仿真场景的组成要素理解了模块后一个ndnSIM仿真场景本质上由四部分构成网络拓扑、网络层协议栈、转发策略、应用流量。网络拓扑是底层骨架用NS-3的Node和Channel搭建。ndnSIM支持PointToPointHelper、CsmaHelper、WifiHelper等NS-3标准的信道模型所以你可以模拟有线网络、无线网络、混合网络网络层协议栈就是nfdSIM的NDN栈策略决定Interest包怎么走应用决定流量模型。刚上手时最容易犯的错误是以为装好了协议栈就能跑流量。实际上还要为每个节点配置FIB路由表项告诉Interest往哪个方向转要为节点配置转发策略要给应用节点设置正确的NS-3节点ID和名字。我在刚开始跑多节点场景时经常因为忘了配FIB而出现Interest包发出去了却收不到Data的“假丢包”实际不是网络拥塞而是路由器根本不知道怎么转发。4. 第一个仿真脚本跑通ndn-simple4.1 场景设计两个节点最小拓扑第一个实验不用追求复杂搭一个最简单的双节点拓扑就够。节点0是Consumer节点1是Producer两节点通过点对点链路直连。Consumer每秒发送一个Interest请求内容名为/example/hello Producer收到Interest后返回一个名为/example/hello的Data包Consumer收到Data后打印日志并结束。拓扑极其简单但麻雀虽小五脏俱全协议栈安装、FIB配置、应用配置、策略配置、启动停止时间设置这些关键环节全都涉及。跑通这个场景你就掌握了ndnSIM最核心的仿真流程。4.2 代码逐段解析每句话在干什么完整代码可以从ns-3/src/ndnSIM/examples/ndn-simple.cpp里找到。关键片段如下#include ns3/core-module.h #include ns3/network-module.h #include ns3/point-to-point-module.h #include ns3/ndnSIM-module.h引入头文件NDN相关的功能都在ndnSIM-module.h里统一暴露。接下来创建两个节点NodeContainer nodes; nodes.Create(2);创建NS-3节点这两行代码会生成两个没有安装任何网络协议的空节点。然后构造点对点信道PointToPointHelper p2p; p2p.Install(nodes);这里创建了一条节点0到节点1的点对点链路默认速率和数据包大小由NS-3的默认值决定之后可以在模型里自定义。注意Install方法的调用会直接把点对点网络设备安装到节点上为后面的NDN协议栈提供承载。然后是NDN协议栈的安装ndn::StackHelper ndnHelper; ndnHelper.InstallAll();这段代码在每个节点上安装NDN协议栈。默认情况下会开启CS设置CS的最大容量和缓存策略同时初始化PIT和FIB。安装完后就可以在节点上部署应用了。ndn::AppHelper consumerHelper(ns3::ndn::ConsumerCbr); consumerHelper.SetAttribute(Frequency, StringValue(1)); consumerHelper.Install(nodes.Get(0));创建ConsumerCbr应用把发送频率设为每秒1个Interest安装到节点0。ndn::AppHelper producerHelper(ns3::ndn::Producer); producerHelper.SetAttribute(Prefix, StringValue(/example/hello)); producerHelper.Install(nodes.Get(1));创建Producer应用设置内容前缀为/example/hello安装到节点1。Producer收到Interest后如果名字能匹配上前缀就会生成对应的Data包返回。然后是FIB配置ndn::FibHelper::AddRoute(nodes.Get(1), /example/hello, 0, 0);给节点1添加一条FIB路由内容前缀/example/hello从接口0出去。这里不需要给节点0配FIB因为节点0是消费者只发Interest不收转发请求。但在多跳拓扑中每个中间路由节点都得有正确的FIB配置否则Interest到不了Producer。最后是仿真控制Simulator::Stop(Seconds(10.0)); Simulator::Run(); Simulator::Destroy();设置仿真时长为10秒运行仿真。运行结束后会看到Consumer的日志输出显示每次发送Interest和接收Data的结果。4.3 编译运行与结果观察确认代码没问题后在ns-3目录下执行命令./waf --runndn-simple运行结束后终端会打印ConsumerCbr的日志信息包括每次发出Interest的时间、收到的Data包名字、到达时间等。通过时间差你能直观看到一跳网络的往返延迟。我在第一次跑通这个例子后尝试把拓扑变成三个节点线性连接Consumer - Router - Producer。中间路由节点必须单独安装协议栈并配置FIB别的逻辑和双节点完全一样。改完再跑你会发现Interest经过路由器转到了ProducerData再原路返回整个过程依然顺畅。这个实验虽然简单但对于理解NDN的逐跳转发机制很有帮助。5. 常见问题与排查我踩过的几个大坑5.1 编译阶段的经典报错我身边不少同学第一次编译ndnSIM都在这里卡了很久原因基本是版本不匹配或依赖缺失。第一个高频问题是Boost版本过新或过旧。Boost的API和底层的编译选项在不同版本里有差异如果系统默认的Boost版本和ndnSIM不兼容会报出一堆模版实例化错误。这种情况建议不要硬编去Boost官网下载一个和ndnSIM文档匹配的版本或者用系统的包管理器降级。另一个常见报错是找不到libsqlite3或libssl这类依赖库多数是因为没装-dev包只装了运行库编译时缺少头文件。还有一类报错是pybindgen版本不对。pybindgen是NS-3自动生成Python绑定的工具如果版本和NS-3不匹配在configure阶段就会直接卡住。解决方式很简单clone的时候选择ndnSIM作者推荐的分支和版本不要选最新主分支。5.2 运行时流量不通Interest发出去了没有Data返回这个问题基本可以排在前三名。遇到这种情况我的排查顺序是先看FIB是否配置正确。用日志或print输出每个节点的FIB表确认Interest要请求的内容名前缀是否和FIB里的路由条目匹配。再看转发策略是否合理。默认的BestRoute策略要求FIB至少有一条有效路由如果FIB为空Interest直接进不了转发管道直接被丢弃。然后看应用前缀是否匹配。Producer设置的Prefix和Consumer请求的名字如果前缀不匹配Producer会直接忽略Interest。最后看节点类型。中间路由器节点不能安装Consumer或Producer应用否则会被当作端节点处理兴趣包可能被截断。举一个我自己的例子有一次我搭了一个5节点拓扑中间3个路由器都没有配置FIB结果消费者发出的Interest全部被丢弃。当时我还一直在怀疑是不是信道配置有问题后来打印出FIB表才恍然大悟。从那以后我每搭一个新拓扑第一件事就是打印FIB验证路由关系。5.3 数据观察方法用好Log和TracendnSIM的日志系统是个好东西但很多新手不知道。NS-3的Log组件可以直接打开NDN各模块的调试日志运行export NS_LOGndn.ConsumerCbrlevel_all ./waf --runndn-simple通过设置NS_LOG环境变量可以打开指定模块的日志输出。官方示例里经常出现ndn.ConsumerCbr和ndn.Producer的日志如果你需要观察转发管道内部的细节还可以打开ndn.Forwarder的日志。日志的输出量可能会很大建议先在小拓扑上用否则几百个节点的日志会把磁盘撑爆。Trace则是更精细的数据采集方式。ndnSIM把每个关键事件包到达时间、缓存命中、转发决策都暴露为Trace源你可以自己在代码里注册回调函数把数据写到文件里。这样做出来的仿真数据可以直接用Python处理画图也方便。我第一次做实验用的是官方提供的ndn-trace工具通过配置TraceHelper自动把数据采集到SQLite数据库后面分析起来比手动解析日志省事得多。5.4 提升仿真效率的几个心得跑规模较大的仿真场景时注意不要把所有节点的日志都开着只打开你关心的端口模块否则模拟器会花大量时间在日志输出上。CS缓存的大小要合理设置。默认的CS容量可能偏小或偏大如果模拟场景是验证缓存策略的性能CS容量就是你实验中的一个关键参数不能直接用默认值。还要注意避免把仿真时间设得太长先跑一个短时间段的实验观察数据趋势确认符合预期以后再拉长时间段这样可以节省很多迭代调参的时间。结尾这篇是第一篇笔记我主要是把ndnSIM的环境搭建、基础原理和第一个例子串起来。对我个人来说最大的体会是ndnSIM虽然上手有点门槛但只要你理解了两件事——NDN的核心协议流程Interest驱动、Data返回、逐跳转发和NS-3的Helper工作机制创建节点、安装协议栈、配置应用、设置FIB剩下的就是不断实践和查文档了。后面我会继续写策略定制和缓存替换算法的实验如果你也在研究NDN遇到了具体的报错或者思路卡壳欢迎一起交流踩坑经验。