Scipio456/Network-Port-Scanner
GitHub: Scipio456/Network-Port-Scanner
一个面向教育与授权测试的道德网络端口扫描器，通过 Node.js CLI 与 Python 引擎在限定范围内实现安全、可学习的 TCP 端口发现。
Stars: 0 | Forks: 0
# 道德网络端口扫描器（Node.js + Python）
本项目是一个混合网络端口扫描器，使用 **Node.js CLI** 作为后端接口，**Python** 作为核心扫描引擎。
## 🛡️ 道德使用与法律警告
**重要：仅限教育与授权测试使用。**
本工具专为道德安全专业人士和学生设计，用于审计自己的网络或已获得明确书面许可的网络。未经授权扫描网络可能被视为非法或违反服务条款。
### 道德准则：
- **先获取权限：** 永远不要扫描您不拥有或未获得正式授权审计的网络、主机或 IP。
- **本地范围：** 默认情况下，该工具仅检测并保持在私有 IP 范围内（`10.x.x.x`、`172.16.x.x`、`192.168.x.x`），以防止意外公开扫描。
- **不造成伤害：** 请勿使用本工具破坏服务或执行恶意活动。
- **责任声明：** 开发者不对本工具的滥用或由此造成的任何损害承担法律责任。
## 功能特性
- **快速扫描：** 使用 Python 线程实现并行主机发现与端口扫描。
- **Node.js CLI：** 提供带彩色输出的现代化命令行界面。
- **自动检测：** 自动识别本地网络（支持私有 IPv4 范围）。
- **JSON 输出：** 支持 JSON 格式输出，便于与其他工具集成。
- **GitHub 友好：** 预配置 `.gitignore`，防止泄露个人信息或扫描结果。
## 🛠️ 先决条件
- [Node.js](https://nodejs.org/)（v14+）
- [Python 3](https://www.python.org/)
## 📦 安装
1. 克隆仓库：
git clone
cd network-port-scanner
2. 安装依赖：
npm install
## 📖 使用方法
使用以下命令运行扫描器：
```
node index.js scan --start 1 --end 1024
```
### 选项：
- `-s, --start `：起始端口号（默认：1）
- `-e, --end `：结束端口号（默认：1024）
- `-j, --json`：以 JSON 格式输出结果
### 全局使用（可选）：
您可以将命令链接以全局使用：
```
npm link
network-scanner scan --start 80 --end 443
```
## 🛡️ 安全与隐私
- **仅限本地：** 扫描器限制在私有网络范围（192.168.x.x、10.x.x.x 等）内，确保道德使用。
- **Git 安全：** `.gitignore` 文件已配置为排除：
- `node_modules/`
- Python 缓存（`__pycache__`）
- 个人扫描结果（`results.json`、`scan_report.txt`）
- 环境文件（`.env`）
## ⚖️ 许可证
本项目仅供教育与道德测试使用。请仅对您拥有或已获明确授权扫描的网络使用该工具。
标签：API安全, .gitignore, GNU通用公共许可证, IPv4, JSON输出, Maven构建, MITM代理, Node.js, Python, TCP端口, XML 请求, 云存储安全, 后端工具, 命令行界面, 学习项目, 安全开发, 并行扫描, 开源安全工具, 彩色输出, 授权测试, 教育用途, 数据统计, 文档结构分析, 无后门, 本地网络, 私有IP检测, 端口审计, 端口扫描, 线程扫描, 网络发现, 网络安全, 网络扫描, 自动探测, 逆向工具, 逆向工程平台, 道德安全, 隐私保护, 集成工具