Name	Name	Last commit message	Last commit date
Latest commit History 2 Commits
assets	assets
build	build
cmd	cmd
fingerprints	fingerprints
gui	gui
internal	internal
.gitignore	.gitignore
LICENSE	LICENSE
Makefile	Makefile
README.md	README.md
config.example.json	config.example.json
go.mod	go.mod
go.sum	go.sum

NetRadar - Network Asset Discovery & Port Scanner

纯 C/S 架构的跨平台内网资产发现与端口扫描桌面应用。完全采用 Go 语言开发，基于 Fyne 原生 GUI 框架，零 Web 依赖。

🚀 功能特性

核心扫描引擎

模块	功能	技术细节
IP 存活探测	多模式主机发现	ICMP / ICMPv6 / TCP / UDP / ARP / NDP / SCTP，支持混合模式交叉验证与置信度评分
端口扫描	10 种扫描方式	TCP Connect / SYN / ACK / NULL / FIN / Xmas / Window / Maimon / UDP / SCTP INIT
服务指纹识别	服务与版本检测	内置 62 个 Nmap Service Probes + Rapid7 Recog 指纹，支持 TLS/SSL 证书链分析
操作系统识别	被动 OS 指纹	TTL 分析、TCP 窗口大小、SMB 协商、HTTP Server 头、SSH Banner 综合推断
信息采集	13 个采集插件	NetBIOS / LLMNR / mDNS / UPnP SSDP / SNMP / SMB / SSH / HTTP / FTP / SMTP / Reverse DNS / ARP / OS Fingerprint

高级功能

CVE 漏洞关联: 基于离线 CVE 精简库的服务漏洞风险提示（严重/高危/中危/低危四级）
网络路径追踪: UDP / ICMP / TCP 多协议 Traceroute
服务深度枚举: SMB 共享列表、SNMP 系统信息、数据库（MySQL/PG/MSSQL/Redis/Mongo/ES）版本探测
Docker/K8s 检测: 自动识别容器化和编排平台服务
定时扫描: 内置 Cron 调度器，支持周期性自动化扫描任务
基线管理: 扫描结果标记为基线，后续自动对比变更

桌面 GUI

纯原生界面: 基于 Fyne 工具包，OpenGL/Metal/DirectX 渲染，零 Web 依赖
暗色/亮色主题: 内置专业暗色主题（默认）和亮色主题
多标签结果: 存活主机、端口扫描、统计仪表盘、会话管理
右键上下文菜单: 复制 IP/端口/Banner、浏览器打开 HTTP 服务、SSL 证书查看
自适应布局: 配置面板 30% + 结果区 70%，可拖拽调整
系统托盘: 最小化到托盘，后台持续运行
桌面通知: 扫描完成自动弹出通知

CLI 命令行

scantool-cli alive     # 主机存活探测
scantool-cli portscan  # 端口扫描
scantool-cli fullscan  # 全功能扫描（存活 + 端口 + 指纹）
scantool-cli profile   # 管理扫描配置文件
scantool-cli update    # 更新指纹数据库
scantool-cli version   # 显示版本信息

数据管理

会话保存/加载: 扫描结果持久化存储，支持历史回看
会话对比: 两次扫描结果差异分析（新增/消失/变更）
多格式导出: CSV / JSON / Excel / HTML / Markdown / PDF
扫描 Profile: 内置快速/标准/深度三种预设，支持自定义导入导出
指纹库在线更新: 一键从官方源下载最新指纹，SHA256 校验 + 自动备份

国际化

简体中文（默认）、English 双语言支持
GUI 运行时切换语言（需重启生效）

🖥️ 快速开始

系统要求

操作系统	最低版本	备注
Windows	10 / 11 (64-bit)	SYN 扫描需安装 Npcap
macOS	11+ (Intel / Apple Silicon)	SYN 扫描需 root 权限
Linux	X11 / Wayland	系统托盘需 `libappindicator`；SYN 扫描需 root 或 `CAP_NET_RAW`

下载预编译二进制

从 GitHub Releases 下载对应平台的最新版本：

平台	文件
Windows 64-bit	`NetRadar-windows-amd64.zip`
Linux 64-bit	`NetRadar-linux-amd64.tar.gz`
macOS Intel	`NetRadar-darwin-amd64.tar.gz`
macOS Apple Silicon	`NetRadar-darwin-arm64.tar.gz`

🔧 编译构建

环境准备

# 需要 Go 1.22+
go version

# 克隆项目
git clone https://github.com/BI1IHA/NetRadar.git
cd NetRadar

# 安装依赖
go mod download

编译 CLI（无 GUI 依赖，全平台）

# Windows
GOOS=windows GOARCH=amd64 go build -ldflags="-s -w -X main.Version=1.0.0" -o dist/netradar-cli.exe ./cmd/scantool-cli

# Linux
GOOS=linux GOARCH=amd64 go build -ldflags="-s -w -X main.Version=1.0.0" -o dist/netradar-cli-linux ./cmd/scantool-cli

# macOS Intel
GOOS=darwin GOARCH=amd64 go build -ldflags="-s -w -X main.Version=1.0.0" -o dist/netradar-cli-darwin-amd64 ./cmd/scantool-cli

# macOS Apple Silicon
GOOS=darwin GOARCH=arm64 go build -ldflags="-s -w -X main.Version=1.0.0" -o dist/netradar-cli-darwin-arm64 ./cmd/scantool-cli

编译 GUI（需要 CGO + 平台图形库）

# Windows（需要 GCC + MinGW）
CGO_ENABLED=1 GOOS=windows go build -ldflags="-s -w -H windowsgui -X main.Version=1.0.0" -o dist/netradar.exe ./cmd/scantool

# Linux（需要 X11/Wayland 开发库）
CGO_ENABLED=1 go build -ldflags="-s -w -X main.Version=1.0.0" -o dist/netradar ./cmd/scantool

# macOS（需要 Xcode Command Line Tools）
CGO_ENABLED=1 go build -ldflags="-s -w -X main.Version=1.0.0" -o dist/netradar-darwin ./cmd/scantool

使用 Makefile

make build-cli      # 编译 CLI
make build-gui      # 编译 GUI
make build-all      # 全平台交叉编译 CLI
make test           # 运行测试
make vet            # 代码检查
make release        # 创建发布包

📚 使用指南

GUI 桌面模式

# Windows
.\netradar.exe

# Linux / macOS
./netradar

界面布局:

左侧配置面板: 输入目标 IP/CIDR，选择探测方式和扫描类型，调节速率参数
右侧结果区域: 四个标签页（存活主机、端口扫描、扫描统计、会话管理）
底部状态栏: 进度条、实时扫描速率、已用时间
底部日志面板: 可展开，支持按级别过滤

键盘快捷键:

快捷键	功能
`Ctrl+Enter`	开始扫描
`Escape`	停止扫描
`Ctrl+S`	保存当前会话
`Ctrl+E`	导出结果
`Ctrl+Q`	退出程序
`F5`	更新指纹库

CLI 命令行模式

存活探测

# ICMP Ping（最快速）
netradar-cli alive -t 192.168.1.0/24 -m icmp

# 混合模式（高准确率，推荐）
netradar-cli alive -t 192.168.1.0/24 -m hybrid -o alive.json

# TCP Ping 自定义端口
netradar-cli alive -t 10.0.0.0/16 --tcp-ports 22,80,443,3389 -m tcp

# 排除特定 IP
netradar-cli alive -t 192.168.0.0/16 --exclude 192.168.1.0/24

端口扫描

# Top 1000 端口 TCP SYN 扫描
netradar-cli portscan -t 192.168.1.1 --ports top1000 -s tcp_syn

# 自定义端口范围
netradar-cli portscan -t 192.168.1.0/24 --port-range 80,443,8000-8080,3306,6379

# UDP 扫描（较慢）
netradar-cli portscan -t 192.168.1.1 --ports top100 -s udp

# 全端口扫描
netradar-cli portscan -t 192.168.1.1 --ports all -s tcp_connect

全功能扫描

# 存活探测 + 端口扫描 + 指纹识别
netradar-cli fullscan -t 10.0.0.0/24 --ports top100 -o full_result.json

# 输出为 CSV 格式
netradar-cli fullscan -t 192.168.1.0/24 -o result.csv --output-format csv

# 静默模式 + 管道处理
netradar-cli alive -t 10.0.0.0/24 -o - -q | jq '.[] | .IP'

目标格式

# 单一 IP
192.168.1.1

# CIDR 网段
192.168.1.0/24
10.0.0.0/8
2001:db8::/64

# IP 范围
192.168.1.1-192.168.1.254

# 混合格式（逗号分隔）
192.168.1.1,10.0.0.0/24,172.16.1.1-172.16.1.50

# 从文件导入
-t @targets.txt

📁 项目结构

NetRadar/
├── cmd/
│   ├── scantool/             # GUI 桌面应用入口
│   └── scantool-cli/         # CLI 命令行入口（6 个子命令）
├── internal/
│   ├── engine/
│   │   ├── alive/            # 主机存活探测（ICMP/TCP/UDP/ARP/NDP）
│   │   ├── portscan/         # 端口扫描（10 种方式 + 自适应速率）
│   │   ├── fingerprint/      # 指纹匹配引擎（62 探针 + TLS/HTTP）
│   │   ├── enrich/           # 信息采集插件（13 个）
│   │   └── traceroute/       # 多协议路径追踪
│   ├── config/               # 配置管理 + Profile 系统
│   ├── model/                # 数据模型与类型定义
│   ├── storage/              # 会话持久化 + 对比 diff
│   ├── update/               # 指纹库/应用更新（SHA256 校验）
│   ├── scheduler/            # Cron 定时扫描调度器
│   ├── netutil/              # IP 解析/速率控制/网络工具
│   ├── oui/                  # OUI 厂商数据库（1000+ 条目）
│   ├── cve/                  # CVE 关联查询
│   ├── lock/                 # 界面锁定模式
│   ├── util/                 # 辅助工具（IP 计算/DNS/编码/WHOIS）
│   ├── report/               # 报告生成（PDF/HTML/Markdown）
│   ├── i18n/                 # 国际化（中/英）
│   └── logger/               # 结构化日志（slog）
├── gui/
│   ├── scancontroller.go     # 扫描生命周期管理
│   ├── notify.go             # 桌面通知 + 系统托盘
│   ├── theme/                # 自定义亮/暗主题
│   ├── panels/               # 5 个 UI 面板
│   └── dialogs/              # 9 个对话框
├── assets/                   # 嵌入资源（配置/Profile）
├── fingerprints/             # 嵌入式指纹库
├── build/                    # 构建与打包脚本
├── Makefile                  # 构建/测试/打包
├── config.example.json       # 配置文件示例
└── README.md

统计: 62 个 Go 源文件 · ~29,000 行代码 · 26 个包 · 6 个测试包

⚙️ 配置说明

配置文件位置

操作系统	路径
Windows	`%APPDATA%\scantool\config.json`
macOS	`~/Library/Application Support/scantool/config.json`
Linux	`~/.config/scantool/config.json`

主要配置项

{
  "theme": "dark",              // 主题: dark / light
  "language": "zh-CN",          // 语言: zh-CN / en-US
  "max_concurrency": 1000,      // 全局最大并发连接数
  "default_timeout": 3000000000, // 默认超时（纳秒，3 秒）
  "default_retries": 2,         // 默认重试次数
  "proxy": "",                  // HTTP 代理地址
  "auto_clean_days": 90,        // 历史会话自动清理天数
  "lock_timeout": 1800000000000 // 界面锁定超时（纳秒，30 分钟）
}

完整配置项参见 config.example.json。

扫描 Profile

内置三套预设配置：

Profile	端口范围	探测方式	适用场景
Quick Scan	Top 100	ICMP + TCP	快速网络摸底
Standard Scan	Top 1000	ICMP + TCP + ARP	常规资产盘点
Deep Scan	全端口	全部方法	深度安全评估

🔒 权限说明

功能	Windows	macOS	Linux
TCP Connect 扫描	✅ 标准用户	✅ 标准用户	✅ 标准用户
TCP SYN 扫描	需 Npcap	需 root	需 root / CAP_NET_RAW
ICMP Ping	需管理员	需 root	需 root / CAP_NET_RAW
ARP Ping	需 Npcap	❌ 不支持	需 root
NDP (IPv6)	需 Npcap	需 root	需 root

无特权时自动降级: 若检测到权限不足，自动降级为 TCP Connect 模式，确保基本扫描功能可用。

🏗️ 技术架构

┌──────────────────────────────────────┐
│           GUI 层 (gui/)              │
│      Fyne 原生渲染                   │
│      (OpenGL/Metal/DirectX)          │
└──────────────┬───────────────────────┘
               │ Channel + 回调
┌──────────────▼───────────────────────┐
│        应用逻辑层 (internal/)        │
│  配置 / 调度 / 会话 / 报告           │
└──────────────┬───────────────────────┘
               │
┌──────────────▼───────────────────────┐
│     扫描引擎核心 (engine/)           │
│  存活探测 / 端口扫描 / 指纹匹配      │
│  信息采集 / 路径追踪 / CVE 关联      │
└──────────────┬───────────────────────┘
               │
┌──────────────▼───────────────────────┐
│    数据与指纹库 (assets/ + ~/.config/)│
│  nmap-probes / Recog / OUI / CVE     │
└───────────────────────────────────────┘

关键技术选型

组件	技术	说明
GUI 框架	Fyne v2.5+	跨平台原生渲染，无 Web 依赖
网络包操作	gopacket + pcap + x/net	原始套接字构造与捕获
并发模型	Goroutine + Worker Pool + Token Bucket	精细化速率控制
指纹解析	自研正则状态机	兼容 Nmap probes 全部指令
配置存储	encoding/json + embed	JSON 本地文件 + 编译期嵌入
日志系统	log/slog (Go 1.21+)	结构化日志，支持轮转
CLI 框架	spf13/cobra	子命令路由与参数解析
国际化	golang.org/x/text	中英双语支持

❓ FAQ

Q: 为什么 SYN 扫描提示权限不足？

A: TCP SYN 半开扫描需要构造原始网络包，这需要系统最高权限。Windows 下请安装 Npcap；Linux/macOS 下请使用 sudo 运行。也可以使用 TCP Connect 模式（无需特权）。

Q: 指纹库显示"built-in"，如何在线更新？

A: 工具 → 更新指纹库 → 点击"Update Selected"即可从官方 GitHub 源下载最新指纹库文件。更新前会自动备份当前版本。

Q: 如何进行定时自动扫描？

A: 会话管理 → 定时任务 → 添加任务，设置 Cron 表达式和目标参数即可。例如 0 2 * * 0 表示每周日凌晨 2 点执行。

Q: 如何对比两次扫描结果？

A: 首先完成两次扫描并保存会话。然后在会话管理中选择两个会话 → 点击"对比"，系统会自动计算主机/端口/服务的变化。

Q: macOS 提示"无法验证开发者"怎么办？

A: 在系统设置 → 隐私与安全性中点击"仍要打开"，或使用 xattr -cr /path/to/netradar 命令移除隔离标记。

📜 第三方许可

本工具集成了以下开源组件，用户需遵守各组件的开源协议：

组件	许可协议	用途
Nmap Service Probes	NPSL	服务指纹识别
Rapid7 Recog	BSD-3	HTTP 组件指纹增强
IEEE OUI Database	IEEE Public Data	MAC 地址厂商识别
CVE / NVD Data	MITRE / NIST Public	漏洞关联提示
Fyne GUI Toolkit	BSD-3	跨平台 GUI 框架
gopacket	BSD-3	网络包构造与捕获
Cobra	Apache-2.0	CLI 框架

⚠️ 免责声明

本工具仅供授权的网络安全评估、资产管理和合规检查使用。

使用者有义务确保在合法授权范围内使用本工具
未经授权对网络进行扫描可能违反法律法规
工具作者不对任何滥用行为承担责任
首次启动时需同意授权使用协议方可进入主界面

📄 许可证

本项目采用 MIT License。

👤 作者

刘大硕 (BI1IHA)

_{Built with Go + Fyne | NetRadar}

Folders and files

Latest commit

History

Repository files navigation

NetRadar - Network Asset Discovery & Port Scanner

📖 目录

🚀 功能特性

核心扫描引擎

高级功能

桌面 GUI

CLI 命令行

数据管理

国际化

🖥️ 快速开始

系统要求

下载预编译二进制

🔧 编译构建

环境准备

编译 CLI（无 GUI 依赖，全平台）

编译 GUI（需要 CGO + 平台图形库）

使用 Makefile

📚 使用指南

GUI 桌面模式

CLI 命令行模式

存活探测

端口扫描

全功能扫描

目标格式

📁 项目结构

⚙️ 配置说明

配置文件位置

主要配置项

扫描 Profile

🔒 权限说明

🏗️ 技术架构

关键技术选型

❓ FAQ

📜 第三方许可

⚠️ 免责声明

📄 许可证

👤 作者

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages