PRATHAM777P/TraceRecon

# TraceRecon

**TraceRecon** 是一个开源的、基于终端的 OSINT 和网络侦察工具包，使用 Python 编写。它将最常见的侦察工作流整合到一个单一、整洁的交互式 CLI 中 —— 专为安全研究人员、CTF 参赛者和网络管理员而设计。 ## 功能概述 | # | 模块 | 描述 | |---|--------|-------------| | 1 | **IP 地址追踪** | 完整的地理定位、ISP、ASN、时区、地图链接 | | 2 | **我的公网 IP** | 检测您自身的公网 IP 及 ISP 信息 | | 3 | **电话号码 OSINT** | 通过 phonenumbers 获取运营商、地区、格式、时区 | | 4 | **用户名侦察** | 跨 30 多个社交/开发者平台的线程扫描 | | 5 | **DNS 查询** | A、AAAA、MX、NS、TXT、CNAME、SOA、SRV 记录 | | 6 | **WHOIS 查询** | 注册商、日期、名称服务器、注册人信息 | | 7 | **反向 DNS (PTR)** | 主机名解析 + 正向确认检查 | | 8 | **子网 / CIDR 计算器** | 网络/广播/主机范围、子网掩码、IP 版本 | | 9 | **端口扫描器** | 针对 20 个常见端口及服务 ID 的线程扫描 | | ✦ | **导出结果** | 每个模块均可将 JSON + TXT 导出至 `output/` 目录 | ## 截图

## 工作流

``` ┌─────────────────────────────────────────────────────────┐ │ Launch tracerecon.py │ └─────────────────────────┬───────────────────────────────┘ │ ┌───────────▼───────────┐ │ Main Menu │ └──┬──┬──┬──┬──┬──┬────┘ │ │ │ │ │ │ ┌────────────┘ │ │ │ │ └──────────────┐ ▼ ▼ │ ▼ ▼ ▼ [1] IP [3] Phone [5] DNS [8] Subnet Tracker OSINT Lookup Calc │ │ │ │ │ ▼ │ │ ▼ │ GeoIP + ISP Carrier [6] WHOIS Net range + Map link Region Registrar + hosts │ │ │ │ │ └───────────────┘ │ └──────────────┘ │ ┌────────▼────────┐ │ [4] Username │ │ Recon │ │ 30+ platforms │ │ (threaded) │ └────────┬────────┘ │ ┌────────▼────────┐ │ Export JSON │ ← every module │ + TXT output/ │ └────────┬────────┘ │ ┌────────▼────────┐ │ EXIT │ └─────────────────┘ ``` ## 安装说明 ### 前置条件 - Python 3.8 或更高版本 - pip ### 快速开始 ``` # 1. Clone repository git clone https://github.com/PRATHAM777P/TraceRecon.git cd TraceRecon # 2. (推荐) 创建 virtual environment python -m venv venv source venv/bin/activate # Linux / macOS venv\Scripts\activate.bat # Windows # 3. 安装 dependencies pip install -r requirements.txt # 4. 运行 python tracerecon.py ``` ### Termux (Android) ``` pkg update && pkg upgrade pkg install python git git clone https://github.com/PRATHAM777P/TraceRecon.git cd TraceRecon pip install -r requirements.txt python tracerecon.py ``` ## 演示用法 ### 模块 1 — IP 地址追踪 ``` [ ? ] Select option : 1 Enter target IP (leave blank for auto-detect): 8.8.8.8 ──────────────────────────────────────────────────── RESULT — IP INFORMATION ──────────────────────────────────────────────────── Target IP : 8.8.8.8 Type : IPv4 Country : United States 🇺🇸 City : Mountain View Latitude : 37.386 Longitude : -122.0838 Google Maps : https://maps.google.com/?q=37.386,-122.0838 ISP : Google LLC ASN : 15169 Timezone ID : America/Los_Angeles Current Time : 2025-01-01T10:30:00-08:00 ──────────────────────────────────────────────────── Export results? [y/N]: y [+] Results saved → ip_tracker_20250101_103000.json & .txt ``` ### 模块 3 — 电话号码 OSINT ``` [ ? ] Select option : 3 Enter phone number [+countrycode number]: +14155552671 ──────────────────────────────────────────────────── RESULT — PHONE INFORMATION ──────────────────────────────────────────────────── Input Number : +14155552671 E.164 Format : +14155552671 International : +1 415-555-2671 National Format : (415) 555-2671 Country Code : +1 Region : US Location : California Carrier/Operator : (carrier data if available) Number Type : Fixed Line Valid : True Timezone(s) : America/Los_Angeles ──────────────────────────────────────────────────── ``` ### 模块 4 — 用户名侦察 ``` [ ? ] Select option : 4 Enter username to hunt: johndoe Scanning 30 platforms for 'johndoe' … ──────────────────────────────────────────────────── [FOUND] GitHub → https://github.com/johndoe [FOUND] Twitter/X → https://x.com/johndoe [FOUND] Reddit → https://www.reddit.com/user/johndoe [---] TikTok → not found [---] Snapchat → not found ... ──────────────────────────────────────────────────── RESULT — 3 MATCHES / 27 NOT FOUND ``` ### 模块 5 — DNS 查询 ``` [ ? ] Select option : 5 Enter domain (e.g. example.com): github.com [A ] 140.82.121.4 [AAAA ] — no record — [MX ] 10 aspmx.l.google.com., 20 alt1.aspmx.l.google.com. [NS ] ns1.p16.dynect.net., ns2.p16.dynect.net. [TXT ] v=spf1 ip4:192.30.252.0/22 ... [SOA ] ns1.p16.dynect.net. ... ``` ### 模块 8 — 子网计算器 ``` [ ? ] Select option : 8 Enter IP/CIDR (e.g. 192.168.1.0/24): 10.0.0.0/8 Network : 10.0.0.0/8 CIDR : /8 Network Addr : 10.0.0.0 Broadcast : 10.255.255.255 Netmask : 255.0.0.0 Total Hosts : 16777216 Usable Hosts : 16777214 First Host : 10.0.0.1 Last Host : 10.255.255.254 Is Private : True ``` ## 输出文件 每个模块都会提示您导出结果。文件将保存至 `output/` 目录： ``` output/ ├── ip_tracker_20250101_103000.json ├── ip_tracker_20250101_103000.txt ├── phone_osint_20250101_110000.json ├── username_recon_20250101_115000.json └── ... ``` `output/` 目录已列入 `.gitignore` —— 您的结果绝不会被意外提交。 ## 项目结构 ``` TraceRecon/ ├── tracerecon.py ← Main application ├── requirements.txt ← Python dependencies ├── README.md ← This file ├── SECURITY.md ← Security policy & ethical use ├── .gitignore ← Excludes output/, venv/, etc. ├── assets/ │ ├── banner.png ← Project header banner │ ├── workflow.png ← Workflow diagram │ ├── ip_icon.png ← IP Tracker module icon │ ├── phone_icon.png ← Phone OSINT module icon │ ├── user_icon.png ← Username Recon module icon │ ├── dns_icon.png ← DNS Lookup module icon │ └── whois_icon.png ← WHOIS module icon └── output/ ← Exported results (gitignored) ``` ## 使用的 API | API | 用途 | 是否需要认证 | |-----|---------|--------------| | [ipwho.is](https://ipwho.is) | IP 地理定位与 ISP 数据 | 否 | | [api.ipify.org](https://api.ipify.org) | 公网 IP 检测 | 否 | | phonenumbers (库) | 电话 OSINT —— 离线 | 否 | | dnspython (库) | 通过系统解析器进行 DNS 查询 | 否 | | python-whois (库) | 通过 WHOIS 协议进行 WHOIS 查询 | 否 | | socket (标准库) | 端口扫描，PTR 查询 | 否 | 所有查询均为 **只读** 且 **仅限出站**。没有服务器端组件。 ## 路线图 - [ ] 邮件头 OSINT 模块 - [ ] Shodan 集成（可选 API 密钥） - [ ] GeoIP 地图渲染（终端内的 ASCII 地图） - [ ] 通过 CPE 字符串进行 CVE 查询 - [ ] 被动子域名枚举 - [ ] 用于 API 密钥的 JSON 配置文件 ## 作者 **Prathamesh Penshanwar** []

为安全研究社区而构建 —— 请负责任地使用。

标签：CLI, DNS分析, ESC4, GitHub, IP追踪, OSINT, Python, WHOIS查询, WiFi技术, 协议探测, 后渗透, 地理位置定位, 域名反查, 子网计算器, 安全研究员, 数据导出, 数据统计, 无后门, 无线安全, 用户名查询, 端口扫描, 网络安全, 网络管理员, 逆向工具, 隐私保护