kathara/sdn

Docker镜像文档：OpenVSwitch与Ryu SDN控制器集成镜像

镜像概述

本Docker镜像基于基础镜像扩展构建，集成了OpenVSwitch（虚拟交换机）和Ryu SDN控制器，旨在提供一个开箱即用的软件定义网络（SDN）开发、测试和部署环境。通过预安装关键组件，简化了SDN相关应用的搭建流程，适用于快速构建基于OpenFlow协议的网络拓扑。

核心功能与特性

OpenVSwitch组件

• 提供多层虚拟交换能力，支持L2/L3网络功能
• 支持OpenFlow协议，可与SDN控制器联动
• 内置VLAN、VXLAN、GRE等网络隔离与隧道技术
• 支持流量监控与镜像功能，便于网络调试

Ryu SDN控制器

• 完全开源的SDN控制器，遵循OpenFlow 1.0/1.2/1.3等协议标准
• 提供REST API接口，支持通过HTTP/JSON管理网络
• 模块化架构，支持自定义应用开发
• 内置多种网络应用示例（如简单交换机、负载均衡器）

基础镜像扩展优势

• 无需手动安装和配置OpenVSwitch与Ryu依赖
• 组件版本预验证，确保兼容性
• 精简镜像体积，优化运行效率

使用场景与适用范围

• SDN教学与研究：适合高校、研究机构开展SDN原理教学和实验
• 网络功能虚拟化（NFV）测试：验证虚拟网络环境中的服务链部署
• 软件定义网络原型开发：快速构建SDN应用原型并验证功能
• OpenFlow协议实验：测试OpenFlow交换机与控制器的通信机制
• 网络自动化与编排：作为SDN控制平面组件，与编排系统集成

使用方法与配置说明

获取镜像

bash
# 假设镜像名称为sdn-base:latest（实际名称需根据镜像仓库调整）
docker pull docker.xuanyuan.run/[镜像仓库地址]/sdn-base:latest

基本运行命令

bash
# 启动镜像并进入交互式终端
docker run -it --privileged --name sdn-env docker.xuanyuan.run/[镜像仓库地址]/sdn-base:latest /bin/bash

注意：使用--privileged选项以确保OpenVSwitch能够正常创建网络设备

启动组件服务

启动OpenVSwitch服务

bash
# 在容器内执行
service openvswitch-switch start

启动Ryu控制器

bash
# 启动基础交换机应用（simple_switch）
ryu-manager ryu.app.simple_switch

# 或启动带REST API的控制器
ryu-manager ryu.app.simple_switch ryu.app.ofctl_rest

典型配置示例：创建基础SDN拓扑

1. 创建OpenVSwitch网桥

bash
ovs-vsctl add-br br0  # 创建名为br0的网桥
ovs-vsctl set-controller br0 tcp:127.0.0.1:6633  # 将网桥连接到本地Ryu控制器（默认端口6633）
ovs-vsctl show  # 验证网桥配置

2. 添加虚拟端口

bash
# 创建两个虚拟接口并连接到网桥
ip link add veth0 type veth peer name veth1
ip link set veth0 up
ip link set veth1 up
ovs-vsctl add-port br0 veth0

3. 验证控制器连接

bash
# 在Ryu控制器日志中查看连接状态，或通过REST API查询
curl http://127.0.0.1:8080/stats/switches  # 若启用ofctl_rest，返回连接的交换机DPID

环境变量说明

自定义配置

可通过挂载配置文件或 volumes 实现自定义：

bash
# 挂载自定义Ryu应用到容器
docker run -it --privileged -v /local/ryu/apps:/opt/ryu/apps docker.xuanyuan.run/[镜像仓库地址]/sdn-base:latest \
  ryu-manager /opt/ryu/apps/custom_app.py

注意事项

• 容器需运行在支持网络虚拟化的环境中（如KVM、Docker Desktop）
• 生产环境中建议配合网络策略和资源限制使用
• 复杂拓扑需结合Docker网络模式（如host模式、macvlan）配置网络连接