基于SDN的园区网络检测系统：若依工程部署与二次开发

简介：基于SDN的园区网络检测系统是一套前后端分离的完整项目源码，面向网络工程、计算机及相关专业学生、老师与研发人员，尤其适合作为毕业设计、课程设计或SDN方向入门进阶的参考实现。项目以Java为后端主体，包含264个Java文件，覆盖控制器交互、网络状态采集与检测逻辑；前端采用Vue框架，含95个Vue页面/组件与78个JavaScript脚本，用于园区拓扑可视化与检测结果展示；另有XML配置、SQL脚本、环境变量与打包脚本等，整体共621个文件，压缩包仅1.96MB，轻量但结构完整。随包附有开发环境使用手册与README说明，并提供多个bat批处理脚本，可一键完成打包、运行或清理，帮助使用者快速在本地启动系统并二次开发。目前已有154人学习下载，适合需要一套可运行SDN检测项目作为参照或改造的用户。

1. 基于 SDN 的园区网络检测系统：一份能直接跑的若依工程和它的完整打开方式

做园区网络运维的人，怕的不是设备多，而是流量出了异常找不到源头。基于 SDN 的园区网络检测系统，就是把这个源头找出来：控制器采集整网流表，上层逻辑做统计和异常判断，再用若依后台把结果展示出来。这份资源是典型的毕设/课设项目源码加文档说明——后端是 Spring Boot，前端是 Vue，外面包好 ry.bat、run.bat、package.bat 等启动脚本，另附《若依环境使用手册.docx》。适合正在做园区网络规划与设计的在校生，也适合手里有 SDN 控制器、不想从零写管理后台的开发者。

2. 拆解这份若依工程：bat 脚本、环境变量与使用手册各管哪一段

拿到压缩包，先别急着一键启动。这套工程的制造痕迹很明显：若依前后端分离的骨架，加了一个 SDN 检测模块，再用批处理把日常操作收口。文件不多，但混在一起新手容易看懵。我建议按三类拆：第一类是 Windows 批处理，负责构建和启动；第二类是环境配置文件，管前端运行参数和编辑器规范；第三类是 Word 手册，部署顺序以它为准。

2.1 工程文件逐项拆解：从文件名反推脚本职能

先给一份文件清单，方便你对照手里的压缩包。

这张表是按命名习惯推测的，不是每个脚本都能隔着屏幕确认。你到手后先右键用记事本打开任意一个 bat，看头两行：

@echo off cd /d %~dp0

@echo off表示不打印命令本身，cd /d %~dp0是让脚本进入自身所在目录。若依这类项目对当前工作目录敏感，没有这一行，mvn 或 npm 很容易找不到项目根目录。所以看到脚本里带这两个写法，基本可以确认是给项目根目录设计的。

这里先提一个边界：不要指望 clean.bat 能把整个系统一键装好。它通常只删 target、dist 这些编译产物，不能代替环境安装。环境不对时，构建失败和脚本本身没关系，先检查 JDK、Maven、Node，再回来怪脚本。

2.2 .env.development 与 .editorconfig：前端环境参数和换行规范

这两个文件不在 bat 脚本里，但它们决定了前端能不能找到后端。

.env.development是 Vue CLI 开发模式下的环境变量文件。若依项目里最常见的配置是VUE_APP_BASE_API，它会被设置到 axios 请求的 baseURL 上。我拿到资源后的习惯是打开它看三点：VUE_APP_BASE_API、VUE_APP_APP_NAME、有没有被注释掉的代理目标。

VUE_APP_BASE_API=/dev-api VUE_APP_APP_NAME=SDN园区网络检测系统

VUE_APP_BASE_API等于/dev-api时，vue.config.js 里必须有一组对应的 devServer.proxy 配置，把/dev-api转发到后端端口。如果这个值是完整的 URL，比如http://localhost:8080，前端请求就会直接跨域，需要后端额外放开 CORS。开发阶段我更推荐代理方式，部署阶段再换 Nginx。

.editorconfig是给编辑器用的规则文件，管的是缩进、编码和换行。

root = true [*] charset = utf-8 indent_style = space indent_size = 2 end_of_line = lf

这里有个很多人忽略的坑：end_of_line = lf是给 js、java 源码用的，保证不同系统提交代码时不要混成 CRLF。但它管不了 Windows 的批处理。bat 最好保持 CRLF 换行，如果你用 VSCode 把 run.bat 顺手转成了 LF，某些带标签和goto的脚本可能执行错乱。脚本行为诡异时，先怀疑换行符。

2.3 若依环境使用手册.docx：先搜这三个关键词

文档说明比代码更能省时间。这份资源里专门放了一本《若依环境使用手册.docx》，不是摆设。我会在打开后先用阅读模式搜三个词：环境要求、数据库、启动顺序。

文档里通常会把 JDK、Maven、MySQL、Redis 的版本写清楚，也会告诉你数据库脚本在哪个目录、应该怎么导入、默认账号密码是什么。这些信息如果靠读代码去猜，至少多花半天。

如果文档里出现了若依版本信息，按它的 Spring Boot 版本来配 JDK。常见的若依前后端分离版是 Spring Boot 2.x + Vue2，对应 JDK 1.8；硬要用 JDK 17，大概率会遇到 Lombok 和 CGLIB 的兼容问题。你手里的手册就是这套工程的“第一手资料”，比网上任何通用教程都准。

3. 把系统跑起来：从环境准备到后端启动的完整操作顺序

运行一套前后端分离的项目，不是敲一条命令的事，而是一条链：JDK -> Maven -> MySQL -> Redis -> 后端 jar -> 前端 Node。任何一个环节不对，后面都会报出很难看的错。下面按我实际操作的顺序给你过一遍。

3.1 环境选型：JDK、Maven、MySQL、Redis 与若依版本的匹配

先看版本匹配，这一步错了后面全是玄学。

选型理由很简单：若依前后端分离版的历史适配最稳的就是 JDK 1.8 + Spring Boot 2.x。Node 18 跑 Vue2 会报error:0308010C:digital envelope routines::unsupported，这是 Webpack 和 OpenSSL 的兼容问题，不是代码问题。如果你不确定，先按 JDK 1.8 + Maven 3.6.3 + MySQL 5.7 + Redis 5 + Node 14 配，这套组合最容易过。

3.2 按顺序执行脚本：clean、package、run 的调用关系

环境配好之后，不要一上来就双击 run.bat。我习惯在 cmd 窗口里分步执行：

clean.bat package.bat ry.bat

到这一步后端窗口会保持前台运行，不要关。再另开一个 cmd 窗口：

run-web.bat

先解释一下顺序。clean.bat清理上次构建残留；package.bat负责把后端编译成 jar；ry.bat启动后端。如果 package.bat 本身带了mvn clean package，那 clean.bat 也可以省略，但分步跑的好处是每一步出错都看得见。

run.bat我放在最后用。等这套流程手动分步跑通一次之后，再双击 run.bat 当日常开关。把一键启动当成最终结果，而不是第一步操作，否则你会分不清报错来自哪一段。

3.3 数据库初始化与配置文件修改：连接串、端口、日志路径

数据库脚本通常在项目 sql 目录下，也可能直接写在文档里。先建库再导入：

mysql -uroot -p123456 -e "CREATE DATABASE IF NOT EXISTS sdn_monitor CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;" mysql -uroot -p123456 sdn_monitor < sql/sdn_monitor.sql

建库时用 utf8mb4，不要用 MySQL 默认的 latin1。如果你以后要存中文的终端名称或告警描述，utf8mb4 才够用。

导入完成后改后端配置。若依里通常有两个文件：application.yml和application-druid.yml。重点看数据源和 Redis 两段：

spring: datasource: druid: master: url: jdbc:mysql://127.0.0.1:3306/sdn_monitor?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 123456

spring: redis: host: 127.0.0.1 port: 6379 password: database: 0

参数说明：characterEncoding=utf8解决中文乱码；serverTimezone=Asia/Shanghai解决 8.0 版本下时间差八小时的问题。Redis 的password留空表示无密码，不要写null，有些连接驱动会把字符串null当成密码去认证。

改端口时要同步改两处：后端server.port和前端 proxy 的 target。只改一边，前端就会一直请求到错误地址。

3.4 验证服务是否起来：看端口、看日志、看接口

后端启动后不要急着点页面，先在命令行确认进程和接口：

netstat -ano | findstr :8080

能看到 LISTENING 说明端口已经在监听。接着测登录接口：

curl -X POST http://127.0.0.1:8080/login -H "Content-Type: application/json" -d "{\"username\":\"admin\",\"password\":\"admin123\"}"

如果返回内容是带code和token的 JSON，说明后端已经通了。连接失败就往后端日志看，通常是 Redis 或数据源没起来。到这一步，后端链路才算真正闭合。

4. 避坑与排查：SDN 园区检测工程常见的五个运行问题

这套工程我在实际部署时踩过不少次坑，以下五个问题是最常见的。每一条都按现象、原因、解决给出来，你可以直接照着查。

4.1 现象：ry.bat 一闪而过，窗口直接关闭

最常见的新手问题，双击脚本后黑框一闪就没了，完全看不到报错。

原因：脚本执行失败后 cmd 窗口默认自动关闭，真实报错被吞掉了。很多人会怀疑环境变量配错，其实很多时候是脚本里某个路径不对，或者 mvn 命令不在 PATH 里。

解决：不要双击，在 cmd 里用/k参数执行，让窗口执行完不关闭：

cmd /k D:\project\sdn-monitor\ry.bat

也可以临时在 bat 文件最后一行加pause。等看到具体报错再去改环境，问题通常一目了然。

4.2 现象：package.bat 构建失败，提示 JDK 版本或 Maven 编译器级别不对

构建时常见报错有java.lang.UnsupportedClassVersionError或No compiler is provided。

原因：Maven 调用的不是同一个 JDK。有的机器上JAVA_HOME指向 JRE，有的电脑装了好几个 JDK，mvn -v看到的版本和 IDEA 里选的版本不一样。

解决：先查当前环境：

mvn -v echo %JAVA_HOME%

确认 Maven 用的是 JDK 1.8 后，再执行打包。如果不对，临时在当前 cmd 窗口指定：

set JAVA_HOME=D:\Java\jdk1.8.0_202 set PATH=%JAVA_HOME%\bin;%PATH%

这个修改只在当前窗口生效，适合快速验证。确认无误后，再把系统环境变量里的 JAVA_HOME 改掉。

4.3 现象：后端起来了，前端登录按钮一直转圈，接口请求 404

后端 curl 能通，但浏览器登录时 Network 面板里请求是 404。

原因：前端把请求发给了/dev-api/login，但前端 dev server 没有正确代理到后端端口。常见原因是.env.development改了值，但 vue.config.js 里的 proxy 没改，或者代理配置没重新加载。

解决：检查.env.development和vue.config.js：

devServer: { proxy: { '/dev-api': { target: 'http://localhost:8080', changeOrigin: true, pathRewrite: { '^/dev-api': '' } } } }

参数说明：target必须和后端实际端口一致；changeOrigin解决跨域 Host 头问题；pathRewrite把/dev-api前缀去掉再转发到后端。如果后端有额外的 context-path，这段还要对应调整。改完必须关掉 run-web.bat 重新启动，环境变量不会热更新。

4.4 现象：启动日志里出现 RedisConnectionException

项目起不来，日志里报Redis connection refused或写 session 失败。

原因：本地 Redis 没启动，或者spring.redis.password和 Redis 实际密码不一致。若依用 Redis 存登录 session，Redis 连不上，后端会直接退出或频繁重试。

解决：Windows 下把 Redis 注册成服务，避免每次手动启动：

redis-server.exe --service-install redis.windows.conf --service-name Redis net start Redis

开发调试阶段也可以直接前台跑redis-server.exe redis.windows.conf。如果 Redis 设置了密码，同一个密码要写进application.yml的spring.redis.password，两边必须一模一样。

4.5 现象：数据库脚本执行到一半报错，表结构不全

导入 SQL 时提示Table already exists或某个外键字段找不到，后面登录报各种查询错误。

原因：脚本不是可重复执行的全量脚本，之前已经导入过一遍，第二遍执行必然冲突。也可能脚本里建表顺序有依赖，中途断开导致表结构残缺。

解决：确认这份 SQL 是全量初始化还是增量更新。全量脚本就重建库再导入，注意先备份已有数据：

mysql -uroot -p -e "DROP DATABASE IF EXISTS sdn_monitor; CREATE DATABASE sdn_monitor CHARACTER SET utf8mb4;" mysql -uroot -p sdn_monitor < sql/sdn_monitor.sql

不要在一个半建好的库上反复执行，越执行越乱。导入成功后先show tables看一眼表数量，再往后面走。

5. 二次开发：把园区流量检测功能接到若依菜单、REST API 和定时任务上

工程跑通之后，重头戏是把自己的检测模块挂上去。若依的思维方式是菜单到权限到接口再到页面，顺着这条链改就行。

5.1 在若依菜单里挂一个检测页面

最简单的方式是登录系统，通过系统管理里的菜单管理界面新增，但项目里要可复现，我更喜欢直接用 SQL 往sys_menu里插种子数据。

INSERT INTO sys_menu ( menu_name, parent_id, order_num, path, component, menu_type, perms, visible, status ) VALUES ( '园区流量检测', 0, 1, 'sdn-monitor', 'sdn/monitor/index', 'C', 'sdn:monitor:list', '0', '0' );

字段含义拆一下：parent_id=0表示顶级菜单；path是路由地址；component对应前端views/sdn/monitor/index.vue这个文件路径；menu_type=C表示这是一个菜单，不是目录或按钮；perms是权限标识，后面接口鉴权就靠它。

执行后重新登录，或者去菜单管理里刷新，左侧菜单里就能看到“园区流量检测”。

5.2 封装 SDN 控制器 REST API 调用

SDN 控制器的北向接口几乎都是 REST/HTTP，所以后端起一个客户端专门封装调用最直接。

@Component public class SdnRestClient { @Value("${sdn.controller.host:127.0.0.1}") private String host; @Value("${sdn.controller.port:8181}") private Integer port; private RestTemplate restTemplate; public SdnRestClient(RestTemplateBuilder restTemplateBuilder) { this.restTemplate = restTemplateBuilder.build(); } public String getFlowStats() { String url = "http://" + host + ":" + port + "/stats/flow/all"; HttpHeaders headers = new HttpHeaders(); headers.setBasicAuth("admin", "admin"); HttpEntity<Void> request = new HttpEntity<>(headers); ResponseEntity<String> response = restTemplate.exchange( url, HttpMethod.GET, request, String.class ); if (!response.getStatusCode().is2xxSuccessful()) { throw new RuntimeException("SDN 控制器返回异常：" + response.getStatusCode()); } return response.getBody(); } }

逻辑说明：RestTemplateBuilder是 Spring Boot 提供的构造器，便于后续配超时；setBasicAuth对应控制器的 HTTP Basic 认证。不同控制器的北向接口路径不一样，如果是 ONOS，可能在/onos/v1/flows，如果是 OpenDaylight，大概率是/restconf/operational/...，以你实际拿到的控制器文档为准。

5.3 定时任务：把检测结果写进数据库

拿到控制器返回的 JSON 后，不能只在日志里看一眼，要落库。这里我用 Spring 的@Scheduled做一个最简单采集任务。

@Component public class SdnMonitorTask { private static final Logger log = LoggerFactory.getLogger(SdnMonitorTask.class); private final SdnRestClient sdnRestClient; private final SdnMonitorLogService sdnMonitorLogService; public SdnMonitorTask(SdnRestClient sdnRestClient, SdnMonitorLogService sdnMonitorLogService) { this.sdnRestClient = sdnRestClient; this.sdnMonitorLogService = sdnMonitorLogService; } @Scheduled(fixedDelay = 60000, initialDelay = 10000) public void collectFlowStats() { String stats = sdnRestClient.getFlowStats(); List<FlowStat> statsList = FlowStatParser.parse(stats); sdnMonitorLogService.batchInsert(statsList); log.info("园区流量检测：本次采集 {} 条流表", statsList.size()); } }

参数说明：fixedDelay=60000表示上一次任务执行完再等 60 秒执行下一次，适合采集这种不能重叠的任务；initialDelay=10000表示启动后等 10 秒再跑第一次，给容器初始化留时间。如果换成fixedRate，任务会固定间隔触发，但方法本身耗时长时会重入，我一般不用。

如果项目已经在用若依自带的定时任务模块，也可以不写@Scheduled，改成在后台配置 cron 表达式，但调试期注解最快。

5.4 权限模型与账号分配

页面和数据都有了，最后一步是收权限。

@RestController @RequestMapping("/sdn/monitor") public class SdnMonitorController { @Autowired private SdnMonitorLogService sdnMonitorLogService; @PreAuthorize("@ss.hasPermi('sdn:monitor:list')") @GetMapping("/list") public TableDataInfo list(SdnMonitorQuery query) { startPage(); List<SdnMonitorLog> list = sdnMonitorLogService.selectList(query); return getDataTable(list); } }

@PreAuthorize("@ss.hasPermi('sdn:monitor:list')")是若依写好的权限注解。它取当前登录用户所有角色的权限集合做匹配，匹配不上直接抛 403。所以这里要同步做两件事：菜单表里perms字段写sdn:monitor:list，角色管理里给对应角色勾选这个菜单。只加注解不配权限，前端页面能打开但接口一定 403。

6. 验证系统真正可用：用 curl、日志和界面做三次确认

这个工程能不能算真正跑通，我通常不只看登录页。下面三个手工检查，能帮你把隐藏问题一次滤干净。

6.1 用 curl 确认后端和 Token 认证

先登录拿 token，再带 token 访问业务接口：

TOKEN=$(curl -s -X POST http://127.0.0.1:8080/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"admin123"}' | jq -r '.token') curl -s -X GET http://127.0.0.1:8080/sdn/monitor/list \ -H "Authorization: Bearer ${TOKEN}"

如果你在 Windows 命令行跑，没有 jq 也正常，先看登录接口响应里有没有 token 字段，手动复制出来再用。带 token 访问列表接口时，返回的应该是若依标准的分页结构，里面有total和rows。能返回rows，说明数据库查询和权限注解都通过了。

6.2 观察日志确认定时任务执行

在跑 ry.bat 的窗口里等一分钟看日志。定时任务配置是fixedDelay=60000，启动后 10 秒首次执行，之后每 60 秒执行一次。日志里看到“园区流量检测：本次采集 N 条流表”，才代表 SDN 控制器调用、解析、入库三个环节全通了。

如果只看到任务启动，没有采集日志，回到 5.2 检查控制器地址，或确认SdnMonitorTask是否真的被 Spring 扫描到。很多人在 Controller 里打印日志，但任务类没加@Component，导致任务根本没注册。

6.3 从界面上核对菜单与数据

最后把 admin 和一个普通角色分别登录一次。admin 要能看到“园区流量检测”，打开后列表有数据。普通角色如果没有配sdn:monitor:list权限，菜单要么不显示，要么打开是 403。这时候回到菜单管理里把权限挂到角色上，而不是去代码里注释掉@PreAuthorize——注释权限只能骗自己，交付之后会被按在地上摩擦。

从那以后，我每换一台机器跑这套工程，都强制走一遍 clean 到 run-web 的完整顺序，再用 admin 和被授权角色各登录一次，确认菜单、接口、定时任务三样都是通的才收工。希望帮到你。

本文还有配套的精品资源，点击获取