berodcdev/alive-netscan
GitHub: berodcdev/alive-netscan
alive 是一款跨 macOS 与 Linux 的本地网络主机发现工具,在终端以表格形式展示所有连接设备的 IP、MAC、制造商及设备类型。
Stars: 1 | Forks: 0
alive
主机发现 · 网络侦察 — 直接在终端中运行
`alive` 会扫描本地网络,并在清晰的表格中显示**谁**以及**什么**正在连接:
IP、MAC、制造商以及每台设备的可能**类型** —— `路由器 (ROTEADOR)`、`电脑 (COMPUTADOR)`、
`手机 (CELULAR)`、`电视/流媒体 (TV/STREAM)`、`智能助手 (ASSISTENTE)`、`打印机 (IMPRESSORA)`、`服务器 (SERVIDOR)`、`IOT`、`游戏主机 (CONSOLE)`。
它可以在 **macOS 和 Linux** 上运行且无需 root 权限:在可用时使用 `nmap`,否则,
它会执行并行的 *ping sweep* 并结合 ARP 表。设备名称和类型来源于
反向 DNS、mDNS/Bonjour (`zeroconf`) 以及 OUI 制造商数据库(离线)。
## ⚠️ 授权使用 — 使用前必读
## 安装
```
git clone https://github.com/berodcdev/alive-netscan.git
cd alive-netscan
./install.sh
```
安装程序会检测您的操作系统(Homebrew、apt、dnf、pacman、zypper),选择一个健康的 Python 3
版本,创建一个**隔离环境**(位于 `~/.local/share/alive` 的 `venv`)并包含所有
依赖项,通过位于 `~/.local/bin` 的 symlink 暴露 `alive` 命令(如有需要会自动调整 `PATH`),
并提供安装 `nmap` 的选项(可选,但推荐)。
```
./install.sh --with-nmap # instala e já traz o nmap
./install.sh --no-nmap # instala sem tocar no nmap
./install.sh --uninstall # remove o alive
```
## 用法
```
alive # varre a rede WiFi atual
alive --demo # demonstração com dados fictícios
alive -h # ajuda completa (colorida)
alive --fast # rápido: só ping sweep + ARP
alive -n 192.168.0.0/24 # varre uma subrede específica
alive -i wlan0 # força uma interface
alive --sort type # agrupa por tipo de dispositivo
alive --json > recon.json # saída em JSON para automação
```
## 工作原理
| 阶段 | 作用 |
|-------|-----------|
| **网络** | 根据操作系统检测接口、IP、子网 (CIDR)、网关和 SSID |
| **扫描** | `nmap -sn`(如果存在)+ 并行 ping sweep;通过 ARP 表获取 MAC |
| **信息丰富** | 反向 DNS、mDNS/Bonjour、通过 OUI 获取制造商(离线) |
| **分类** | 结合制造商 + mDNS 服务 + 主机名的启发式方法 |
如果没有 `nmap` 或没有 `sudo`,`alive` 依然可以工作 —— 只是可能无法发现那些
忽略 ping 的设备。安装 `nmap` 和/或使用 `sudo` 运行可以提高 MAC 的发现率。
## 系统要求
- Python 3.8+(安装程序会自动选择一个健康的版本)
- Python 依赖项(安装在 venv 中):`rich`、`rich-argparse`、`zeroconf`、`mac-vendor-lookup`
- 可选:`nmap`(提高扫描覆盖率)
`alive` 隔离在其独立的虚拟环境中 —— 不会污染系统的 Python。
## 许可证
基于 **MIT** 许可证分发。请参阅 [`LICENSE`](LICENSE) 获取完整文本。
由 dev@bernardorodc.com 制作
标签:ARP, Facebook API, Python, 动态分析, 局域网扫描, 插件系统, 无后门, 网络工具, 逆向工具