xspeen/-PingEye
GitHub: xspeen/-PingEye
PingEye 是一个基于 Web 的 IP 与手机号情报查询平台,能将单一地址转化为包含地理位置、网络拓扑和注册信息的完整数字档案。
Stars: 0 | Forks: 0
IP 与手机号情报套件
查询任何 IPv4、IPv6 地址或手机号背后的位置、网络、运营商和注册详情。
## 安装说明
一条命令。选择你的平台。
### Termux
```
bash <(curl -fsSL https://raw.githubusercontent.com/xspeen/-PingEye/main/install.sh)
```
### Linux (Ubuntu, Debian, Kali, Parrot OS, Fedora)
```
bash <(curl -fsSL https://raw.githubusercontent.com/xspeen/-PingEye/main/install.sh)
```
### macOS
```
bash <(curl -fsSL https://raw.githubusercontent.com/xspeen/-PingEye/main/install.sh)
```
### Windows (PowerShell)
以**管理员身份**打开 **PowerShell** 并运行:
```
irm https://raw.githubusercontent.com/xspeen/-PingEye/main/install.ps1 | iex
```
### Windows (CMD)
```
powershell -Command "irm https://raw.githubusercontent.com/xspeen/-PingEye/main/install.ps1 | iex"
```
### Windows 用户 — 请阅读此说明
**Dell / 旧硬件用户**:如果你的 CPU 性能较低或 GPU 较小,请使用 **Git Bash** 来运行安装程序。Git Bash 非常轻量,并且能与 PingEye 完美兼容。
1. 从 https://git-scm.com/download/win 下载并安装 **Git for Windows**
2. 在安装过程中,选择 **"Add to PATH"**
3. 打开 **Git Bash**(不要使用 CMD 或 PowerShell)
4. 运行安装命令:
```
bash <(curl -fsSL https://raw.githubusercontent.com/xspeen/-PingEye/main/install.sh)
```
如果 Git Bash 中没有 `curl`,请使用 PowerShell 进行安装。
**PowerShell 用户**:安装完成后,可以在任意终端中运行 `pingeye`。安装程序会自动将其添加到你的 PATH 中。如果无法立即生效,请关闭并重新打开你的终端。
## 运行说明
安装完成后,只需运行:
```
pingeye
```
这将会:
1. 在 8080 端口启动一个本地服务器
2. 在浏览器中自动打开 PingEye
3. 显示密码提示(首次运行时需要创建一个)
### 命令
| 命令 | 描述 |
|---------|-------------|
| `pingeye` | 启动 PingEye 服务器 |
| `pingeye --stop` | 停止正在运行的服务器 |
| `pingeye --reset` | 重置密码 |
| `pingeye --version` | 显示版本 |
| `pingeye --update` | 检查更新 |
| `pingeye --help` | 显示帮助信息 |
## 功能
### IP 查询
- 国家、城市、地区、邮政编码
- ISP、ASN、组织
- 网络类型(住宅区 vs 数据中心)
- GPS 坐标及 OpenStreetMap 集成
- 反向 DNS(PTR 记录)
- RDAP 注册数据(网络名称、范围、日期)
- 本地时间显示
### 手机号查询
- 国家和运营商检测
- 线路类型(移动 / 固定线路)
- 国际和本地号码格式
- 需要 Numverify API 密钥(可在 numverify.com 免费获取)
### 历史记录
- 保存最近 10 次查询
- 点击任意历史记录条目以重新运行查询
- 一键清除历史记录
### 个人资料
- 显示名称和头像(点击头像可上传照片)
- 从设置中更改密码
- 主题切换(深色/浅色)
### 设置
- 添加你的 **Numverify API 密钥** 用于手机号查询
- 主题选择器
- 版本检查与更新通知
### 安全性
- 启动时需要密码保护
- 首次运行设置将创建你的密码
- 3 次尝试失败后可重置遗忘的密码
- 所有数据均本地存储在你的设备上
## API 密钥
### Numverify(手机号查询)
1. 前往 https://numverify.com/
2. 注册一个免费账户
3. 获取你的 API 密钥
4. 打开 PingEye > 个人资料 > 设置 > 粘贴你的密钥
5. 完成 — 手机号查询现在即可正常使用
IP 查询无需任何 API 密钥(使用 ipwho.is)。
## 联系方式
## 更新日志
### v2.0.5 -- 最新版本
PingEye CLI 的初始版本:
- IP 查询,包含完整的地理位置、网络和 RDAP 数据
- 通过 Numverify API 进行手机号查询
- 查询历史记录(最近 10 次)
- 密码保护,支持设置/重置
- 包含照片上传和显示名称的个人资料
- 用于手机号查询的 API 密钥配置
- 深色/浅色主题
- 跨平台安装程序(Termux、Linux、macOS、Windows)
- Windows 支持:Git Bash、CMD、PowerShell
- 自动更新检查器
- 一键安装程序
StreamHub v2.0.5
标签:C2日志可视化, GitHub, IP情报, 云安全, 后端开发, 地理位置, 威胁情报, 实时处理, 开发者工具, 指纹识别, 文档结构分析