Andrew-most-likely/Terminal-Port-Crawler

GitHub: Andrew-most-likely/Terminal-Port-Crawler

一款集成端口扫描、横幅抓取与威胁分析的终端工具，解决快速识别开放服务与安全风险的问题。

Stars: 16 | Forks: 0

# TPC - 终端端口爬虫 **端口扫描与威胁分析、横幅抓取、操作系统指纹识别和 CVE 引用。** 以全 TUI 或纯命令行模式运行。
[![Download](https://img.shields.io/badge/Download%20for%20Windows-tpc.exe-blue?style=for-the-badge&logo=windows)](https://github.com/Andrew-most-likely/Terminal-Port-Crawler/releases/latest) *无需 Python，直接下载并运行。*

## 从源码安装 ``` git clone https://github.com/Andrew-most-likely/Terminal-Port-Crawler cd Terminal-Port-Crawler pip install -e . ``` **要求：** Python 3.9+，pip 21.3+ ## 使用方法 ### TUI（交互式） ``` tpc ``` 启动完整终端界面。输入目标并按 `Ctrl+S` 开始爬取。 ### CLI（仅标志参数，无 UI） ``` tpc -t [options] ``` | 参数 | 描述 | |------|-------------| | `-t`, `--target` | 目标 IP、主机名、CIDR 子网或短横线范围 | | `-p`, `--ports` | 端口范围，例如 `1-1024`（默认：`1-1024`） | | `-m`, `--mode` | 扫描模式：`fast`、`random`、`slow`（默认：`fast`） | | `--delay` | 慢模式下端口之间的延迟秒数（默认：`0.5`） | | `--udp` | 同时爬取已知的 UDP 端口 | | `-b`, `--banners` | 爬取后抓取服务横幅 | | `-e`, `--export` | 导出结果：`txt`、`csv`、`json`、`html` | **示例：** ``` tpc -t 192.168.1.1 # crawl common ports tpc -t 192.168.1.1 -p 1-65535 # full port range tpc -t 192.168.1.0/24 -m random # subnet, random order tpc -t 192.168.1.1 -m slow --delay 1.0 # slow crawl tpc -t 192.168.1.1 --udp # include UDP tpc -t 192.168.1.1 -b -e json # banners + JSON export tpc --help # show all flags ``` ## 功能特性 - 基于 75+ 个已知服务定义进行 TCP 端口爬取 - 在选定范围内爬取所有已知 UDP 端口 - 快速、随机顺序和慢速爬取模式 - 子网爬取（CIDR 表示法：`192.168.1.0/24`） - IP 范围爬取（`192.168.1.1-50`） - 主机名解析（正向与反向 DNS） - 全端口范围选项（1-65535） - 服务枚举的横幅抓取 - 基于开放端口模式的操作系统指纹识别 - 威胁评估 — 高 / 中 / 低风险评级 - 知名开放端口的 CVE 引用 - 导出为 TXT、CSV、JSON 或 HTML - HTML 导出渲染为带样式报告 - 导出文件保存至 `exports/` 文件夹 - 持久化爬取历史记录 - 纯 CLI 模式 — 无需 UI ## TUI 快捷键 | 操作 | 按键 | |----------------|----------| | 开始爬取 | Ctrl+S | | 抓取横幅 | Ctrl+B | | 导出结果 | Ctrl+E | | 新建爬取 | Ctrl+N | | 关于 | F1 | | 退出 | Ctrl+Q | ## 目标格式 | 格式 | 示例 | |-------------|-------------------| | 单个 IP | `192.168.1.1` | | 主机名 | `router.local` | | CIDR 子网 | `192.168.1.0/24` | | 短横线范围 | `192.168.1.1-50` | ## 法律声明仅在你拥有或获得**明确书面许可**的系统上使用此工具。未经授权的端口爬取可能违反你所在司法管辖区的 CFAA、《计算机滥用法》或类似法律。玩得开心 😊