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内核, 侦察工具, 占用监测, 可自定义解析器, 子域名枚举, 实时处理, 密码管理, 工具管理, 工具编排, 应用安全, 攻防演练, 数字取证, 数据展示, 无后门, 极简安装, 白帽子, 系统安全, 红队, 网络安全, 自动化脚本, 资产管理, 运行时操纵, 逆向工具, 隐私保护