AftabHusain8/subdomain-sentinel
GitHub: AftabHusain8/subdomain-sentinel
一款基于 React 的子域名枚举与实时存活状态检测工具，通过可视化界面帮助安全研究人员快速发现和筛选目标域名资产。
Stars: 1 | Forks: 0
# 🔍 Subdomain-Sentinel
## ✨ 功能特性
| 功能 | 描述 |
|---------|-------------|
| 🌐 **子域名枚举** | 发现任何目标域名的子域名 |
| ⚡ **存活状态检查** | 对每个子域名进行实时 HTTP 状态验证 |
| 📊 **交互式仪表盘** | 简洁、可筛选的结果展示及统计概览 |
| 🎯 **智能筛选** | 根据状态码筛选结果（活跃、非活跃、错误） |
| 📈 **进度追踪** | 可视化扫描进度与实时更新 |
| 🌙 **现代化 UI** | 时尚的响应式设计与深色主题 |
## 🛠️ 技术栈
| 技术 | 用途 |
|-----------|---------|
| [React 18](https://react.dev) | UI 框架 |
| [TypeScript](https://typescriptlang.org) | 类型安全 |
| [Vite 5](https://vitejs.dev) | 构建工具与开发服务器 |
| [Tailwind CSS](https://tailwindcss.com) | 实用优先的样式方案 |
| [shadcn/ui](https://ui.shadcn.com) | 组件库 |
| [TanStack Query](https://tanstack.com/query) | 异步状态管理 |
| [Recharts](https://recharts.org) | 数据可视化 |
## 🚀 快速开始
### 前置条件
- **Node.js** ≥ 18.x — [下载](https://nodejs.org)
- **npm** ≥ 9.x (随 Node.js 附带)
### 安装
```
# 克隆 repository
git clone https://github.com/AftabHusain8/subdomain-sentinel.git
# 导航到 project directory
cd subdomain-sentinel
# 安装 dependencies
npm install
# 启动 development server
npm run dev
```
应用将在 **http://localhost:8080** 运行 🎉
### 生产环境构建
```
npm run build
```
优化后的输出将位于 `dist/` 目录中。
## 📁 项目结构
```
subdomain-sentinel/
├── public/ # Static assets
├── src/
│ ├── components/ # Reusable UI components
│ │ ├── ui/ # shadcn/ui base components
│ │ ├── DomainInput.tsx # Domain input form
│ │ ├── FilterTabs.tsx # Status filter tabs
│ │ ├── ResultsTable.tsx # Scan results table
│ │ ├── ScanProgress.tsx # Progress indicator
│ │ ├── ScannerHeader.tsx # App header
│ │ └── StatsCards.tsx # Statistics cards
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utilities & scanner logic
│ │ ├── subdomain-scanner.ts
│ │ └── utils.ts
│ ├── pages/ # Route pages
│ ├── App.tsx # Root component
│ └── main.tsx # Entry point
├── tailwind.config.ts # Tailwind configuration
├── vite.config.ts # Vite configuration
└── tsconfig.json # TypeScript configuration
```
## 🎯 应用场景
- **Bug Bounty 挖掘** — 在侦察阶段快速枚举子域名
- **渗透测试** — 识别安全评估的攻击面
- **安全研究** — 发现并监控子域名基础设施
- **DevOps 与 IT** — 审计和追踪组织的子域名资产
## 🗺️ 路线图
- [ ] 后端集成 (Python / Go) 以实现高级扫描
- [ ] 基于API的扫描与速率限制
- [ ] 导出结果为 CSV / JSON / PDF
- [ ] 多线程并发扫描
- [ ] DNS 记录类型枚举
- [ ] 对发现的子域名进行截图捕获
- [ ] 历史扫描对比
## 👨💻 作者
**Aftab Husain**
网络安全爱好者 | 全栈开发者
[](https://github.com/AftabHusain8)
## 📜 许可证
本项目基于 **MIT 许可证** 授权 — 详情请参阅 [LICENSE](LICENSE) 文件。
⭐ 如果您觉得这个项目有用，请给仓库一个 Star！
标签：GitHub, HTTP状态检测, React, Recharts, Syscalls, Tailwind CSS, TypeScript, Vite, 仪表盘, 子域名扫描器, 子域名枚举, 存活探测, 安全插件, 密码管理, 插件系统, 系统安全, 网络安全, 自动化攻击, 资产测绘, 隐私保护