第4章 RYU控制器实战

第四章：RYU控制器实战

好，咱们进入实战环节了。前面几章讲了那么多SDN的理论，说实话，光说不练假把式。这一章我带你亲手操作RYU控制器，从架构解析到应用开发，再到REST API调用，最后跟Mininet联动起来。嗯，这一套走下来，你就能真正理解SDN控制器是怎么工作的了。

4.1 RYU架构深度解析

RYU这个控制器，我用了好几年了。它最大的特点就是——纯Python实现，代码干净，容易上手。你想想看，一个用Python写的SDN控制器，调试起来多方便？

RYU的核心架构其实不复杂，我画个图给你描述一下：

应用层：你写的各种网络应用，比如防火墙、负载均衡、流量监控
核心层：事件处理、消息分发、组件管理
协议层：OpenFlow、Netconf、OF-Config等协议支持
底层：与交换机的Socket通信

我个人习惯把RYU看作一个事件驱动的框架。什么意思呢？就是交换机发来一个Packet-In消息，RYU就触发一个事件，你的应用代码去处理这个事件。说白了，就是"来了活就干"的模式。

核心组件一览：

组件名	功能	我常用的场景
ofp_handler	处理OpenFlow消息	所有OpenFlow相关操作
app_manager	管理RYU应用	加载/卸载应用
ofp_event	事件定义	自定义事件处理
hub	协程支持	异步任务处理

我在项目中遇到过一个问题：RYU启动后，应用加载顺序搞错了，导致流表下发失败。后来才发现，app_manager的加载顺序是有讲究的，核心组件必须先加载。

4.2 RYU应用开发入门

好，咱们直接写一个最简单的RYU应用。这个应用的功能很简单——让交换机像普通交换机一样工作（也就是洪泛转发）。

from ryu.base import app_manager
from ryu.controller import ofp_event
from ryu.controller.handler import MAIN_DISPATCHER
from ryu.controller.handler import set_ev_cls
from ryu.ofproto import ofproto_v1_3

class SimpleSwitch13(app_manager.RyuApp):
    OFP_VERSIONS = [ofproto_v1_3.OFP_VERSION]

    def __init__(self, *args, **kwargs):
        super(SimpleSwitch13, self).__init__(*args, **kwargs)
        self.mac_to_port = {}

    @set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
    def packet_in_handler(self, ev):
        msg = ev.msg
        datapath = msg.datapath
        ofproto = datapath.ofproto
        parser = datapath.ofproto_parser

        # 获取入端口和数据包信息
        in_port = msg.match['in_port']
        dpid = datapath.id
        # ... 省略具体转发逻辑

这段代码看着简单，但有几个坑我得提醒你：

避坑指南：

OFP_VERSIONS必须声明，否则RYU不知道你用哪个OpenFlow版本
@set_ev_cls装饰器里的MAIN_DISPATCHER表示交换机连接建立后才能处理事件
datapath对象代表一个交换机，每个交换机有唯一的dpid

我曾经犯过一个低级错误——忘记在__init__里调用父类的构造函数，结果应用启动就报错。嗯，这种细节一定要注意。

4.3 REST API接口调用

RYU自带了一组REST API，这功能太实用了。你想想看，不用写代码，直接发HTTP请求就能控制网络，多方便？

启动REST API的方式很简单：

ryu-manager ryu.app.rest_router ryu.app.ofctl_rest

常用的REST API接口：

接口路径	方法	功能
/stats/switchinfo	GET	获取交换机信息
/stats/flow/<dpid>	GET	获取流表
/stats/flowentry/add	POST	添加流表项
/stats/flowentry/delete	DELETE	删除流表项

举个例子，添加一条流表：

curl -X POST http://localhost:8080/stats/flowentry/add \
  -d '{
    "dpid": 1,
    "priority": 100,
    "match": {"in_port": 1},
    "actions": [{"type": "OUTPUT", "port": 2}]
  }'

小技巧：我调试REST API时，习惯先用Postman测试，确认没问题再写到代码里。这样能快速定位是API问题还是代码问题。

4.4 RYU与Mininet联动

终于到了最激动人心的环节了。RYU加上Mininet，就像孙悟空有了金箍棒——威力倍增。

先启动RYU控制器：

ryu-manager simple_switch.py

再启动Mininet，连接到RYU：

sudo mn --controller=remote,ip=127.0.0.1,port=6633 --switch=ovsk,protocols=OpenFlow13

这里有几个关键参数：

--controller=remote：使用远程控制器
ip=127.0.0.1：控制器IP地址
port=6633：OpenFlow默认端口
protocols=OpenFlow13：指定OpenFlow 1.3版本

启动后，你会看到RYU那边打印出交换机连接的消息。这时候，你可以在Mininet里测试网络连通性：

mininet> h1 ping h2

如果一切正常，h1和h2应该能ping通。为什么？因为我们的simple_switch应用在处理Packet-In消息时，会学习MAC地址并下发流表。

实战经验：

我在一次演示中，怎么都ping不通。查了半天，发现是Mininet和RYU的OpenFlow版本不匹配。Mininet默认用OpenFlow 1.0，而我的RYU应用只支持1.3。所以，版本一致性是首先要检查的。

还有一个常见问题——防火墙。RYU默认监听6633端口，如果你的系统防火墙开着，Mininet就连不上。我曾经被这个问题坑了整整一个下午。

好了，这一章的内容就到这里。你跟着我走了一遍RYU的实战流程，从架构到开发，从API到联动。说实话，这些内容我当年学的时候花了整整一周，你现在一篇文章就能看完，效率高多了。

📚 课程目录

第四章：RYU控制器实战

4.1 RYU架构深度解析

4.2 RYU应用开发入门

4.3 REST API接口调用

4.4 RYU与Mininet联动