rayscan - RayScan v2.0 — 全栈 Web 漏洞扫描器。8种SQLi + 6种XSS + 12种OA

项目说明

🔬 RayScan 2.3.0

<di="center">

!Python
!License
!
!Status
![CI]()
!Tests
!GitHub stars
!GitHub last commit
![Flask]()

🎯 中文 OA / 国产中间件专项 Web 漏洞检测器 | 三级检测链路 · 规则级证据 · 低误报 | 通用漏洞 Nuclei 兜底（12.5w 模板）

497 个自动化测试（pytest 实测口径） · 靶机验证（Metasploitable 2 / DVWA） · 12 种 OA 系统专项检测

> 📌 项目定位（ADR-0001）：中文 OA / 国产中间件专项检测器，一条命令出可复核报告。通用检测由内置 Nuclei 阶段兜底。
> 领域术语见 CONTEXT.md。

> 📈 v2.3.0 新特性：被动捕获→主动验证联动（passi / scan --from-proxy）· 证据包导出（report --pack，含可复现 curl）· OA 规则外部化（rules/oa YAML）· Nuclei 模板策展 · Web UI 三能力入口（被动捕获 / Profile / 证据链）
> 📈 测试覆盖路线图：当前 497 个测试集中在 SQLi/XSS/RCE/SSRF/OA 等核心检测器。
> v2.0 新特性：OA专项检测 / WebShell / 弱口令 / 子域名枚举 / Nuclei 模板集成
> 规划中（roadmap）：多引擎聚合（AW 集成层已实现，待接入主流程）、Metasploit 验证链、DOM XSS（需 headless 验证）

<p align="center">
<img src="images/cli运行.gif" alt="RayScan CLI 运行演示" width="80%">
<br><em>一条命令扫描靶场 —— 爬取 / 流式检测 / 漏洞报告全流程实录（循环演示）</em>
</p>

一分钟开始 · Web UI 演示 · 实战报告 · 功能列表 · Star 支持

</div>

📋 功能特性

🎯 核心专精模块（默认加载）

| 模块 | 检测维度 | 层级 |
|------|---------|:----:|
| SQL 注入 | 8种: error/union/boolean-blind/time-based/stacked/二阶/宽字节/OOB | 🟢 核心 |
| XSS | 5种: reflected/stored/Polyglot/mXSS/SSTI（DOM XSS 待 headless 验证，见 Roadmap）| 🟢 核心 |
| OA 专项 | 12种: 泛微/通达/金蝶/蓝凌/致远/用友/禅道/万户/Nacos/Spring/Jenkins/Confluence | 🟡 Lite |
| WebShell | 路径扫描 + 内容特征 + 启发式检测 | 🟡 Lite |
| 弱口令 | 表单登录 + phpMyAdmin + Tomcat Manager | 🟡 Lite |
| 子域名 | DNS爆破 + crt.sh 证书透明度 | 🟡 Lite |
| CMDi / LFI / RCE / SSRF / XXE | 通用漏洞检测 | 🟡 Lite |
| sensitive / api / waf / jspathfinder | 信息收集 + 绕过 | 🟡 Lite |

🧩 Lite 辅助模块（--all-modules 启用）

| 模块 | 说明 |
|------|------|
| CMDi / LFI / RCE / SSRF / XXE | 通用漏洞检测 |
| sensitive / api / waf / jspathfinder | 信息收集 + 绕过 |
| mcp / graphql | MCP 工具泄露检测 · GraphQL introspection/批量查询 |
| 第三方集成 | Nuclei · sqlmap · ffuf · Wappalyzer |
| 报告格式 | HTML · JSON · CSV · Markdown · Console |

⚡ 架构亮点

🎯 新功能速览

🤖 v2.2.0 — AI 复核 + MCP + GraphQL

🏢 OA 专项检测

检测类型：SQL注入 / RCE / 文件上传 / 认证绕过 / 配置泄露 / 未授权访问
> 检测链路：内容指纹识别 → 版本识别 → 规则级响应证据验证 + 版本过滤。
> 仅路径可达不再视为漏洞（S1 误报治理）。详见 OA 检测规则。

📦 Nuclei 12.5w PoC 管理

💾 扫描断点恢复

🧭 规划中（Roadmap）

接入完成后将随版本发布启用，详见 技术演进规划。

🎯 靶机验证

<p align="center">
<img src="images/cli运行截图1.png" alt="RayScan CLI 扫描过程" width="80%">
<br><em>RayScan CLI 实时扫描输出（本地靶场 <code>scripts/benchmark_lab.py</code>）</em>
</p>

<p align="center">
<img src="images/cli运行截图2.png" alt="RayScan CLI 扫描结果" width="80%">
<br><em>RayScan CLI 扫描报告 —— 漏洞列表与详情（SQL 注入 4 项检出）</em>
</p>

RayScan 在 Metasploitable 2（DVWA v1.0.7）靶机上的扫描结果：

关键发现

| 漏洞类型 | 数量 | 详情 |
|---------|:----:|------|
| 🔴 敏感路径泄露 | 3 | /test/ 目录可读、/phpinfo.php 暴露 PHP 配置、phpMyAdmin 返回密码字段 |
| 🟡 版本指纹泄露 | 80 | Apache/2.2.8 (Ubuntu) DAV/2 — 确定靶机为 Metasploitable 2 |
| 🟢 SQL 注入 | 5 用户 | UNION 注入提取 users 表全部账号密码（MD5 可逆） |
| 🟢 LFI | 可读 /etc/passwd | 任意文件包含确认 |

---

🚀 Quick Start

Install from source

Docker

Web UI（推荐）

CLI

特定模块扫描

📖 详细使用说明

🎯 常用 CLI 参数（python -m wvs scan）

| 参数 | 说明 | 默认值 |
|------|------|:-----:|
| --rate | 请求速率（req/s） | 10 |
| --all-modules | 启用全部 Lite 模块（OA/WebShell/弱口令/子域名等） | 关 |
| --insecure | 跳过 SSL 证书校验 | 关 |
| --no-nuclei | 关闭 Nuclei 阶段 | 开（默认启用） |
| --resume | 从上次 checkpoint 恢复 | 关 |
| -o / -f | 报告输出路径 / 格式（json/html/csv/md） | json |
| --timeout | 扫描总超时（分钟） | — |

⚙️ 核心配置（w.py）

📁 Profile 扫描配置

内置 Profile：default / src-quick / pentest-full / sqli-only。

---

🖥️ Web UI 模式（推荐）

<p align="center">
<img src="images/web_ui截图.png" alt="RayScan Web UI" width="90%">
<br><em>RayScan Web UI — 深色主题 + 实时日志流</em>
</p>

适合不想敲命令的用户，浏览器图形化操作，支持实时日志流。

| 特性 | 说明 |
|------|------|
| 🎨 深色/浅色主题 | 一键切换 |
| 📐 响应式布局 | 手机/电脑自动适配 |
| ⚡ 实时日志流 | 和 CLI 完全一致的输出 |
| 📋 即时结果 | 发现漏洞立刻显示 |

---

📁 扫描报告

扫描完成后，结果以 JSON/HTML/CSV 格式输出，默认保存到当前目录。

---

🛠️ 配置说明

核心配置在 w.py 中，常用可调参数：

🔧 自定义扫描脚本

如果需要把 RayScan 作为库嵌入自己的工作流，直接使用 wvs 包 API：

🤖 支持的检测模块

| 模块 | 检测类型 |
|------|----------|
| sqli | SQL 注入 (error-based / union / boolean-blind / time-based / stacked) |
| xss | 跨站脚本 (反射型/存储型) |
| cmdi | 命令注入 |
| lfi | 本地文件包含 |
| rce | 远程代码执行 |
| ssrf | 服务端请求伪造 |
| xxe | XML 外部实体注入 |
| api | API 安全检测 |
| sensitive | 敏感信息泄露 |
| waf | WAF 检测与绕过 |
| jspathfinder | Ja 端点发现 |

🔗 外部工具集成

| 工具 | 用途 | 安装方式 |
|------|------|----------|
| Nuclei | 漏洞模板扫描 | pip install nuclei-python |
| sqlmap | SQL 注入深度利用 | 需单独安装 |
| ffuf | 模糊测试 | 需单独安装 |
| Wappalyzer | 技术栈识别 | pip install python-Wappalyzer |

📂 项目结构

📊 检测能力

| 能力 | 状态 | 靶机验证 |
|------|------|:--------:|
| SQL 注入 | ✅ error-based / union / boolean-blind / time-based | ✅ Metasploitable 2 — UNION 注入提取 5 用户密码 |
| XSS | ✅ 反射型 / 存储型 | ✅ 靶机验证通过（security=low） |
| 命令注入 | ✅ 高精度 | ⬜ 靶机未开放，但检测引擎就绪 |
| LFI | ✅ 本地文件包含 | ✅ Metasploitable 2 — 读取 /etc/passwd 成功 |
| SSRF | ✅ 服务端请求伪造 | ⬜ 待验证 |
| XXE | ✅ XML 外部实体注入 | ⬜ 待验证 |
| RCE | ✅ 远程代码执行 | ⬜ 待验证 |
| 敏感信息泄露 | ✅ 高覆盖 | ✅ Metasploitable 2 — 发现 /test/、phpinfo.php、phpMyAdmin 密码泄露 |
| WAF 绕过 | ✅ 多策略 | ⬜ 待验证 |
| API 扫描 | ✅ API 安全检测 | ✅ Metasploitable 2 — 80 个 Server 版本泄露 + 密码字段发现 |
| 第三方集成 | ✅ Nuclei, sqlmap, ffuf, Wappalyzer | ⬜ 需要独立安装第三方工具 |

⚙️ 版本历史

| 版本 | 说明 |
|------|------|
| RayScan 2.1 | 可解释检测 --explain / 被动扫描 passive / 一键演示 demo / 规则管理 rules / IDOR·越权·认证绕过 / gentle 合规预设 / ScanOrchestrator 编排层 |
| RayScan 2.0 | 全域升级版 — OA 专项 / WebShell / 弱口令 / 子域名 / Nuclei PoC（多引擎聚合与 MSF 验证链规划中，见 Roadmap）|
| RayScan 1.0 | 正式开源版（基于 WVS v19.2） |
| WVS v19 / v19.2 | 扫描引擎重构，集成框架升级 |
| WVS v18 / v18.4 | 高级检测模块 + 企业级扫描能力 |
| WVS v17 | 模块化架构重构 |
| WVS v16 | 插件系统 + 多报告格式 |
| WVS v15 | 基础扫描框架搭建 |
| WVS v1~14 | 早期版本开发迭代 |

详见 更名记

⚠️ 免责声明

本工具仅供获得明确授权的安全测试、渗透测试及漏洞研究使用。
未经授权扫描、攻击他人系统属于违法行为，使用者需自行承担一切法律责任。

使用本工具即表示您已阅读并同意上述条款。

📄 License

MIT License — Copyright (c) 2026 xiabai2008

项目信息

开发语言：Python

Star 数：11

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕RayScan v2.0 — 全栈 Web 漏洞扫描器。8种SQLi + 6种XSS + 12种OA + 多引擎聚合(Nuclei/AWVS/Nessus/MSF)展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。