warpdot-dev/ghosttrack
GitHub: warpdot-dev/ghosttrack
基于 Node.js 的命令行 OSINT 助手，提供 IP 地理定位、公网 IP 查询、电话号码解析及用户名跨平台足迹检查功能。
Stars: 0 | Forks: 0
# GhostTrack
**GhostTrack** 是一个用于**网络侦察**、**数字足迹检查**和 **OSINT 式查询**的 **JavaScript (Node.js) 命令行助手**。它提供四个交互式菜单：**IP 地理定位**、**你的公网 IP**、**电话号码元数据**（使用 `libphonenumber-js` 解析）以及跨常见社交平台的**用户名 URL 检查**。
[](https://nodejs.org/)
[](https://developer.mozilla.org/docs/Web/JavaScript)
[](./package.json)
**关键词：** *Node.js CLI OSINT*、*IP geolocation JavaScript*、*ipwho*、*ipify*、*phone parsing libphonenumber-js*、*username enumeration URLs*、*Termux Node*。
**主仓库：** https://github.com/warpdot-dev/ghosttrack
**当前版本：** **v2.2** (CLI 入口文件：`GhostTR.mjs`)
## 目录
- [环境要求](#requirements)
- [在 Linux 上安装](#install-on-debian-or-ubuntu)
- [在 Termux (Android) 上安装](#install-on-termux-android)
- [在 Windows 上安装](#install-on-windows)
- [运行](#run)
- [功能](#features)
- [依赖项](#dependencies)
- [从旧的 Python 版本迁移](#migrating-from-the-old-python-version)
- [相关工具](#related-tooling-ip-capture-flows)
- [项目结构](#project-layout)
- [致谢](#credits)
## 环境要求
- **Node.js 18.17+** (`fetch`, `AbortSignal.timeout`, ES modules)。
- 需要能访问 `https://ipwho.is`、`https://api.ipify.org` 以及各个社交网站的网络权限 (用户名模式)。
## 在 Debian 或 Ubuntu Linux 上安装
```
sudo apt-get update
sudo apt-get install -y git curl
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - # or use distro Node 18+
sudo apt-get install -y nodejs git
git clone https://github.com/warpdot-dev/ghosttrack.git
cd ghosttrack
npm install
```
## 在 Termux (Android) 上安装
```
pkg update && pkg install -y git nodejs-lts
git clone https://github.com/warpdot-dev/ghosttrack.git
cd ghosttrack
npm install
```
## 在 Windows 上安装
安装 [Node.js LTS](https://nodejs.org/) (≥ 18.17)，然后：
```
git clone https://github.com/warpdot-dev/ghosttrack.git
cd ghosttrack
npm install
```
## 运行
```
npm start
```
或者直接运行：
```
node GhostTR.mjs
```
菜单出现后，输入 **1–4** 或 **0** 退出。从终端打印的编号列表中选择一个选项。
## 功能
| 菜单 | 功能说明 |
|------|----------------|
| **IP Tracker** | 通过 **`https://ipwho.is`** 解析并丰富数据 (地图链接使用了与旧版脚本类似的截断经纬度)。 |
| **Show Your IP** | 通过 **`https://api.ipify.org`** 显示出网 IP。 |
| **Phone Number Tracker** | 使用 **`libphonenumber-js/max`** 解析号码 (对于模糊的输入，默认地区为 **`ID`**)。打印有效性、格式、国家/地区标签 (`Intl.DisplayNames`)，以及**国家级别的时区名称** (`countries-and-timezones`)。移动网络 **运营商/提供商字符串未被包含** —— 该数据仅存在于 Python 的 phonenumbers 运营商数据库中。 |
| **Username Tracker** | 对每个平台的标准个人资料 URL 发起 GET 请求；**`HTTP 200`** 将被视为一个可能的个人资料页面 (仍然只是一个**提示**，而非所有权的证明)。 |
## 依赖项
`GhostTR.mjs` 中为纯 **JavaScript** 运行时代码；npm 打包文件：
| 软件包 | 作用 |
|---------|------|
| `libphonenumber-js` (+ **max** metadata) | 解析、有效性、格式化、线路类型 |
| `countries-and-timezones` | 国家 ISO -> 时区标识符 (近似值) |
不需要 Python 解释器或 `pip` 安装。
## 从旧的 Python 版本迁移
旧版的 **`GhostTR.py`** + **`requirements.txt`** 流程 (`phonenumbers`, `requests`) 已被**移除**。请改用 **Node.js** 和 **`npm install`**。其行为在有意设计上保持相似；主要存在的差异有 **`Operator` / carrier** 输出，因为它依赖于 phonenumbers 的运营商元数据，而这些数据在目前的 JS 库中并未提供。
## 相关工具 (IP 捕获流程)
Seeker — 可选的 IP 捕获实验室辅助工具
- [thewhiteh4t/seeker](https://github.com/thewhiteh4t/seeker)
- 仅在**经授权的**安全意识测试或限定范围的红队实验室中使用。
## 项目结构
```
ghosttrack/
├── GhostTR.mjs # Interactive CLI entry (JavaScript / Node ESM)
├── package.json
├── package-lock.json
├── .gitignore
├── asset/ # Banner and screenshots (may reference older menus)
└── README.md
```
## 致谢
- **上游作者：** [@HunxByts](https://github.com/HunxByts)
- **运行时引用的数据/API：** [ipwho.is](https://ipwho.is/)、[api.ipify.org](https://www.ipify.org/)、公开的社交平台 URL
标签：CDN识别, CMS安全, DAST, DNS查询, DNS解析, ESC4, GitHub, GNU通用公共许可证, ipify, IPv4, IPv6, IPwhois, IP地理位置, IP查询, JavaScript, MITM代理, Node.js, OSINT, PowerShell, SOC Prime, Termux, Unix, 侦察工具, 公共IP, 实时处理, 开发工具, 开源项目, 恶意软件分析, 手机号归属地, 批量测试, 攻击路径可视化, 数字取证, 数字足迹, 数据可视化, 用户名追踪, 网络安全, 自动化脚本, 自定义脚本, 跨平台工具, 隐私保护, 黑客工具