Cyrudra/Netscope-network-scanner

# 🔍 NetScope - 网络漏洞扫描与安全审计平台 ## 📋 目录 - [功能](#-features) - [前置条件](#-prerequisites) - [快速开始](#-quick-start) - [安装](#-installation) - [运行应用程序](#-running-the-application) - [故障排除](#-troubleshooting) - [项目结构](#-project-structure) - [API Endpoints](#-api-endpoints) ## ✨ 功能 ### 🔍 网络扫描 - **快速扫描** - 快速主机发现 - **深度扫描** - 全面的端口和服务枚举 - **OS 检测** - 操作系统指纹识别 - **漏洞扫描** - 基于 CVE 的漏洞检测 - **全面审计** - 完整的网络安全评估 ### 🛡️ 安全分析 - **漏洞检测** - 检测已知的 CVE（EternalBlue、BlueKeep 等） - **CVSS 评分** - 对所有发现的问题进行严重性评估 - **合规性审计** - 许可证合规性追踪 - **盗版软件检测** - 识别未激活的 Windows - **威胁检测** - 可疑端口监控（后门检测） ### 📊 报告 - 包含统计数据的执行摘要 - 设备细分分析 - 导出为 JSON/CSV 格式 - 交互式图表和可视化 ## 📦 前置条件 | 要求 | 最低版本 | 推荐 | |-------------|----------------|-------------| | Node.js | v18.0.0 | **v20.x.x** | | npm | 8.0.0 | **10.x.x** | | 内存 | 2GB | 4GB+ | | 操作系统 | Windows 10+, Ubuntu 20.04+, macOS | Windows 11 / Ubuntu 22.04 | ## 🚀 快速开始 ### 选项 1：一键安装 (Linux/macOS) ``` git clone network-scanner cd network-scanner chmod +x start.sh ./start.sh ``` ### 选项 2：一键安装 (Windows CMD) ``` git clone network-scanner cd network-scanner start.bat ``` ## 📥 安装 ### 步骤 1：进入项目目录 ``` cd network-scanner ``` ### 步骤 2：安装根目录依赖 ``` npm install ``` ### 步骤 3：安装客户端依赖 ``` cd client npm install cd .. ``` ### 步骤 4：启动应用程序 ``` # Terminal 1 - Backend API Server (端口 3001) node server/index.js # Terminal 2 - Frontend Dev Server (端口 5173) cd client npm run dev ``` ## 🎯 运行应用程序 ### 开发模式 ``` # 启动 backend server node server/index.js # 在另一个 terminal 中，启动 frontend cd client npm run dev ``` ### 生产模式 ``` # 构建 frontend cd client npm run build cd .. # 启动 production server NODE_ENV=production node server/index.js ``` ## 🌐 访问 URL | 服务 | URL | 描述 | |---------|-----|-------------| | **Frontend** | http://localhost:5173 | Web 界面 | | **Backend API** | http://localhost:3001 | REST API | | **WebSocket** | ws://localhost:3001 | 实时更新 | ## 📁 项目结构 ``` network-scanner/ ├── server/ │ └── index.js # Express API server ├── client/ │ ├── src/ │ │ ├── pages/ # React page components │ │ ├── components/ # Reusable UI components │ │ └── utils/ # Utilities │ ├── dist/ # Built frontend (production) │ └── package.json ├── data/ # JSON database files ├── package.json ├── start.sh # Linux/macOS launcher ├── start.bat # Windows launcher ├── start-production.bat # Windows production launcher ├── SPEC.md # Project specification └── README.md # This file ``` ## 🔌 API Endpoints ### 扫描管理 | 方法 | Endpoint | 描述 | |--------|----------|-------------| | POST | `/api/scans` | 开始新扫描 | | GET | `/api/scans` | 列出所有扫描 | | GET | `/api/scans/:id` | 获取扫描详情 | | DELETE | `/api/scans/:id` | 删除扫描 | ### 主机管理 | 方法 | Endpoint | 描述 | |--------|----------|-------------| | GET | `/api/hosts` | 列出所有发现的主机 | | GET | `/api/hosts/:id` | 获取主机详情 | ### 漏洞 | 方法 | Endpoint | 描述 | |--------|----------|-------------| | GET | `/api/vulnerabilities` | 列出所有漏洞 | | GET | `/api/cve/:cveId` | 获取 CVE 详情 | ### 报告与审计 | 方法 | Endpoint | 描述 | |--------|----------|-------------| | GET | `/api/reports/:scanId` | 生成报告 | | GET | `/api/reports/:scanId/export?format=json` | 导出 JSON | | GET | `/api/reports/:scanId/export?format=csv` | 导出 CSV | | GET | `/api/audit/compliance` | 合规性摘要 | | GET | `/api/audit/threats` | 活跃威胁 | ## 🛠️ 故障排除 ### 问题：`npm install` 失败并出现 ERESOLVE 错误 **解决方案：** ``` rm -rf node_modules package-lock.json npm install --legacy-peer-deps ``` ### 问题：`better-sqlite3` 编译失败 **解决方案：** 使用 JSON 文件存储（已配置好）： ``` rm -rf node_modules npm install ``` ### 问题：在 WSL/NTFS 上出现 esbuild 二进制文件错误 **解决方案：** ``` npm install --ignore-scripts ``` ### 问题：Node.js 版本过旧 **解决方案：** 升级 Node.js： ``` # Linux/macOS curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt install -y nodejs # 检查版本 node --version # Should be v20.x.x ``` ### 问题：端口已被占用 **解决方案：** 终止现有进程： ``` # Linux/macOS pkill -f "node server" lsof -ti:3001 | xargs kill -9 # Windows netstat -ano | findstr :3001 taskkill /PID /F ``` ## 🔧 特定平台说明 ### 🐧 Ubuntu / Linux ``` # 安装 Node.js 20 curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt install -y nodejs # 导航至项目 cd network-scanner # 安装依赖 npm install cd client && npm install && cd .. # 运行应用 ./start.sh ``` ### 🪟 Windows (CMD) ``` REM Install Node.js from https://nodejs.org/ REM Navigate to project cd network-scanner REM Install dependencies npm install cd client && npm install && cd .. REM Run application start.bat ``` ### 🍎 macOS ``` # 通过 Homebrew 安装 Node.js brew install node@20 # 导航至项目 cd network-scanner # 安装依赖 npm install cd client && npm install && cd .. # 运行应用 ./start.sh ``` ### 📦 WSL (Windows Subsystem for Linux) ``` # 在 WSL 中安装 Node.js curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt install -y nodejs # 导航至项目（在 WSL 文件系统中，而非 /mnt/c/） cd ~/network-scanner # 安装依赖 npm install cd client && npm install && cd .. # 运行应用 ./start.sh ``` ## 🎨 UI 页面 | 页面 | 路由 | 描述 | |------|-------|-------------| | 仪表盘 | `/` | 包含统计、图表和近期活动的概览 | | 扫描 | `/scans` | 扫描历史与管理 | | 主机 | `/hosts` | 所有发现的设备 | | 主机详情 | `/hosts/:id` | 单个设备详情 | | 漏洞 | `/vulnerabilities` | CVE 追踪与分析 | | 合规性 | `/compliance` | 许可证审计与威胁 | | 报告 | `/reports` | 安全报告与导出 | ## 📊 扫描结果示例 扫描 `192.168.1.0/24` 时的结果： ``` ┌─────────────────────────────────────────────────┐ │ 📊 Scan Results │ ├─────────────────────────────────────────────────┤ │ Devices Discovered: 12 │ │ Critical Vulnerabilities: 17 │ │ High Vulnerabilities: 12 │ │ Medium Vulnerabilities: 8 │ │ Compliance Issues: 5 │ │ Pirated Software Found: 3 │ └─────────────────────────────────────────────────┘ ``` ## 🔒 安全说明 - 本工具专为**内部网络审计**设计 - 在扫描网络之前，务必获取适当的授权 - 请勿在您不拥有或未经许可审计的网络上使用 - 定期更新 CVE 数据库以确保漏洞检测的准确性 ## 📜 许可证 MIT License - 详情请参阅 LICENSE 文件。 ## 👨‍💻 作者 **Ajay Kumar, Cyber Commando** 🛡️ *网络安全专家 | 道德黑客 | 安全工具开发者*

**NetScope** - 赋能 IT 团队以保护其基础设施 🔐 由 Ajay Kumar, Cyber Commando 用 ❤️ 制作

标签：DInvoke, Facebook API, GNU通用公共许可证, MITM代理, Node.js, React, Syscalls, 企业级, 插件系统, 网络安全, 自定义脚本, 速率限制, 隐私保护