Ubuntu 20.04下SDN环境搭建：Mininet与RYU控制器实战指南

1. 从零开始的SDN环境搭建：为什么选择Ubuntu 20.04？

如果你对网络技术，特别是软件定义网络（SDN）感兴趣，想亲手搭建一个实验环境来验证控制器、交换机和应用之间的交互，那么这篇文章就是为你准备的。我最近在Ubuntu 20.04 LTS上完整地走了一遍SDN环境的搭建流程，从系统准备到控制器与模拟网络成功通信，整个过程踩了不少坑，也积累了一些心得。Ubuntu 20.04作为一个长期支持版本，其软件生态稳定，社区支持完善，是进行这类开发实验的理想平台。很多人可能会问，为什么不直接用最新的Ubuntu 22.04或者24.04？原因很简单，SDN领域的一些经典工具和框架，其官方文档和社区教程大多基于20.04进行验证，依赖库的版本兼容性最好，可以帮你避开大量因系统版本过新导致的依赖冲突问题。这次搭建的核心是Mininet网络模拟器和RYU控制器，它们构成了SDN学习和研究的黄金搭档。接下来，我会带你一步步完成这个环境的搭建，并分享那些官方文档里不会写的细节和避坑指南。

2. 基础系统环境准备与关键依赖安装

在开始安装Mininet和RYU之前，一个干净、配置正确的Ubuntu 20.04基础环境至关重要。很多人直接跳过这一步，导致后续安装各种报错。我的建议是，如果你使用虚拟机，分配至少2核CPU、4GB内存和20GB磁盘空间；如果是物理机或云主机，确保网络通畅。首先，更新系统软件包列表并升级现有软件，这是保证所有安装工具能从官方源获取最新稳定版的前提。

sudo apt update sudo apt upgrade -y

完成系统更新后，需要安装一系列编译工具和Python开发环境。Mininet的部分组件需要从源码编译，而RYU控制器是纯Python应用，但其依赖可能涉及本地扩展。因此，以下工具链必不可少：

sudo apt install -y build-essential git python3-dev python3-pip python3-setuptools python3-wheel

这里有一个关键点：务必使用python3和pip3。Ubuntu 20.04默认的python命令可能指向Python 2，而SDN生态的工具早已转向Python 3。安装python3-dev包是为了获取Python头文件和静态库，用于编译某些Python包的C扩展，这一步经常被忽略，导致后续安装ryu或mininet的扩展时出现“Python.h not found”的错误。

接下来，我们需要安装网络相关的工具和库，用于支持OpenFlow协议以及网络命名空间的操作。

sudo apt install -y net-tools iproute2 wireshark tcpdump openvswitch-switch openvswitch-common

安装openvswitch-switch是关键，因为Mininet默认使用Open vSwitch作为其虚拟交换机的后端，以实现对OpenFlow协议的支持。安装过程中，如果提示配置Wireshark为非root用户抓包，可以选择“是”，这方便后续用Wireshark直接分析OpenFlow报文。

3. Mininet的安装、验证与核心原理剖析

Mininet是搭建SDN实验环境的基石，它能在单台机器上快速创建一个包含主机、交换机、控制器的虚拟网络。安装Mininet有多种方式，包括从源码安装、使用安装包或通过Pythonpip安装。为了获得最完整的功能和对最新特性的支持，我推荐从GitHub源码安装。

3.1 从源码安装Mininet

首先，克隆Mininet的官方仓库。我建议克隆到用户主目录下，方便管理。

cd ~ git clone https://github.com/mininet/mininet.git

克隆完成后，进入mininet目录。官方提供了一个非常方便的安装脚本util/install.sh。这个脚本功能强大，可以通过参数选择安装模式。对于大多数SDN实验，我们只需要安装Mininet核心、OpenFlow参考交换机、控制器以及Open vSwitch支持。使用-a参数代表“全部安装”，但这里我更推荐使用-nfv参数组合，它表示安装Mininet核心、OpenFlow 1.3支持以及Open vSwitch 2.13.0。指定OVS版本可以避免因版本自动更新带来的潜在不兼容。

cd mininet sudo util/install.sh -nfv

这个安装过程会持续一段时间，因为它需要从网络下载并编译多个组件。期间可能会提示你输入用户密码，或者询问是否自动安装依赖，通常选择“是”即可。安装脚本结束后，Mininet及其主要组件就应该安装好了。

3.2 验证Mininet安装与基本操作

安装完成后，必须进行验证。最直接的测试是运行一个最小的网络拓扑。

sudo mn --test pingall

这条命令会创建一个最简单的网络：一个OpenFlow交换机连接两台主机，然后自动让这两台主机互相ping。如果看到*** Results: 0% dropped (0/2 lost)这样的输出，恭喜你，Mininet的核心功能运行正常。

理解这个测试背后的网络结构很重要。当你执行sudo mn时，Mininet默认创建了以下虚拟实体：

1. 一个OpenFlow交换机（s1），默认支持OpenFlow 1.0。
2. 两台主机（h1和h2），分别连接到交换机。
3. 一个简单的内置控制器（c0），它运行在6633端口，其行为是让交换机像普通Hub一样泛洪所有数据包。

pingall测试能成功，正是因为控制器c0的存在。交换机收到主机h1发出的ARP请求（询问h2的MAC地址）时，由于流表为空，它会将这个“Packet-In”消息上报给控制器。内置控制器c0的策略是，对于未知目的地的数据包，向除入端口外的所有端口泛洪。因此，h2收到了ARP请求并回复，双方学习到MAC地址后，ICMP ping包得以顺利交换。这个过程完美诠释了SDN中控制平面与数据平面分离的基本交互。

你可以进入Mininet命令行进行更多探索：

sudo mn

在Mininet提示符mininet>下，你可以像操作真实网络设备一样操作：

• nodes: 查看所有节点（主机、交换机、控制器）。
• net: 查看网络链路信息。
• h1 ifconfig: 查看主机h1的网络接口配置。
• pingall: 再次进行全网连通性测试。
• h1 ping -c 3 h2: 让h1向h2发送3个ping包。
• exit: 退出Mininet并清理网络环境。

注意：Mininet需要sudo权限来创建网络命名空间、虚拟以太网对（veth pair）等内核级网络对象。请确保你使用的用户具有sudo权限。清理网络时，如果异常退出导致残留，可以运行sudo mn -c进行彻底清理。

3.3 Mininet的高级拓扑与自定义

除了默认的最小拓扑，Mininet支持通过Python API定义复杂的自定义网络。这是其强大之处。例如，创建一个简单的线性拓扑（3个交换机，每个交换机下挂1台主机）：

#!/usr/bin/env python3 from mininet.net import Mininet from mininet.node import OVSSwitch, RemoteController from mininet.cli import CLI from mininet.log import setLogLevel def create_linear_topology(): setLogLevel('info') # 设置日志级别为info，看到更多信息 net = Mininet(switch=OVSSwitch, controller=None) # 先不指定控制器 # 添加一个远程控制器（假设RYU运行在本机6633端口） c0 = net.addController('c0', controller=RemoteController, ip='127.0.0.1', port=6633) # 创建3个交换机 s1 = net.addSwitch('s1') s2 = net.addSwitch('s2') s3 = net.addSwitch('s3') # 创建3台主机，并指定IP地址段 h1 = net.addHost('h1', ip='10.0.1.1/24') h2 = net.addHost('h2', ip='10.0.2.1/24') h3 = net.addHost('h3', ip='10.0.3.1/24') # 创建链路：主机-交换机，交换机-交换机 net.addLink(h1, s1) net.addLink(h2, s2) net.addLink(h3, s3) net.addLink(s1, s2) net.addLink(s2, s3) # 启动网络 net.start() # 启动Mininet交互命令行 CLI(net) # 退出CLI后停止网络 net.stop() if __name__ == '__main__': create_linear_topology()

将上述代码保存为linear_topo.py，并赋予执行权限chmod +x linear_topo.py。在启动这个脚本之前，你需要先运行RYU控制器（下一节会讲）。这个例子展示了如何与外部控制器（如RYU）连接，以及如何构建更复杂的网络结构。

4. RYU控制器的安装、运行与第一个应用

RYU是一个基于Python的SDN控制器框架，它提供了丰富的组件库来开发网络控制应用。与Mininet内置的简单控制器不同，RYU允许你编写复杂的控制逻辑。

4.1 安装RYU控制器

RYU可以通过Python的pip工具直接安装。由于我们之前已经安装了pip3，安装过程非常简单。我强烈建议使用虚拟环境（如venv）来管理RYU的依赖，避免与系统Python环境冲突。

cd ~ python3 -m venv ryu-env # 创建名为ryu-env的虚拟环境 source ryu-env/bin/activate # 激活虚拟环境

激活虚拟环境后，命令行提示符前通常会显示(ryu-env)。在这个环境下安装的包是独立的。

pip install ryu

安装过程会自动拉取所有依赖，包括eventlet,msgpack-python,oslo.config,routes,webob等。安装完成后，你可以通过ryu-manager --version来验证。

4.2 运行RYU与最简单的交换机应用

RYU通过ryu-manager命令启动，并加载特定的应用（App）。让我们从最简单的开始：一个让交换机像传统二层学习交换机一样工作的应用。

首先，确保你的Mininet网络已经关闭（如果之前有运行，用sudo mn -c清理）。然后，在一个终端窗口，启动RYU并加载simple_switch应用，这个应用实现了基本的MAC地址学习和转发。

source ~/ryu-env/bin/activate # 如果虚拟环境未激活 ryu-manager ryu.app.simple_switch

你会看到一系列日志输出，最后类似connected socket:<eventlet.greenio.base.GreenSocket object at 0x7f8b4c0b4d90> address:('127.0.0.1', 6633)的信息，表明RYU控制器正在监听6633端口，等待交换机连接。

接下来，在另一个终端窗口，启动Mininet并指定远程控制器为我们刚启动的RYU。

sudo mn --controller=remote,ip=127.0.0.1,port=6633 --topo=linear,3 --mac

参数解释：

• --controller=remote,ip=127.0.0.1,port=6633: 告诉Mininet使用远程控制器，地址和端口对应RYU。
• --topo=linear,3: 创建一个包含3个交换机的线性拓扑。
• --mac: 自动设置简单易读的MAC地址（如00:00:00:00:00:01），方便调试。

在Mininet命令行中，运行pingall。你会观察到第一次ping时稍有延迟，这是因为交换机流表为空，需要经过控制器决策并下发流表项。之后再次ping，速度会变快，因为数据包直接匹配流表转发（“快速路径”）。在RYU的终端，你可以看到详细的Packet-In/Flow-Mod等OpenFlow消息日志，这是理解控制器与交换机交互的绝佳窗口。

4.3 理解RYU应用的工作流程

以simple_switch为例，理解其代码逻辑能帮你未来编写自己的应用。其核心是处理PacketIn事件：

1. 事件触发：交换机收到一个数据包，若流表中无匹配项，则将其封装为PacketIn消息发送给控制器。
2. 提取信息：RYU应用从事件中解析出源MAC地址、入端口、数据包等。
3. 学习：将源MAC地址 - 入端口的映射关系记录到应用的MAC地址表中。
4. 查找与行动：根据数据包目的MAC地址查询MAC表。
   • 如果找到出口端口，且该端口不是入端口，则下发一条FlowMod消息，指导交换机将此类数据包（匹配源/目的MAC等）直接从该端口转发。同时，通过PacketOut消息将当前被“挂起”的数据包从该端口发出。
   • 如果未找到（广播或未知单播），则下发PacketOut消息让交换机从除入端口外的所有端口泛洪（Flood）。
5. 流表下发：交换机收到FlowMod后，在本地流表中安装相应的规则。后续相同的流量将直接匹配这条规则转发，不再上报控制器。

这个过程就是经典的“首包上送控制器，后续流表转发”的SDN工作模式。通过ryu.app.simple_switch的源码，你可以清晰地看到这些步骤对应的Python方法。

5. 集成测试：用RYU实现网络流量监控

为了将Mininet和RYU的应用更深入一步，我们来实现一个简单的流量监控应用。这个应用不仅完成二层交换，还会统计每个交换机上每个端口的流量，并定期打印出来。这涉及到RYU的另一个重要组件：Stats请求。

创建一个名为monitor_switch.py的文件：

#!/usr/bin/env python3 from ryu.base import app_manager from ryu.controller import ofp_event from ryu.controller.handler import CONFIG_DISPATCHER, MAIN_DISPATCHER, set_ev_cls from ryu.ofproto import ofproto_v1_3 # 使用OpenFlow 1.3 from ryu.lib.packet import packet, ethernet import time class MonitorSwitch(app_manager.RyuApp): OFP_VERSIONS = [ofproto_v1_3.OFP_VERSION] # 指定支持的OpenFlow版本 def __init__(self, *args, **kwargs): super(MonitorSwitch, self).__init__(*args, **kwargs) self.mac_to_port = {} # MAC地址表 self.port_stats = {} # 端口统计信息字典，结构：{dpid: {port_no: {'tx_bytes':0, 'rx_bytes':0}}} @set_ev_cls(ofp_event.EventOFPSwitchFeatures, CONFIG_DISPATCHER) def switch_features_handler(self, ev): """交换机连接时，下发默认的Table-miss流表项（将未知流量上送控制器）""" datapath = ev.msg.datapath ofproto = datapath.ofproto parser = datapath.ofproto_parser # 添加一条优先级为0的Table-miss流表项 match = parser.OFPMatch() actions = [parser.OFPActionOutput(ofproto.OFPP_CONTROLLER, ofproto.OFPCML_NO_BUFFER)] self.add_flow(datapath, 0, match, actions) def add_flow(self, datapath, priority, match, actions): """下发流表项的辅助函数""" ofproto = datapath.ofproto parser = datapath.ofproto_parser inst = [parser.OFPInstructionActions(ofproto.OFPIT_APPLY_ACTIONS, actions)] mod = parser.OFPFlowMod(datapath=datapath, priority=priority, match=match, instructions=inst) datapath.send_msg(mod) @set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER) def packet_in_handler(self, ev): """处理Packet-In消息，实现学习与转发""" msg = ev.msg datapath = msg.datapath ofproto = datapath.ofproto parser = datapath.ofproto_parser in_port = msg.match['in_port'] pkt = packet.Packet(msg.data) eth = pkt.get_protocol(ethernet.ethernet) if eth is None: return dst = eth.dst src = eth.src dpid = datapath.id self.mac_to_port.setdefault(dpid, {}) self.mac_to_port[dpid][src] = in_port # 学习源MAC out_port = self.mac_to_port[dpid].get(dst) if out_port is not None: # 已知目的MAC，直接转发 actions = [parser.OFPActionOutput(out_port)] else: # 未知目的MAC，泛洪 actions = [parser.OFPActionOutput(ofproto.OFPP_FLOOD)] # 下发流表项，避免后续相同流量再次触发Packet-In if out_port is not None: match = parser.OFPMatch(in_port=in_port, eth_dst=dst, eth_src=src) self.add_flow(datapath, 1, match, actions) # 将当前数据包发送出去 out = parser.OFPPacketOut(datapath=datapath, buffer_id=msg.buffer_id, in_port=in_port, actions=actions, data=msg.data if msg.buffer_id == ofproto.OFP_NO_BUFFER else None) datapath.send_msg(out) @set_ev_cls(ofp_event.EventOFPPortStatsReply, MAIN_DISPATCHER) def port_stats_reply_handler(self, ev): """处理端口统计信息的回复""" body = ev.msg.body dpid = ev.msg.datapath.id self.logger.info('Switch %016x Port Stats:', dpid) # 初始化该交换机的统计字典 if dpid not in self.port_stats: self.port_stats[dpid] = {} for stat in body: port_no = stat.port_no if port_no not in self.port_stats[dpid]: self.port_stats[dpid][port_no] = {'tx_bytes':0, 'rx_bytes':0} # 计算本次间隔内的增量（简单处理，实际应考虑计数器溢出） delta_tx = stat.tx_bytes - self.port_stats[dpid][port_no]['tx_bytes'] delta_rx = stat.rx_bytes - self.port_stats[dpid][port_no]['rx_bytes'] self.port_stats[dpid][port_no]['tx_bytes'] = stat.tx_bytes self.port_stats[dpid][port_no]['rx_bytes'] = stat.rx_bytes if delta_tx > 0 or delta_rx > 0: self.logger.info('Port %2d: TX %d bytes, RX %d bytes (since last query)', port_no, delta_tx, delta_rx) def _request_stats(self, datapath): """向交换机发送端口统计请求""" ofproto = datapath.ofproto parser = datapath.ofproto_parser req = parser.OFPPortStatsRequest(datapath, 0, ofproto.OFPP_ANY) datapath.send_msg(req) @set_ev_cls(ofp_event.EventOFPStateChange, [MAIN_DISPATCHER]) def state_change_handler(self, ev): """交换机状态改变（如连接建立）时触发，开始定期请求统计信息""" datapath = ev.datapath if ev.state == MAIN_DISPATCHER: # 启动一个定时器，每5秒请求一次统计信息 self._request_stats(datapath) from ryu.lib import hub hub.spawn(self._monitor, datapath) def _monitor(self, datapath): """定时请求统计信息的循环""" while True: hub.sleep(5) # 每5秒请求一次 self._request_stats(datapath)

这个应用在simple_switch的基础上增加了端口流量统计功能。关键点在于：

1. _monitor协程每5秒通过_request_stats函数向交换机发送一个OFPPortStatsRequest消息。
2. 交换机回复OFPPortStatsReply消息，由port_stats_reply_handler处理。
3. 处理函数计算并打印出自上次查询以来每个端口发送（TX）和接收（RX）的字节数增量。

测试步骤：

1. 在一个终端启动监控应用：ryu-manager monitor_switch.py
2. 在另一个终端启动Mininet：sudo mn --controller=remote,ip=127.0.0.1,port=6633 --topo=linear,3 --mac
3. 在Mininet中执行一些网络流量，例如：h1 ping -c 100 h3（持续ping）或者h1 iperf -s &和h3 iperf -c h1（进行带宽测试）。
4. 观察RYU控制器的终端输出，你会看到类似Switch 0000000000000001 Port Stats:和具体端口流量变化的日志。

这个实验将SDN的集中控制能力与网络监控结合了起来，展示了如何通过控制器主动获取全网数据平面的状态，这是实现网络自动化运维和流量工程的基础。

6. 常见问题排查与性能调优心得

在搭建和实验过程中，你几乎一定会遇到一些问题。下面是我总结的几个典型问题及其解决方案。

6.1 Mininet启动失败或网络异常

问题现象：执行sudo mn后报错，例如Unable to contact the remote controller at 127.0.0.1:6633，或者pingall失败。

• 检查控制器：首先确认RYU控制器是否正在运行，并且监听在正确的端口（默认6633）。可以使用netstat -tlnp | grep 6633查看。
• 检查Open vSwitch：Mininet依赖OVS。运行sudo systemctl status openvswitch-switch确保OVS服务是活跃的。如果不是，尝试sudo systemctl start openvswitch-switch。
• 清理残留：之前的Mininet会话可能没有正确清理，导致端口或进程冲突。始终在启动新会话前运行sudo mn -c。
• 权限问题：确保使用sudo执行Mininet命令。某些系统配置可能需要调整/etc/sudoers文件或使用sudo -E保留环境变量。

6.2 RYU应用导入错误或依赖缺失

问题现象：运行ryu-manager时出现ImportError，例如找不到ryu.lib.packet或某些第三方库。

• 虚拟环境：最可能的原因是没有在正确的Python环境中运行。确保你已经激活了安装RYU的虚拟环境（source ryu-env/bin/activate）。
• 重新安装：在虚拟环境中，尝试使用pip install --upgrade ryu重新安装。有时网络问题会导致依赖安装不完整。
• 手动安装依赖：根据错误信息，手动安装缺失的包，例如pip install eventlet msgpack-python。

6.3 OpenFlow版本不匹配

问题现象：Mininet交换机无法连接到RYU控制器，或者连接后流表下发失败，RYU日志显示版本协商错误。

• 统一版本：Mininet默认创建的交换机可能使用OpenFlow 1.0，而你的RYU应用可能声明支持1.3。在启动Mininet时，可以显式指定交换机类型和协议版本：sudo mn --controller=remote --switch ovsk,protocols=OpenFlow13。在RYU应用中，确保OFP_VERSIONS列表包含了对应的版本（如ofproto_v1_3）。
• 查看协商：在RYU启动时增加--verbose参数，可以查看更详细的协议握手信息。

6.4 性能调优与实验建议

当你的拓扑变得复杂（例如几十台主机和交换机）时，可能会遇到性能瓶颈。

• 调整交换机型：Mininet支持多种交换机类型。ovsk（基于Open vSwitch的用户态实现）功能最全但性能较低；ovs（内核态OVS）性能更好；lxbr（Linux Bridge）性能最佳但不支持OpenFlow。根据实验需求选择，对于大型拓扑的性能测试，可以考虑使用--switch lxbr，但这样就需要使用Linux Bridge的流表工具（如tc）或配合其他控制器。
• 限制CPU和带宽：Mininet支持为虚拟链路设置带宽、延迟和丢包率。例如：sudo mn --link tc,bw=10,delay='5ms',loss=1。这在进行网络性能实验时非常有用。
• 使用--nat参数：如果你的实验需要虚拟网络访问外部互联网（例如从Mininet主机apt install软件），可以在启动Mininet时添加--nat参数，它会自动设置网络地址转换。
• 善用Mininet Python API：对于复杂的、需要重复执行的实验，不要总在命令行手动操作。将拓扑创建、测试命令（如pingall,iperf）写入Python脚本，实现自动化测试。这能极大提升实验效率，也便于结果复现。

搭建SDN环境本身就是一个很好的学习过程，你会接触到Linux网络命名空间、虚拟以太网对、Open vSwitch、OpenFlow协议等多个层面的知识。遇到问题时，多看Mininet和RYU的日志输出，它们通常包含了非常明确的错误线索。从最简单的pingall开始，逐步增加复杂度，编写自己的控制器应用，你会对SDN的工作原理有越来越深刻的理解。这个基于Ubuntu 20.04、Mininet和RYU的环境，足够你完成从入门到进阶的大部分SDN实验和原型开发。