# ruoyi-radius **Repository Path**: panweilei/ruoyi-radius ## Basic Information - **Project Name**: ruoyi-radius - **Description**: 若依Radius认证系统: 若依框架V4.6.0 + ToughRADIUS,支持标准RADIUS协议(RFC 2865, RFC 2866),提供完整的AAA实现。可运用于酒店WIFI认证,公司局域网权限认证,商场WIFI认证,其它公共场所等等 - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 138 - **Forks**: 86 - **Created**: 2021-03-11 - **Last Updated**: 2026-04-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 平台简介
前段时间做了一个路由认证项目,网上查了好久,终于在gitee上找到了jamiesun大佬开源的ToughRADIUS,基本上符合项目的需求,但还是不能完全满足,以前一直用的若依大佬开源的若依后台管理框架,最后把2个大佬的项目合并,再添加项目的新功能,形成了本项目最终框架。
此框架继承了2个框架的优点,以若依后台管理框架V4.6.0做为基础框架,实现了ToughRADIUS大部分功能,支持标准RADIUS协议(RFC 2865, RFC 2866),提供完整的AAA实现。可运用于酒店WIFI认证,公司局域网权限认证,商场WIFI认证,其它公共场所等等,当然,您也可以对她进行深度定制,以做出更强系统。所有前端后台代码封装过后十分精简易上手,出错概率低。系统会陆续更新一些实用功能。
项目经过多年的迭代,终于迎来了重大更新:本项目升级为前后端分离版本并做为主分支,同时保留单应用版本分支。前后端分离版本以疯狂的狮子Li大佬开源的RuoYi-Vue-Plus为基础框架,迁移单应用版本的功能并新增实用功能。接下来作者会不断更新更多的实用功能,同时也希望有更多的小伙伴加入我们的开源项目~
* 感谢 若依后台管理 框架。点我前往 * 感谢 ToughRADIUS 框架。点我前往 * 感谢 RuoYi-Vue-Plus 框架。点我前往 ## 在线体验 - RuoYi-Radius官网:https://ruoyiradius.com - 演示地址:https://demo.ruoyiradius.com - 在线文档:https://doc.ruoyiradius.com - 技术交流QQ群:5475847 点我前往 ## 项目分支说明 - master 前后端分离版本:基于RuoYi-Vue-Plus开源框架 - archive-master 单应用版本:基于若依RuoYi开源框架 ## 环境要求清单 | 组件 | 要求 | 验证命令 | 作用 | 是否必须 | |----------|---------|----------|----------|---| | Java | JDK 17+ | `java -version` | 打包&部署时使用 | ✅ | | Maven | 3.5+ | `mvn -v` | 打包时使用 | ⭕ | | Git | 最新版 | `git --version` | 下载源码时使用 | ⭕ | | MySQL | 8.0+ | `mysql --version` | 数据库 | ✅ | | Redis | 5.0+ | `redis-server --version` | 缓存 | ✅ | | InfluxDB | 2.7.10+ | | 时序数据库 | ✅ | | minio | 8.5+ | | 文件存储 | ⭕ | ## 主要特性 - ✅ **Radius协议支持**: PAP/CHAP/MSCHAPv2 认证 - ✅ **Portal协议支持**: CMCCV1/CMCCV2/HUAWEIV1/HUAWEIV2 认证 - ✅ **用户管理**: 开户、销户、套餐变更 - ✅ **计费系统**: 时长/流量计费 - ✅ **设备管理**: NAS设备管理、BAS设备管理 - ✅ **监控统计**: 实时在线用户监控 ## 适用场景 - 企业网络认证 - 校园网认证 - 酒店/商场WiFi认证 - 宽带接入认证 ## 支持的路由器厂商 - 爱立信 - ToughProxy - 中兴 - 思科 - H3C - 华为 - juniper - Mikrotik ## 系统功能 ### Radius功能 - **设备管理**:完整支持Radius协议,兼容主流网络设备。 - **用户管理**:开户、销户、套餐变更、流量动态限制。 - **套餐管理**:计费套餐CRUD管理。 - **订单管理**:套餐支付记录管理。 - **在线用户管理**:认证用户在线管理,套餐到期自动下线,也可以通过后台强制下线。 ### Portal功能 - **设备管理**:完整支持Portal协议,兼容主流网络设备。 - **认证页面**:提供用户进行Portal认证的主页面。 - **支付页面**:提供套餐浏览及购买支付的页面。 - **注册页面**:提供访客自主注册的页面。 - **在线用户管理**:认证用户在线管理,套餐到期自动下线,也可以通过后台强制下线。 - ### 内置功能 - **用户管理**:用户是系统操作者,该功能主要完成系统用户配置。 - **部门管理**:配置系统组织机构(公司、部门、小组),树结构展现支持数据权限。 - **岗位管理**:配置系统用户所属担任职务。 - **菜单管理**:配置系统菜单,操作权限,按钮权限标识等。 - **角色管理**:角色菜单权限分配、设置角色按机构进行数据范围权限划分。 - **字典管理**:对系统中经常使用的一些较为固定的数据进行维护。 - **参数管理**:对系统动态配置常用参数。 - **通知公告**:系统通知公告信息发布维护。 - **操作日志**:系统正常操作日志记录和查询;系统异常信息日志记录和查询。 - **登录日志**:系统登录日志记录查询包含登录异常。 - **在线用户**:当前系统中活跃用户状态监控。 - **定时任务**:在线(添加、修改、删除)任务调度包含执行结果日志。 - **代码生成**:前后端代码的生成(java、vue、js、xml、sql)支持CRUD下载 。 - **系统接口**:根据业务代码自动生成相关的api接口文档。 - **服务监控**:监视当前系统CPU、内存、磁盘、堆栈等相关信息。 - **缓存监控**:对系统的缓存查询,查看、清理等操作。 - **连接池监视**:监视当期系统数据库连接池状态,可进行分析SQL找出系统性能瓶颈。 ## 项目结构 ``` RuoYi-Radius ├─ ruoyi-admin // 管理模块 [8080,28080] │ └─ RuoYiApplication // 启动类 │ └─ RuoYiServletInitializer // 容器部署初始化类 │ └─ resources // 资源文件 │ └─ i18n/messages.properties // 国际化配置文件 │ └─ application.yml // 框架总配置文件 │ └─ application-dev.yml // 开发环境配置文件 │ └─ application-prod.yml // 生产环境配置文件 │ └─ banner.txt // 框架启动图标 │ └─ logback-plus.xml // 日志配置文件 │ └─ ip2region.xdb // IP区域地址库 ├─ ruoyi-extend // 扩展模块 │ └─ ruoyi-monitor-admin // admin监控模块 [9090] │ └─ ruoyi-snailjob-server // 任务调度中心模块 [8800,17888] ├─ ruoyi-common // 通用模块 │ └─ ruoyi-common-bom // common依赖包管理 │ └─ ruoyi-common-core // 核心模块 │ └─ ruoyi-common-doc // 系统接口模块 │ └─ ruoyi-common-encrypt // 数据加解密模块 │ └─ ruoyi-common-excel // excel模块 │ └─ ruoyi-common-idempotent // 幂等功能模块 │ └─ ruoyi-common-job // 定时任务模块 │ └─ ruoyi-common-json // 序列化模块 │ └─ ruoyi-common-log // 日志模块 │ └─ ruoyi-common-mail // 邮件模块 │ └─ ruoyi-common-mybatis // 数据库模块 │ └─ ruoyi-common-oss // oss服务模块 │ └─ ruoyi-common-ratelimiter // 限流功能模块 │ └─ ruoyi-common-redis // 缓存服务模块 │ └─ ruoyi-common-satoken // satoken模块 │ └─ ruoyi-common-security // 安全模块 │ └─ ruoyi-common-sensitive // 脱敏模块 │ └─ ruoyi-common-sms // 短信模块 │ └─ ruoyi-common-social // 社交三方模块 │ └─ ruoyi-common-sse // sse流推送模块 │ └─ ruoyi-common-tenant // 租户模块 │ └─ ruoyi-common-translation // 通用翻译模块 │ └─ ruoyi-common-web // web模块 │ └─ ruoyi-common-websocket // websocket服务集成模块 ├─ ruoyi-modules // 模块组 │ └─ ruoyi-auth // 认证模块(Portal认证、Radius认证) │ └─ ruoyi-generator // 代码生成模块 │ └─ ruoyi-job // 任务调度服务 │ └─ ruoyi-system // 业务模块 ├─ ruoyi-ui // 前端框架 [80] ├─ script // 系统脚本包 │ └─ bin // 运行脚本包 │ └─ docker // docker部署相关脚本 │ └─ sql // sql脚本 ├─ .editorconfig // 编辑器编码格式配置 ├─ LICENSE // 开源协议 ├─ pom.xml // 公共依赖 ├─ README.md // 框架说明文件 ``` ## 系统截图 - 登录界面  - 首页统计  - 认证用户管理  - NAS设备管理  - BAS设备管理  - Portal认证页面  