0xShadowVoid/recon-ranger
GitHub: 0xShadowVoid/recon-ranger
一款基于 Python 的轻量级侦察工具包管理器,通过精选核心工具和自动化编排,帮助安全研究人员快速搭建可复现的信息收集环境。
Stars: 0 | Forks: 0
# 🦅 ReconRanger v3.1.1 - Linux 精准侦察工具包
ReconRanger 是一个轻量级、精准的侦察工具包和管理器,专注于安装和编排一组经过精心筛选的高质量侦察工具。
## 概述
- **版本:** 3.1.1
- **理念:** 安装合适的工具,而不是最多的工具 —— 精准、可复现的侦察工作流。
- **平台:** Linux(兼容 Kali、Parrot、Ubuntu/Debian)。支持 WSL 用于测试。
## 注册表摘要
- **活跃注册表中的工具(`tools.json`):** 23
- **支持的(`core.config.TOOL_DEFINITIONS`):** 60
- **合并后的独立工具总数(注册表 + 定义):** 64
- **包含的类别:** 11
- **核心工具包(规范栈):** 15 个工具 — 请参阅 [BugBounty CLI 核心栈](BugBounty_CLI_Core-Stack.md),了解 ReconRanger 使用的精选核心集合
- **完整工具参考(所有受支持的工具):** 请参阅 [docs/TOOLS.md](TOOLS.md)(包含综合表格和按类别的细分)
## 快速链接
- 完整文档、指南和报告:[docs/README.md](docs/README.md)
- 最新版本:`v3.1.1`
## 快速开始
安装前置条件并修复系统依赖(以非 root 用户运行或在需要时通过 sudo 运行):
```
python3 reconranger.py --fix-deps
```
配置 API 密钥(交互式):
```
python3 ApiKeyMaster.py --configure
python3 ApiKeyMaster.py --print-exports # preview env exports (masked)
```
安装核心工具包(推荐):
```
python3 reconranger.py -c core
```
## 实用命令
- 列出工具:`python3 reconranger.py --list`
- 查看类别:`python3 reconranger.py --categories`
- 安装特定工具:`python3 reconranger.py -t subfinder httpx`
- 检查安装状态:`python3 reconranger.py --check`
## 为什么保留 docs/ 目录和根目录的 README
- `README.md`(本文件):简短、友好的 GitHub 项目着陆页。
- `docs/`:完整手册、验证报告和长篇生成的产物(在保留所有文档的同时保持仓库根目录整洁)。
## 安全与隐私
- 切勿提交 API 密钥。`ApiKeyMaster` 会将密钥存储在 `~/.reconranger/` 下并设置严格的权限。
- 如果你使用 `--export` 将密钥写入 shell 配置文件,请注意,shell 配置文件中的明文密钥存在安全风险。
## 贡献
请参阅 [docs/README.md](docs/README.md#developer-workflows) 中的完整贡献者指南和开发者工作流。
## 许可证
本软件旨在用于授权的安全测试和研究。详情请参阅 LICENSE.txt。
# 🦅 ReconRanger v3.1.1 - Linux 精准侦察工具包
Python 重写版,包含精准的核心工具包,可涵盖绝大多数常见的侦察工作流。无需 root 权限,支持自动回滚保护,5 分钟即可完成安装。安装精选的核心工具,打造专注、可复现的侦察工作流。
## ✨ 功能
- **模块化工具注册表:** 通过 CLI 添加、编辑、更新或删除工具,无需触碰代码。
- **精准核心工具包:** 为现代侦察(BBOT、Subfinder、Nuclei 等)预配置的最佳工具。
- **一键配置 API 密钥:** 集中管理 Chaos、GitHub、SecurityTrails、Netlas、Zoomeye、ShrewdEye 和 VirusTotal 的密钥。
- **跨发行版支持:** 为 **Kali Linux** 和 **Parrot OS** 优化,并支持自动修复依赖。
- **全局安装:** 工具全局安装到 `/usr/local/bin` 以便使用。
- **集成 PEGPON:** 默认包含先进的 PEGPON 自动化框架。
- **健壮的日志记录:** 在 `logs/` 目录中详细记录每次安装和错误的日志。
## 🚀 快速开始
### 1. 安装
```
# 克隆仓库
git clone https://github.com/0xShadowVoid/recon-ranger.git
cd recon-ranger
# 修复依赖并设置环境
python3 reconranger.py --fix-deps
```
### 2. 配置 API 密钥
```
# 启动配置向导
python3 reconranger.py --api
# 将密钥应用到工具配置和 shell 环境
python3 reconranger.py --apply-keys
```
### 3. 安装工具
```
# 安装 Core Toolkit(推荐)
python3 reconranger.py -c core
# 安装 registry 中的所有内容
python3 reconranger.py --install-all
# 按名称安装特定工具
python3 reconranger.py -t subfinder bbot nuclei
```
## 🛠️ 工具管理
recon-ranger v3.1.1 让维护你自己的自定义工具包变得轻松:
- **列出工具:** `python3 reconranger.py --list`
- **添加工具:** `python3 reconranger.py --add-tool`
- **删除工具:** `python3 reconranger.py --delete-tool `
- **检查状态:** `python3 reconranger.py --check`
## 📂 项目结构
- `reconranger.py`:主 CLI 入口点。
- `tools.json`:所有工具的动态注册表。
- `core/`:用于系统、安装和密钥的核心模块。
- `logs/`:安装和错误日志。
## 🔑 支持的 API 提供商
- **Chaos** [ProjectDiscovery]
- **GitHub** [个人访问令牌]
- **SecurityTrails** [DNS 情报]
- **Netlas** [互联网扫描]
- **Zoomeye** [网络空间搜索]
- **ShrewdEye** [子域名情报]
- **VirusTotal** [恶意软件与域名情报]
- **Shodan** [IoT 搜索引擎]
## 未来功能
- 请查看 [未来功能](https://github.com/0xShadowVoid/recon-ranger/blob/main/docs/future_features.md) 文件
## 🏷️ 主题
`linux` `debian` `ubuntu` `kali` `security-tools` `vulnerability-scanning` `reconnaissance` `subdomain-enumeration` `parrot-os` `bug-bounty-hunting` `bug-bounty-tools`
## 📜 许可证
本项目仅用于教育和符合道德规范的安全测试目的。
标签:API管理, Bug Bounty, GitHub, Python, TGT, Windows内核, 侦察工具, 占用监测, 可自定义解析器, 子域名枚举, 实时处理, 密码管理, 工具管理, 工具编排, 应用安全, 攻防演练, 数字取证, 数据展示, 无后门, 极简安装, 白帽子, 系统安全, 红队, 网络安全, 自动化脚本, 资产管理, 运行时操纵, 逆向工具, 隐私保护