mirror of
https://github.com/yyhuni/xingrin.git
synced 2026-01-31 11:46:16 +08:00
Xingrin - 星环
一款现代化的企业级漏洞扫描与资产管理平台
提供自动化安全检测、资产发现、漏洞管理等功能
🌗 明暗模式切换
🎨 多种 UI 主题
✨ 功能特性
🎯 目标与资产管理
- 组织管理 - 多层级目标组织，灵活分组
- 目标管理 - 支持域名、IP目标类型
- 资产发现 - 子域名、网站、端点、目录自动发现
- 资产快照 - 扫描结果快照对比，追踪资产变化
🔍 漏洞扫描
- 多引擎支持 - 集成 Nuclei 等主流扫描引擎
- 自定义流程 - YAML 配置扫描流程，灵活编排
- 定时扫描 - Cron 表达式配置，自动化周期扫描
🖥️ 分布式架构
- 多节点扫描 - 支持部署多个 Worker 节点，横向扩展扫描能力
- 本地节点 - 零配置，安装即自动注册本地 Docker Worker
- 远程节点 - SSH 一键部署远程 VPS 作为扫描节点
- 负载感知调度 - 实时感知节点负载，自动分发任务到最优节点
- 节点监控 - 实时心跳检测，CPU/内存/磁盘状态监控
- 断线重连 - 节点离线自动检测，恢复后自动重新接入
┌─────────────────────────────────────────────────────────────────┐
│ 主服务器 (Master) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Next.js │ │ Django │ │ Postgres│ │ Redis │ │
│ │ 前端 │ │ 后端 │ │ 数据库 │ │ 缓存 │ │
│ └─────────┘ └────┬────┘ └─────────┘ └─────────┘ │
│ │ │
│ ┌─────┴─────┐ │
│ │ 任务调度器 │ │
│ │ Scheduler │ │
│ └─────┬─────┘ │
└────────────────────┼────────────────────────────────────────────┘
│
┌────────────┼────────────┐
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Worker 1 │ │ Worker 2 │ │ Worker N │
│ (本地) │ │ (远程) │ │ (远程) │
├───────────┤ ├───────────┤ ├───────────┤
│ • Nuclei │ │ • Nuclei │ │ • Nuclei │
│ • httpx │ │ • httpx │ │ • httpx │
│ • naabu │ │ • naabu │ │ • naabu │
│ • ... │ │ • ... │ │ • ... │
├───────────┤ ├───────────┤ ├───────────┤
│ 心跳上报 │ │ 心跳上报 │ │ 心跳上报 │
└───────────┘ └───────────┘ └───────────┘
📊 可视化界面
- 数据统计 - 资产/漏洞统计仪表盘
- 实时通知 - WebSocket 消息推送
- 暗色主题 - 支持明暗主题切换
🛠️ 技术栈
- 前端: Next.js + React + TailwindCSS
- 后端: Django + Django REST Framework
- 数据库: PostgreSQL + Redis
- 部署: Docker + Nginx
🔧 内置扫描工具
| 类别 | 工具 |
|---|---|
| 子域名爆破 | puredns, massdns, dnsgen |
| 被动发现 | subfinder, amass, assetfinder, Sublist3r |
| 端口扫描 | naabu |
| 站点发现 | httpx |
| 目录扫描 | ffuf |
| 爬虫 | katana |
| 被动URL收集 | waymore, uro |
| 漏洞扫描 | nuclei, dalfox |
📦 快速开始
环境要求
- 操作系统: Ubuntu 20.04+ / Debian 11+ （推荐）
- 硬件: 2核 4G 内存起步，10GB+ 磁盘空间
一键安装
# 克隆项目
git clone https://github.com/yyhuni/xingrin.git
cd xingrin
# 安装并启动（生产模式）
sudo ./install.sh
# 开发模式
sudo ./install.sh --dev
访问服务
- Web 界面:
https://localhost或http://localhost
常用命令
# 启动服务
sudo ./start.sh
# 停止服务
sudo ./stop.sh
# 重启服务
sudo ./restart.sh
# 卸载
sudo ./uninstall.sh
# 更新
sudo ./update.sh
日志
- 项目日志：/opt/xingrin/logs 下存储了这个项目的运行日志信息，error文件存储了错误相关信息，xingrin.log存储了包括错误在内的所有项目日志
- 工具调用日志：/opt/xingrin/results 下存储了工具的运行结果日志，比如naabu，httpx等的结果调用日志
🤝 反馈与贡献
📧 联系
-
目前版本就我个人使用，可能会有很多边界问题
-
如有问题，建议，其他，优先提交Issue，也可以直接给我的公众号发消息，我都会回复的
-
微信公众号: 洋洋的小黑屋
⚠️ 免责声明
重要：请在使用前仔细阅读
- 本工具仅供授权的安全测试和安全研究使用
- 使用者必须确保已获得目标系统的合法授权
- 严禁将本工具用于未经授权的渗透测试或攻击行为
- 未经授权扫描他人系统属于违法行为，可能面临法律责任
- 开发者不对任何滥用行为负责
使用本工具即表示您同意：
- 仅在合法授权范围内使用
- 遵守所在地区的法律法规
- 承担因滥用产生的一切后果
📄 许可证
本项目采用 PolyForm Noncommercial License 1.0.0 许可证。
允许的用途
- ✅ 个人学习和研究
- ✅ 非商业安全测试
- ✅ 教育机构使用
- ✅ 非营利组织使用
禁止的用途
- ❌ 商业用途（包括但不限于：出售、商业服务、SaaS 等）
- ❌ 未经授权的渗透测试
- ❌ 任何违法行为
如需商业授权，请联系作者。