# ShadowTrace-Nexus

**Repository Path**: mark-jy/st-nexus

## Basic Information

- **Project Name**: ShadowTrace-Nexus
- **Description**: 由MARKJY独立开发的一款基于 Golang 开发的高性能全面网络安全工具基础框架系统-“泇影枢纽”。旨在为网络管理员、安全研究人员和白帽黑客提供一套轻量级、模块化的全面解决方案
- **Primary Language**: Go
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-01-14
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 网络安全, 压测, 渗透, 密码爆破, 轻量化框架

## README

# 🛡️ ShadowTrace-Nexus （泇影网安中枢）
### All-in-One Network Security Audit & Simulation Framework > 多功能合规网络审计与安全模拟框架

## 📖 简介 (Introduction)
ShadowTrace-Nexus 是一款基于 Golang 开发的高性能网络安全审计工具包。旨在为网络管理员、安全研究人员和白帽黑客提供一套轻量级、模块化的解决方案。

本项目集成了资产发现、流量被动分析、Web 性能基准测试以及高并发压力模拟（DOS模拟）等功能，帮助用户快速评估局域网安全状况及服务承载能力。

### ✨ 核心功能 (Features)
    🔍 资产发现 (Discovery): 基于 ARP 和 TCP 扫描技术，快速探测指定网段内的存活主机及其开放端口。

    📡 流量分析 (Traffic Analyzer): 被动监听网卡流量，实时分析协议分布（TCP/UDP/ICMP），检测潜在的异常网络行为。

    ⚡ Web 基准测试 (Benchmark): 对 Web 服务进行并发压力测试，输出 RPS、延迟分布等性能指标。

    🌊 安全模拟 (HTTP-DOS): 模拟高并发 HTTP 洪水攻击（HTTP Flood），用于测试目标系统的抗压能力、熔断机制及防火墙策略。支持优雅停机与实时报告。

    🌍 多语言支持 (i18n): 原生支持中文/英文界面，通过配置文件或参数自动切换。

    ⌨️ 智能补全 (Auto-Completion): 支持 Bash/Zsh/Fish 等 Shell 的命令行参数自动补全。

### 🛠️ 安装与构建 (Installation)
前置要求
    Go 环境: Go **1.20.x** 或更高版本。😁作者使用1.25.5版本进行开发。

    抓包驱动:
        Windows: 需安装 Npcap (安装时请勾选 "Install Npcap in WinPcap API-compatible Mode")。
        Linux: 需安装 libpcap-dev。



### 1. 克隆项目
```bash
git clone https://gitee.com/mark-jy/st-nexus.git
cd st-nexus
```

### 2. 下载依赖
```bash
go mod tidy
```

### 3. 编译项目
```bash
go build -o stn.exe cmd/main/main.go
```
### 🚀 使用指南 (Usage)
工具采用模块化设计，通过 -mode 参数指定运行模式。

#### 1. 资产发现 (Discovery)
    扫描局域网内的存活设备。
#### 2. 流量分析 (Analyzer)
    实时监控网络接口流量。
#### 3. Web 基准测试 (Benchmark)
    测试 Web 服务器的基础性能。
#### 4. 高并发安全模拟 (HTTP-DOS)
    模拟 HTTP 洪水流量以测试系统稳定性。
    支持随时终端模拟查看报告。
#### 5. 高级配置 (Configuration)
    命令行补全
        工具内置了自动补全安装脚本，支持 Tab 键提示参数。
        （呃，但是在Windows下，需要使用Git Bash或Linux Shell才能正常使用，不然会报错。）
    语言设置
        默认根据系统或配置文件自动检测，也可强制指定为中文（cn）或英文（en）。


### 示例：
```bash
# 扫描 192.168.1.0/24 网段
stn.exe -mode discovery -cidr 192.168.1.0/24
# 列出可用网卡
stn.exe -mode list-interfaces
# 如果出现 couldn't load wpcap.dll 错误，请检查是否安装了 Npcap 驱动。
# 若未安装请前往 (https://npcap.com/dist/npcap-1.86.exe) 下载并安装。

# 监听指定网卡 60秒
stn.exe -mode analyze -iface "\Device\NPF_{...}" -duration 60s
# 100并发，总计1000次请求
stn.exe -mode benchmark -url "http://localhost:8080" -c 100 -n 1000
# 5000并发，总计10万次请求，每100次输出一次日志
stn.exe -mode http-dos -url "http://localhost:8080" -c 5000 -n 100000 -batch 100
```


### 安装补全 (需要 Git Bash 或 Linux Shell)
`stn.exe -install`

### 卸载补全
`stn.exe -uninstall`


```bash
stn.exe -mode discovery -lang zh  # 强制中文
stn.exe -mode discovery -lang en  # 强制英文
```


# ⚠️ 免责声明 (Disclaimer)
本项目 (ShadowTrace-Nexus) 仅供 网络安全教育、授权测试及学术研究 使用。

在使用本工具进行扫描或压力测试前，必须获得目标系统所有者的明确书面授权。

作者 (MARKJY) 不对因使用本工具而导致的任何直接或间接后果（包括但不限于服务中断、数据丢失、法律纠纷）承担责任。

请遵守当地法律法规（如《中华人民共和国网络安全法》）。

### 项目维护者 (Project maintainers)
- [MARKJY](https://gitee.com/mark-jy)
<!-- Project maintained by [MARKJY](https://gitee.com/mark-jy) -->