道德网络安全审计器 — 超过50项检查覆盖SMB、RDP、LDAP、SSH、Kerberos等，配备AI驱动的CVE分析和OWASP/CIS/NIST合规映射。

快速开始 · 文档 · Docker · AI功能 · 在GitHub上标星

实际运行

_{本地扫描 · 127.0.0.1 · 33个发现 (0C/4H/2M/3L/24I) · 16项检查 · 57.74秒 · .NET 8.0.22}

_{米诺陶主题HTML报告 — 严重性徽章、可展开证据、AI修复建议}

_{JSON报告 — OWASP/CIS/NIST/PCI映射、CVE数据、机器可读}

🎯 什么是Asterion？

Asterion 是一个生产就绪的网络和域安全审计器，以道德为先。专为渗透测试人员、安全研究人员和企业安全团队构建，它结合了传统漏洞扫描与前沿AI分析，为Windows Active Directory、Linux系统和网络基础设施提供可操作的洞察。

为什么选择Asterion？

🔒 设计保证道德：同意令牌系统防止未经授权的扫描
🤖 AI驱动：GPT-4、Claude或本地Ollama提供智能修复指南
📊 专业报告：美观的HTML（米诺陶主题）+ 机器可读JSON
🚀 快速高效：多线程扫描配合智能速率限制
💾 持久追踪：与Argos Suite共享SQLite数据库，记录扫描历史
🐳 Docker就绪：容器化扫描便于CI/CD集成

扫描内容

✨ 功能

🛡️ 核心网络安全扫描```bash

One command, comprehensive network analysis

ast scan --target 10.0.0.0/24 --output html

- **多方法检测**：SMB、RDP、LDAP、Kerberos、SSH、FTP、DNS、SNMP 协议分析
- **多线程**：使用 1-20 个工作线程并发扫描
- **智能速率限制**：可配置的请求限制（1-20 请求/秒），以避免被检测
- **证据收集**：保留 SMB 共享、LDAP 查询、PowerShell 输出

### 🤖 AI 驱动的分析

根据您的需求选择 AI 提供商：

| 提供商             | 最适用于       | 速度           | 成本            | 隐私         |
| -------------------- | -------------- | --------------- | --------------- | ------------- |
| **OpenAI GPT-4**     | 生产质量       | ⚡ 快速（40秒） | 💰 $0.30/扫描   | 🔒 标准       |
| **Anthropic Claude** | 注重隐私       | ⚡ 快速（50秒） | 💰 $0.35/扫描   | 🔒 增强       |
| **Ollama（本地）**   | 完全隐私       | 🐢 慢速（30分钟）| 💰 免费         | 🔐 100% 离线  |

**两种分析模式：**

- **技术模式**：包含 PowerShell/GPO 命令和配置片段的逐步修复方案
- **管理模式**：面向利益相关者和管理的通俗易懂摘要

### 📊 专业报告

**JSON 报告**（机器可读）```json
{
  "tool": "asterion",
  "version": "0.2.0",
  "target": "192.168.1.10",
  "riskScore": 10.0,
  "summary": {
    "critical": 3,
    "high": 8,
    "medium": 16,
    "low": 5,
    "info": 2
  },
  "findings": [
    {
      "id": "AST-SMB-003",
      "title": "SMBv1 protocol enabled (EternalBlue vector)",
      "severity": "high",
      "owasp": { "id": "A06", "name": "Vulnerable and Outdated Components" },
      "vulnerabilities": [
        {
          "cve_id": "CVE-2017-0143",
          "cvss_score": 9.8,
          "cwe_id": "CWE-119"
        }
      ],
      "cvss": 9.8
    }
  ],
  "attackChains": [...],
  "diff": { "refScanId": 41, "new": [...], "fixed": [...], "persisting": [...] }
}

HTML Reports（人类可读）

🎨 米诺陶主题设计（红/橙/紫配色方案）
🏷️ 颜色编码的严重性标记
📝 可展开的证据部分（SMB共享、LDAP查询、PowerShell输出）
🤖 美观排版的AI分析
📱 移动端友好的响应式设计

🔐 同意令牌系统

Asterion通过技术强制实施道德黑客行为。激进扫描和AI分析需要所有权证明：```bash

1. Generate token

ast consent generate --domain corp.local

2. Place token (choose one method)

HTTP: Upload to https://corp.local/.well-known/verify-abc123.txt

DNS: Add TXT record: corp.local = "asterion-verify=verify-abc123"

SSH: Create file /tmp/consent_verify-abc123 with token content

3. Verify ownership

ast consent verify --method http --domain corp.local --token verify-abc123

4. Now you can use aggressive mode

ast scan --target corp.local --mode aggressive --use-ai

### 💾 数据库持久化

与 Argos Suite 共享的 SQLite 数据库跟踪所有内容：

- **扫描历史**：日期、持续时间、发现数量、严重性分类
- **发现仓库**：跨所有 Argos 工具的可搜索漏洞数据库
- **已验证域名**：带有过期时间的同意令牌跟踪
- **趋势分析**：比较不同时间的扫描结果```bash
# Query recent scans (works for all Argos Suite tools)
sqlite3 ~/.argos/argos.db "SELECT * FROM scans WHERE tool='asterion' ORDER BY started_at DESC LIMIT 10"

# Find critical issues
sqlite3 ~/.argos/argos.db "SELECT * FROM v_critical_findings WHERE tool='asterion'"

🚀 快速开始

前提条件

所有平台：

.NET 8.0 SDK（下载）
Python 3.10+（下载）
git（用于克隆仓库）

可选：

Docker（用于容器化扫描）
API 密钥（用于 AI 分析 - OpenAI 或 Anthropic）

安装 — 自动设置（推荐）

Linux / macOS```bash

Clone repository

git clone https://github.com/rodhnin/asterion-network-minotaur.git cd asterion-network-minotaur

Run setup script

chmod +x scripts/setup.py python3 scripts/setup.py

**该脚本将：**

1. ✅ 检查先决条件（.NET、Python）
2. ✅ 安装 Python 依赖项
3. ✅ 设置共享的 Argos Suite 数据库
4. ✅ 以 Release 模式构建 Asterion
5. ✅ 创建目录（~/.asterion, ~/.argos）
6. ✅ 创建包装脚本 `/usr/local/bin/ast`（可选）

#### Windows (PowerShell)```powershell
# Clone repository
git clone https://github.com/rodhnin/asterion-network-minotaur.git
cd asterion-network-minotaur

# Run setup (right-click PowerShell > Run as Administrator)
.\scripts\setup.ps1

该脚本将：

✅ 检查先决条件（.NET、Python）
✅ 安装 Python 依赖项
✅ 设置共享的 Argos Suite 数据库
✅ 以 Release 模式构建 Asterion
✅ 创建目录（%USERPROFILE%.asterion、%USERPROFILE%.argos）

安装 — 手动设置

如果自动化脚本在你的系统上无法工作，请按照以下步骤操作：

第1步：克隆仓库```bash

git clone https://github.com/rodhnin/asterion-network-minotaur.git cd asterion-network-minotaur

#### 步骤 2：安装依赖项

**Linux/macOS:**```bash
pip3 install -r scripts/requirements.txt

Windows（命令提示符）：```cmd pip install -r scripts\requirements.txt

#### 步骤 3: 设置数据库

**Linux/macOS:**```bash
python3 scripts/db_migrate.py

Windows:```cmd python scripts\db_migrate.py

#### 第4步：构建 Asterion

**所有平台：**```bash
dotnet build -c Release

步骤5：创建配置目录

Linux/macOS：```bash mkdir -p ~/.asterion/reports mkdir -p ~/.asterion/consent-proofs mkdir -p ~/.argos

**Windows (PowerShell):**```powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.asterion\reports" | Out-Null
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.asterion\consent-proofs" | Out-Null
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.argos" | Out-Null

步骤 6：（Linux/macOS only）创建全局命令```bash

Create wrapper script

sudo nano /usr/local/bin/ast

Paste this content:

#!/bin/bash exec dotnet "$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/src/Asterion/bin/Release/net8.0/Asterion.dll" "$@"

Make executable

sudo chmod +x /usr/local/bin/ast

#### 步骤 7：配置 API 密钥（可选）

一个单一的环境变量适用于所有人工智能提供商（OpenAI、Anthropic）：

**Linux/macOS：**```bash
export AI_API_KEY="sk-proj-..."   # OpenAI key
# or
export AI_API_KEY="sk-ant-..."    # Anthropic key
# Add to ~/.bashrc or ~/.zshrc to make permanent

Windows (PowerShell):```powershell $env:AI_API_KEY = "sk-proj-..."

Or permanently:

[Environment]::SetEnvironmentVariable("AI_API_KEY", "sk-proj-...", [System.EnvironmentVariableTarget]::User)

#### 步骤 8: 验证安装

**Linux/macOS (如果已创建符号链接):**```bash
ast version

Windows 或直接调用:```cmd .\src\Asterion\bin\Release\net8.0\ast.exe version

Or with dotnet

dotnet .\src\Asterion\bin\Release\net8.0\Asterion.dll version

### 首次扫描

#### 自动扫描本地网络

**Asterion 可以自动发现并扫描你的本地网络！**

**Windows（PowerShell）— 设置完成后（推荐）：**```powershell
# Test on localhost (simple)
ast scan --target localhost --output html

# Scan local subnet with AI analysis
ast scan --target 192.168.1.0/24 --output both --threads 10 --rate 5 --use-ai --ai-tone both

# Domain scan with authentication
ast scan --target corp.local --auth "CORP\admin:Password123" --use-ai

Windows（PowerShell）— 不设置 PATH：```powershell

Scan localhost (full path)

.\src\Asterion\bin\Release\net8.0\ast.exe scan --target localhost --output html --use-ai --ai-tone both

Scan local subnet (full path)

.\src\Asterion\bin\Release\net8.0\ast.exe scan --target 192.168.1.0/24 --output both --threads 10 --rate 5

**Linux/macOS:**```bash
# Scan localhost
ast scan --target localhost \
  --output html \
  --use-ai \
  --ai-tone both

# Scan local subnet (e.g., 192.168.1.0/24)
ast scan --target 192.168.1.0/24 \
  --output both \
  --threads 10 \
  --rate 5

# Scan domain
ast scan --target corp.local \
  --auth "CORP\admin:Password123" \
  --output html \
  --use-ai

输出格式

Asterion 支持三种输出格式，通过 --output 指定：

格式	命令

AI 语气选项

控制 AI 分析结果的展示方式，通过 --ai-tone 指定：

语气	使用场景	输出
technical	安全团队	包含 PowerShell/GPO 命令的逐步修复
non_technical

基本示例

简单网络扫描（无认证）：```bash ast scan --target 10.0.0.0/24

**带有 HTML 报告：**```bash
ast scan --target 192.168.1.0/24 --output html

认证扫描 (Windows 域)：```bash ast scan --target dc01.corp.local
--auth "CORP\Administrator:P@ssw0rd"
--output html

**通过 AI 分析（技术及高管视角）：**```bash
ast scan --target 10.0.0.0/24 \
  --use-ai \
  --ai-tone both \
  --output html

快速扫描（10线程，10请求/秒）：```bash ast scan --target 10.0.0.0/24
--threads 10
--rate 10
--output json

#### 报告位置

**原生安装：**

- 报告：`~/.asterion/reports/`
- 数据库：`~/.argos/argos.db`

**Windows：**

- 报告：`%USERPROFILE%\.asterion\reports\`
- 数据库：`%USERPROFILE%\.argos\argos.db`

**Docker 部署：**

- 报告：`docker/reports/`
- 数据库：`docker/data/argos.db`

**🎉 成功！** 检查报告目录以获取 JSON 和 HTML 输出文件。

---

### 在 Docker 上运行

**自动部署：**```bash
cd docker
./deploy.sh    # Linux/macOS
.\deploy.ps1   # Windows

手动 Docker 部署：```bash

Build and start

docker compose up -d

Run a scan

docker compose exec asterion dotnet /app/ast.dll scan
--target 192.168.1.0/24
--output html

View logs

docker compose logs -f asterion

Stop services

docker compose down

---

## 📘 使用指南

### 命令结构```bash
ast <command> [options]

可用命令：

scan — 运行安全扫描
consent — 管理同意令牌
version — 显示版本信息

扫描命令选项

核心标志

凭证标志

AI 标志

快速参考示例

基本扫描```bash

Scan local subnet (default: JSON output, safe mode)

ast scan --target 192.168.1.0/24

Scan with HTML report

ast scan --target 192.168.1.0/24 --output html

Scan specific IP

ast scan --target 10.0.0.5 --output both

#### 网络目标定位```bash
# CIDR notation
ast scan --target 10.0.0.0/24

# IP range
ast scan --target 192.168.1.10-50

# Domain name
ast scan --target corp.local

# Single host
ast scan --target 192.168.1.1

性能调优```bash

Slow, stealthy scan (3 threads, 2 req/s)

ast scan --target 10.0.0.0/24 --threads 3 --rate 2

Fast scan (15 threads, 15 req/s)

ast scan --target 10.0.0.0/24 --threads 15 --rate 15

Specific ports only

ast scan --target 10.0.0.0/24 --ports 445,3389,22,139

#### Windows 域扫描```bash
# Network + LDAP/Kerberos/AD checks
ast scan --target dc01.corp.local \
  --auth "CORP\Administrator:P@ssw0rd"

# WinRM: remote firewall, registry, services, privesc
ast scan --target 192.168.1.10 \
  --winrm "CORP\admin:P@ssw0rd"

# Full Windows audit: auth + WinRM + AI + HTML
ast scan --target 192.168.1.10 \
  --auth "CORP\admin:P@ssw0rd" \
  --winrm "CORP\admin:P@ssw0rd" \
  --use-ai --ai-tone technical -o both -v

# With NTLM hash (Pass-the-Hash)
ast scan --target 10.0.0.5 \
  --auth-ntlm "admin:aad3b435b51404eeaad3b435b51404ee:8846f7eaee8fb117ad06bdd830b7586c"

# Diff against last scan (track security changes)
ast scan --target 192.168.1.10 --winrm "CORP\admin:P@ssw0rd" --diff last -o both

Linux 系统审计```bash

Remote Linux SSH scan (password)

ast scan --target 10.0.0.25 --ssh "admin:password"

SSH with sudo elevation (for privileged checks)

ast scan --target 10.0.0.25 --ssh "admin:password" --sudo-password "sudopass"

SSH key authentication

ast scan --target 10.0.0.25 --ssh-key "admin:~/.ssh/id_rsa"

Via bastion host

ast scan --target internal.corp.local
--bastion "bastion.corp.local:jumpuser:~/.ssh/bastion_key"
--ssh "admin:password"

Full Linux audit: SSH + sudo + AI + HTML

ast scan --target 10.0.0.25
--ssh "root:toor"
--use-ai --ai-tone technical -o both -v

#### AI驱动的分析```bash
# Technical remediation (default, for security teams)
ast scan --target 10.0.0.5 \
  --ssh "root:pass" \
  --use-ai --ai-tone technical -o html

# Executive summary (for management)
ast scan --target 10.0.0.5 \
  --use-ai --ai-tone non_technical -o html

# Both formats + streaming output
ast scan --target 10.0.0.5 --use-ai --ai-tone both --ai-stream -o both

# Agent mode (NVD CVE lookup tool enabled)
ast scan --target 10.0.0.5 --ssh "root:pass" --use-ai --ai-agent -v

# Compare two models
ast scan --target 10.0.0.5 --use-ai \
  --ai-compare "openai/gpt-4o-mini-2024-07-18,anthropic/claude-3-5-haiku-20241022"

# Enforce cost budget
ast scan --target 10.0.0.5 --winrm "admin:pass" --use-ai --ai-budget 0.05

调试```bash

Verbose output

ast scan --target 10.0.0.5 -v

Verbose + custom timeout

ast scan --target 10.0.0.5 -v --timeout 20

Test connectivity only (timeout 5s)

ast scan --target 10.0.0.5 --timeout 5

### 同意令牌管理

#### 生成同意令牌```bash
ast consent generate --domain corp.local
# Output: Token: verify-a3f9b2c1d8e4f5a6

验证同意（3种方法）

HTTP方法 (将文件放置在Web服务器上):```bash

1. Create file at: https://corp.local/.well-known/verify-a3f9b2c1d8e4f5a6.txt

2. Verify:

ast consent verify
--method http
--domain corp.local
--token verify-a3f9b2c1d8e4f5a6

**DNS 方法** (添加 TXT 记录):```bash
# 1. Add DNS TXT record: corp.local = "asterion-verify=verify-a3f9b2c1d8e4f5a6"
# 2. Verify:
ast consent verify \
  --method dns \
  --domain corp.local \
  --token verify-a3f9b2c1d8e4f5a6

SSH 方法（在系统上创建文件）：```bash

1. Create file: /tmp/consent_verify-a3f9b2c1d8e4f5a6

2. Verify:

ast consent verify
--method ssh
--domain corp.local
--token verify-a3f9b2c1d8e4f5a6
--ssh "user:password"

#### 运行激进模式```bash
# After verifying consent token:
ast scan --target corp.local --mode aggressive

真实世界场景

场景一：快速网络评估```bash

Fast, no-auth scan with HTML report

ast scan --target 192.168.1.0/24 --output html --threads 10 --rate 10

#### 场景 2：完整域审计```bash
# Complete Windows AD assessment with AI analysis
ast scan --target corp.local \
  --auth "CORP\admin:P@ssw0rd" \
  --use-ai \
  --ai-tone both \
  --output both \
  --threads 8 \
  --rate 8

场景3：隐蔽扫描```bash

Slow, careful scan to avoid detection

ast scan --target 10.0.0.0/24
--threads 2
--rate 1
--timeout 20
--output json

#### 场景 4：渗透测试```bash
# Generate consent first
ast consent generate --domain internal.corp

# Place token and verify
ast consent verify --method http --domain internal.corp --token <token>

# Run aggressive assessment
ast scan --target internal.corp \
  --mode aggressive \
  --auth "CORP\pentest:P@ssw0rd" \
  --use-ai \
  --output both

🤖 人工智能驱动分析

Asterion 使用 LangChain 1.0.0，通过 Python 桥接支持多种 AI 提供商，让您根据安全、隐私和预算需求灵活选择。

支持的提供商

OpenAI GPT-4 Turbo

最适合：生产环境

⭐ 质量：优秀 (5/5)
⚡ 速度：约 60–80 秒 (gpt-4o-mini，默认)
💰 成本：每次扫描约 $0.004–0.009 (gpt-4o-mini，约 30 个发现)
🔒 隐私：标准（数据传输加密）```bash export AI_API_KEY="sk-proj-..." # Use AI_API_KEY for all providers

#### Anthropic Claude

**最佳用途：增强隐私**

- ⭐ 质量：优秀 (5/5)
- ⚡ 速度：约50–70秒
- 💰 成本：每次扫描约$0.007–0.015 (claude-3-5-haiku)
- 🔒 隐私：增强 (Anthropic的隐私优先方法)```bash
export AI_API_KEY="sk-ant-..."   # Same variable, Anthropic key format

Ollama（本地模型）

最适合：完全隐私

⭐ 质量：良好 (3/5)
🐢 速度：约30分钟（CPU）或约90秒（GPU）
💰 成本：免费
🔐 隐私：100%离线（数据永不离开你的机器）```bash

Install Ollama: https://ollama.ai

ollama pull llama3.2

### 隐私与安全

**自动清理**
在将数据发送给 AI 提供商之前，Asterion 会自动移除：

- ✅ 同意令牌
- ✅ 域凭据（密码、NTLM 哈希）
- ✅ 个人可识别信息 (PII)
- ✅ 内部 IP 地址（按需）
- ✅ 包含敏感数据的 SMB 共享路径

**仅限主动选择**

- AI 分析需要显式的 `--use-ai` 标志
- 激进扫描需要经过验证的同意令牌
- 您控制哪些提供商可以看到您的数据

**最大隐私保护**
本地使用 Ollama。虽然速度较慢且准确度较低，但您的扫描数据永远不会离开您的机器。

### 切换提供商

**当前方法 (v0.2.0)：** 编辑 `config/defaults.yaml````yaml
ai:
    langchain:
        provider: "ollama" # Changed from "openai"
        model: "llama3.2" # Ollama model
        ollama_base_url: "http://localhost:11434"

即将在 v0.3.0 中推出： 交互式配置菜单（Metasploit 风格）```bash

Future feature

ast --show-options ast --set ai.provider=anthropic ast --save-profile privacy-mode

---

## 🧪 安全测试实验室

**⚠️ 未经书面授权，切勿扫描生产网络！**

使用我们的 Docker 实验室安全地进行练习：

### 设置测试环境```bash
# Navigate to docker directory
cd docker

# Deploy vulnerable network lab
docker-compose -f compose.testing.yml up -d

# Wait for services to start (~60 seconds)
docker-compose -f compose.testing.yml logs -f

# Create vulnerable conditions
docker-compose -f compose.testing.yml exec windows-target powershell -c "Disable-NetFirewallProfile -All"

扫描实验室```bash

Return to project root

cd ..

Run scan against lab network

ast scan --target 172.20.0.0/24 --output html

Try authenticated scan

ast scan --target 172.20.0.2 --auth "LAB\admin:P@ssw0rd123" --output both

Try AI analysis (requires API key)

ast scan --target 172.20.0.0/24 --use-ai --output html

### 清理```bash
cd docker
docker-compose -f compose.testing.yml down -v  # -v removes all data

🔒 伦理与法律

黄金法则

只扫描你拥有或拥有明确书面授权进行测试的系统和网络。

同意执行

Asterion 实现了技术控制以防止滥用：

法律框架

在大多数司法管辖区，未经授权访问计算机系统是非法的：

🇺🇸 美国: 《计算机欺诈与滥用法案》(CFAA)
🇬🇧 英国: 《1990年计算机滥用法案》
🇪🇺 欧盟: 《2013/40/EU指令》
🌍 国际: 各类网络犯罪法律

最佳实践

✅ 获得书面授权后再进行扫描
✅ 清晰界定范围（哪些网络/域名/IP）
✅ 记录所有内容（同意、发现、修复）
✅ 首先使用安全模式建立基线
✅ 负责任地报告发现（协调披露）
❌ 绝不在未经明确许可的情况下利用漏洞（例如，不进行 EternalBlue 利用）
❌ 绝不扫描第三方网络（例如 google.com、microsoft.com）

有关完整的伦理指南，请参阅 docs/ETHICS.md

🐳 Docker 部署

交互式部署脚本（推荐）

Asterion 提供跨平台部署脚本：

Linux/macOS:```bash cd docker ./deploy.sh

**Windows (PowerShell):**```powershell
cd docker
.\deploy.ps1

部署选项：

生产环境 - 部署 Asterion Scanner
停止所有服务
移除所有容器和数据（重置）

手动 Docker 部署

Linux/macOS：```bash cd docker docker compose up -d

Execute scans (note the dotnet wrapper)

docker compose exec asterion dotnet /app/ast.dll scan --target 10.0.0.0/24

View logs

docker compose logs -f asterion

Stop service

docker compose down

**Windows (PowerShell):**```powershell
cd docker
docker compose up -d

# Execute scans (note the dotnet wrapper)
docker compose exec asterion dotnet /app/ast.dll scan --target 10.0.0.0/24

# View logs
docker compose logs -f asterion

# Stop service
docker compose down

持久化数据：

报告：./reports/ → 主机目录 docker/reports/
数据库：./data/argos.db → 主机目录 docker/data/argos.db（共享 Argos Suite 数据库）
日志：./logs/asterion.log → 主机目录 docker/logs/asterion.log

注意： Asterion 通过 ASTERION_IN_DOCKER 环境变量自动检测 Docker 环境。

完整的 Docker 文档（Linux/Windows）请参阅： docker/README.md

📊 理解报告

报告结构

本地安装：``` ~/.asterion/ ├── reports/ │ ├── asterion_report_10_0_0_0_24_20260419_143000.json # Machine-readable │ └── asterion_report_10_0_0_0_24_20260419_143000.html # Human-friendly (Minotaur-themed) └── consent-proofs/ └── corp_local_verify-abc123_20260419.txt

~/.argos/ ├── argos.db # Shared Argos Suite database └── logs/ └── argos.log # Shared log file

**Docker 部署：**```
asterion-network-minotaur/
├── docker/
│   ├── reports/
│   │   ├── asterion_report_10_0_0_0_24_20260419_143000.json
│   │   └── asterion_report_10_0_0_0_24_20260419_143000.html
│   ├── data/
│   │   └── argos.db          # Shared Argos Suite database (Docker)
│   ├── logs/
│   │   └── asterion.log
│   └── workspace/
│       └── consent-proofs/

注意： Docker 环境会通过 ASTERION_IN_DOCKER 环境变量自动检测。

JSON 报告模式```json

{ "tool": "asterion", "version": "0.2.0", "target": "10.0.0.0/24", "date": "2026-04-13T14:30:00Z", "mode": "safe", "summary": { "critical": 12, "high": 8, "medium": 15, "low": 5, "info": 20 }, "findings": [ { "id": "AST-SMB-003", "title": "SMBv1 enabled (EternalBlue vulnerability)", "severity": "critical", "confidence": "high", "description": "SMBv1 is enabled on this system. This protocol is vulnerable to EternalBlue (CVE-2017-0143), a critical remote code execution vulnerability exploited by WannaCry ransomware.", "evidence": { "type": "smb", "value": "SMBv1 negotiated successfully", "context": "Port 445/tcp open, SMB signing not required" }, "recommendation": "URGENT - Disable SMBv1 immediately:\n\nPowerShell:\nDisable-WindowsOptionalFeature -Online -FeatureName SMB1Protocol -NoRestart\n\nGroup Policy:\nComputer Configuration → Administrative Templates → MS Security Guide\n→ Configure SMBv1 client driver startup = Disabled\n→ Configure SMBv1 server = Disabled\n\nVerify:\nGet-SmbServerConfiguration | Select EnableSMB1Protocol", "references": [ "https://docs.microsoft.com/en-us/windows-server/storage/file-server/troubleshoot/detect-enable-and-disable-smbv1-v2-v3", "https://nvd.nist.gov/vuln/detail/CVE-2017-0143" ], "affected_component": "SMB Server" }, { "id": "AST-LDAP-001", "title": "LDAP anonymous bind allowed", "severity": "high", "confidence": "high", "description": "LDAP server allows anonymous bind, permitting unauthenticated enumeration of domain users, groups, and configuration.", "evidence": { "type": "ldap", "value": "Anonymous bind successful to port 389/tcp", "context": "Retrieved domain base DN: DC=corp,DC=local" }, "recommendation": "Disable LDAP anonymous bind:\n\nGroup Policy:\nComputer Configuration → Policies → Windows Settings → Security Settings → Local Policies → Security Options\n→ Network access: Allow anonymous SID/Name translation = Disabled\n→ Network access: Do not allow anonymous enumeration of SAM accounts = Enabled\n→ Network access: Do not allow anonymous enumeration of SAM accounts and shares = Enabled\n\nRegistry:\nreg add "HKLM\SYSTEM\CurrentControlSet\Control\Lsa" /v RestrictAnonymous /t REG_DWORD /d 1 /f", "affected_component": "LDAP Server" }, { "id": "AST-RDP-001", "title": "RDP without Network Level Authentication (NLA)", "severity": "high", "confidence": "high", "description": "Remote Desktop Protocol (RDP) is configured without Network Level Authentication (NLA). This allows unauthenticated attackers to reach the login screen and attempt brute-force attacks.", "evidence": { "type": "rdp", "value": "RDP port 3389/tcp open, NLA not required", "context": "Encryption level: High" }, "recommendation": "Enable Network Level Authentication:\n\nPowerShell:\n(Get-WmiObject -class Win32_TSGeneralSetting -Namespace root\cimv2\terminalservices -Filter "TerminalName='RDP-tcp'").SetUserAuthenticationRequired(1)\n\nGroup Policy:\nComputer Configuration → Administrative Templates → Windows Components → Remote Desktop Services → Remote Desktop Session Host → Security\n→ Require user authentication for remote connections by using Network Level Authentication = Enabled", "affected_component": "RDP Server" } ], "notes": { "scan_duration_seconds": 67.5, "targets_scanned": 12, "rate_limit_applied": true, "scope_limitations": "Scan limited to network services. Local system checks require SSH/WinRM credentials.", "false_positive_disclaimer": "Manual verification recommended for all findings before remediation." }, "aiAnalysis": { "executiveSummary": "The network scan identified 12 critical security vulnerabilities requiring immediate attention...", "technicalRemediation": "### Critical Issues\n\n1. \n - Affected systems: 10.0.0.5, 10.0.0.10\n - Remediation: Disable SMBv1...", "generatedAt": "2026-04-19T14:35:00Z", "modelUsed": "gpt-4o-mini-2024-07-18", "provider": "openai" } }

### HTML 报告功能

- **📊 执行仪表板**：包含严重性计数和 Minotaur 品牌标识的摘要卡片
- **🤖 AI 分析**：可展开的执行层和技术洞察部分
- **🔍 详细发现**：按严重性组织，包含 PowerShell/GPO 修复命令
- **📋 证据**：SMB 共享、LDAP 查询、RDP 配置、PowerShell 输出
- **🔗 外部参考**：CVE、Microsoft 文档、OWASP 指南的链接
- **📱 移动端响应式**：适用于所有设备
- **🎨 Minotaur 主题**：红/橙/紫色配色方案

---

## 📁 项目结构```
asterion-network-minotaur/
│
├── src/
│   ├── Asterion/                     # Main C# application
│   │   ├── Asterion.csproj           # .NET project file
│   │   │
│   │   ├── Checks/                   # Security check modules
│   │   │   ├── ICheck.cs             # Check interface
│   │   │   ├── BaseCheck.cs          # Abstract base class (350 lines)
│   │   │   ├── CheckCategory.cs      # Check category enum
│   │   │   │
│   │   │   ├── CrossPlatform/        # Network service scanners (work from any OS)
│   │   │   │   ├── PortScanner.cs    # TCP port scanning
│   │   │   │   ├── SmbScanner.cs     # SMB/CIFS security (42KB)
│   │   │   │   ├── RdpScanner.cs     # RDP configuration (24KB)
│   │   │   │   ├── LdapScanner.cs    # LDAP/AD security (38KB)
│   │   │   │   ├── KerberosScanner.cs # Kerberos security (22KB)
│   │   │   │   ├── SnmpScanner.cs    # SNMP vulnerabilities (21KB)
│   │   │   │   ├── DnsScanner.cs     # DNS misconfigurations (14KB)
│   │   │   │   ├── FtpScanner.cs     # FTP security (27KB)
│   │   │   │   ├── TlsScanner.cs     # TLS/SSL certificate checks
│   │   │   │   ├── SysvolCheck.cs    # SYSVOL/GPP password exposure
│   │   │   │   ├── AdAggressiveCheck.cs # AS-REP roasting, delegation, weak ACLs
│   │   │   │   └── WinRmChecks.cs    # Remote Windows audit via WS-Man
│   │   │   │
│   │   │   ├── Windows/              # Local Windows system checks
│   │   │   │   ├── WinFirewallCheck.cs # Firewall configuration
│   │   │   │   ├── WinRegistryCheck.cs # Registry security
│   │   │   │   ├── AdPolicyCheck.cs    # Active Directory policies
│   │   │   │   ├── WinServicesCheck.cs # Service misconfigurations
│   │   │   │   └── PrivEscCheckWin.cs  # Windows privilege escalation
│   │   │   │
│   │   │   └── Linux/                # Local/remote Linux checks (via SSH)
│   │   │       ├── LinuxFirewallCheck.cs # iptables/nftables/ufw
│   │   │       ├── SshConfigCheck.cs     # SSH hardening
│   │   │       ├── SambaNfsCheck.cs      # Samba/NFS security
│   │   │       └── PrivEscCheckLinux.cs  # SUID, sudo misconfig
│   │   │
│   │   ├── Core/                     # Core infrastructure
│   │   │   ├── Orchestrator.cs       # Main execution engine (1,243 lines)
│   │   │   ├── Config.cs             # YAML configuration loader
│   │   │   ├── ScanOptions.cs        # Scan configuration
│   │   │   ├── Database.cs           # SQLite operations
│   │   │   ├── ConsentValidator.cs   # Consent token verification
│   │   │   ├── SshConnectionManager.cs  # SSH.NET wrapper (password/key/bastion)
│   │   │   ├── WinRmConnectionManager.cs # WS-Man HTTP/NTLM (Linux → Windows)
│   │   │   ├── AttackChainAnalyzer.cs   # Multi-step attack chain correlation
│   │   │   ├── NtlmSpnego.cs         # NTLM/SPNEGO auth implementation
│   │   │   ├── NtlmV2Auth.cs         # NTLMv2 auth implementation
│   │   │   │
│   │   │   ├── Output/
│   │   │   │   └── ReportBuilder.cs  # Report generation (risk score, labels)
│   │   │   │
│   │   │   └── Utils/
│   │   │       ├── NetworkUtils.cs   # Network operations
│   │   │       ├── CidrParser.cs     # CIDR/IP range parsing
│   │   │       ├── AuthenticationManager.cs # Credential handling
│   │   │       └── OsDetector.cs     # Per-target OS detection (SSH/SMB/TTL)
│   │   │
│   │   ├── Models/                   # Data models
│   │   │   ├── Report.cs             # Main report structure
│   │   │   ├── Finding.cs            # Security finding (OWASP/CVE/Compliance)
│   │   │   ├── Evidence.cs           # Finding proof
│   │   │   ├── ConsentInfo.cs        # Consent verification
│   │   │   └── AiAnalysis.cs         # AI-generated content (cost tracking)
│   │   │
│   │   ├── Program.cs                # Application entry point
│   │   └── Cli.cs                    # CLI argument parser (all flags)
│   │
│   └── Asterion.sln                  # Visual Studio solution
│
├── scripts/                          # Python bridge scripts
│   ├── ai_analyzer.py                # LangChain AI integration (stream/agent/compare)
│   ├── cve_lookup.py                 # NVD API v2 CVE enrichment
│   ├── owasp.py                      # OWASP Top 10 mapping (139 entries)
│   ├── compliance.py                 # CIS/NIST/PCI mapping (95 entries)
│   ├── db_migrate.py                 # Database setup
│   ├── render_html.py                # HTML report generation (Jinja2)
│   ├── setup.sh                      # Linux/macOS installation script
│   ├── setup.ps1                     # Windows PowerShell setup
│   └── requirements.txt              # Python dependencies
│
├── config/                           # Configuration files
│   ├── defaults.yaml                 # Default settings
│   └── prompts/                      # AI prompt templates
│       ├── technical.txt             # Technical remediation prompts
│       └── non_technical.txt         # Executive summary prompts
│
├── db/
│   └── migrate.sql                   # Database schema (shared with Argos Suite)
│
├── docker/                           # Docker deployment
│   ├── Dockerfile                    # Production image
│   ├── docker-compose.yml            # Production deployment
│   ├── compose.testing.yml           # Vulnerable lab environment
│   ├── .dockerignore
│   ├── .env.example
│   └── README.md                     # Docker instructions
│
├── docs/                             # Documentation
│   ├── AI_INTEGRATION.md             # AI setup guide
│   ├── CONSENT.md                    # Consent token system
│   ├── DATABASE_GUIDE.md             # SQLite schema and queries
│   ├── ETHICS.md                     # Ethical guidelines
│   ├── NETWORK_CHECKS.md             # Complete check catalog (50+ checks)
│   └── ROADMAP.md                    # Development roadmap
│
├── schema/
│   └── report.schema.json            # Argos Suite unified schema
│
├── templates/
│   └── report.html.j2                # HTML report template (35KB, Minotaur-themed)
│
├── assets/
│   └── ascii.txt                     # Minotaur ASCII art banner
│
├── CHANGELOG.md                      # Version history
├── README_PATTERN.md                 # README visual branding guide
├── LICENSE                           # MIT License
└── README.md                         # This file

统计：

C# 文件总数：约 46 个文件
Python 文件总数：6 个脚本
平台：跨平台（.NET 8.0）
语言：C#（主要），Python（AI 桥梁）

🗺️ 路线图

v0.1.0 — 初始版本 ✅（2025 年 11 月）

✅ 50+ 安全检测（SMB、RDP、LDAP、Kerberos、Windows、Linux）
✅ 基于 AI 的分析（OpenAI、Anthropic、Ollama）
✅ 同意令牌系统（HTTP + DNS + SSH 验证）
✅ JSON + HTML 报告（Minotaur 主题），共享 Argos Suite 数据库
✅ Docker 支持，跨平台（.NET 8.0）

v0.2.0 — 远程系统审计 ✅（2026 年 5 月）

状态： 🎉 已发布

✅ WinRM 远程 Windows 检测：从 Linux/macOS 审计 Windows 服务器（--winrm）
✅ 增强的 SSH：密钥认证、堡垒主机、sudo 提权（--ssh-key、--bastion、--sudo-password）
✅ 操作系统检测：基于目标的检测（SSH 横幅 + SMB/RDP 端口 + TTL）
✅ 激进模式：AS-REP 烤制、委托、弱 ACL、LAPS、AdminCount
✅ TLS 扫描器：过期/自签名证书、TLS 1.0/1.1、弱加密套件
✅ SYSVOL/GPP 检查：组策略首选项密码泄露
✅ 攻击链关联：8 个多步骤向量，附带 MITRE ID
✅ 差异报告：--diff last / --diff <id> — 跟踪安全回归
✅ 多凭据文件：--creds-file credentials.yaml
✅ AI 成本追踪：--ai-budget，成本保存到数据库 + costs.json
✅ AI 流式输出 / 代理模式 / 比较模式：--ai-stream、--ai-agent、

v0.3.0 — 企业功能（2026 年第三季度）

重点： 可用性、规模、交互式 AI

🔜 Metasploit 风格 CLI：交互式配置管理（--show-options、--set）
🔜 数据库 CLI：无需 SQL（ast db scans list、ast db findings search）
🔜 多网络扫描：从文件批量处理
🔜 AI 聊天界面：基于对话的漏洞分析，集成 BloodHound
🔜 CI/CD 集成：GitHub Actions、Jenkins、GitLab 模板
🔜 REST API 服务器：用于自动化的 ASP.NET Core API

v0.4.0 — 情报与自动化（2026 年第四季度）

重点： 自动修复、机器学习检测、分布式扫描

🔜 自动修复：PowerShell DSC + Ansible 剧本生成
🔜 基于机器学习的检测：异常检测、误报减少
🔜 分布式扫描：用于大规模环境的工作节点
🔜 高级 AI 代理：BloodHound 查询生成、攻击路径分析

详细功能描述参见 docs/ROADMAP.md

🤝 贡献

我们欢迎任何形式的贡献！无论是：

🐛 错误报告
💡 功能请求
📝 文档改进
🔧 代码贡献

如何贡献

复刻仓库
创建功能分支（git checkout -b feature/amazing-feature）
进行修改
编写/更新测试（如适用）
提交修改（git commit -m '添加超棒功能'）
推送分支（git push origin feature/amazing-feature）
发起拉取请求

开发环境设置```bash

Clone your fork

git clone https://github.com/YOUR-USERNAME/asterion-network-minotaur.git cd asterion-network-minotaur

Install dependencies

pip install -r scripts/requirements.txt dotnet restore

Build solution

dotnet build

Run with debugging

dotnet run --project src/Asterion -- scan --target 192.168.1.1 -v

### 代码风格

- **C# 格式**：遵循 Microsoft C# 编码约定
- **Python 格式**：我们使用 [Black](https://github.com/psf/black)（行长度：88）
- **XML 文档**：所有公共类/方法都需要
- **代码注释**：使用 `//` 作为行内注释，`///` 用于 XML 文档

### 报告问题

发现 Bug？有功能请求？

**提交 Issue**：https://github.com/rodhnin/asterion-network-minotaur/issues

请包含：

- Asterion 版本（`ast version`）
- .NET 版本（`dotnet --version`）
- Python 版本（`python --version`）
- 操作系统
- 复现步骤（针对 Bug）
- 预期与实际行为

---

## 📚 文档

在 `docs/` 目录中提供全面的文档：

| 文档                                         | 描述                                   |
| -------------------------------------------- | -------------------------------------- |
| [AI_INTEGRATION.md](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/docs/AI_INTEGRATION.md) | 完整的 AI 设置指南（所有 3 个提供商） |
| [CONSENT.md](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/docs/CONSENT.md)               | 同意令牌系统技术细节                   |
| [DATABASE_GUIDE.md](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/docs/DATABASE_GUIDE.md) | SQLite 模式、查询、管理                |
| [ETHICS.md](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/docs/ETHICS.md)                 | 法律框架和道德准则                     |
| [NETWORK_CHECKS.md](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/docs/NETWORK_CHECKS.md) | 50+ 安全检查完整目录                   |
| [ROADMAP.md](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/docs/ROADMAP.md)               | 未来特性与开发计划                     |

### 快速链接

- **更新日志**：[CHANGELOG.md](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/CHANGELOG.md)
- **许可证**：[LICENSE](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/LICENSE)
- **ASCII 艺术**：[assets/ascii.txt](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/assets/ascii.txt)

---

## 🤝 属于 Argos 套件

Asterion 是 **Argos 安全套件** 的第四个组件：

| 工具           | 语言        | 目标                      | 状态       |
| -------------- | ----------- | ------------------------- | ---------- |
| **Argus**      | Python      | WordPress                 | ✅ 稳定   |
| **Hephaestus** | Python      | 服务器（Linux/Windows）   | ✅ 稳定   |
| **Pythia**     | Python      | SQL 注入                  | ✅ 稳定   |
| **Asterion**   | C# + Python | 网络/域/AD                | 🎉 已发布 |

**共享基础设施：**

- SQLite 数据库（`~/.argos/argos.db`）
- 统一 JSON 报告模式
- 同意令牌系统
- 通过 LangChain 进行 AI 分析

---

## ⚖️ 许可证

本项目采用 **MIT 许可证** 授权 - 详见 [LICENSE](https://github.com/rodhnin/asterion-network-minotaur/blob/HEAD/LICENSE) 文件。```
MIT License

Copyright (c) 2025-2026 Rodney Dhavid Jimenez Chacin

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

⚠️ 免责声明

重要提示： 此工具仅用于 授权的安全测试。

法律声明

使用 Asterion，即表示您确认并同意：

✅ 您将 仅扫描您拥有 或 已获得明确书面授权 的网络/系统
✅ 您将 遵守所有适用法律 和法规
✅ 您理解 未经授权的访问是非法的（CFAA、计算机滥用法案等）
✅ 作者和贡献者 对滥用不承担任何责任
✅ 本软件 “按原样”提供，不提供任何形式的担保

负责任的披露

如果您使用 Asterion 发现漏洞：

📧 首先私下联系网络/系统所有者
⏰ 给予合理的修复时间（通常为 90 天）
🤝 协调披露时间表
📝 专业记录您的发现

如有疑问

不要扫描。 如果您不确定自己是否有权限，很可能没有。

🙏 致谢

Asterion 站在巨人的肩膀上：

Microsoft — .NET 平台与安全文档
BloodHound — AD 安全研究与攻击路径分析
OWASP — 安全标准（Top 10、测试指南、ASVS）
SMBLibrary — Tal Aloni 的纯 C# SMB 实现
SSH.NET — 适用于 .NET 的 SSH 协议实现
DnsClient.NET — Michael Conrad 的 DNS 客户端库
LangChain — 驱动智能分析的 AI 框架
Anthropic & OpenAI — 用于漏洞分析的 AI 模型
Ollama — 注重隐私的本地 AI 推理扫描

特别感谢所有实践并倡导道德黑客的安全研究人员。

👤 作者

Rodney Dhavid Jimenez Chacin (rodhnin)

🌐 网站与联系方式： rodhnin.com
💼 GitHub： @rodhnin
🐦 Twitter： @rodhnin

如有问题、反馈或合作咨询，请访问 rodhnin.com

💬 社区

讨论： GitHub Discussions
问题： GitHub Issues
发布： GitHub Releases

为全球安全专业人士和企业网络管理员精心打造 ❤️

⭐ 如果觉得有用，请为本仓库加星！ ⭐

报告 Bug • 请求功能 • 文档

🐂 Asterion — 穿越网络迷宫 🐂

Asterion v0.2.0 — 2026年5月

由 rodhnin 倾心打造 ❤️ | 属于 Argos 安全套件的一部分

SMB/CIFS安全	匿名共享、SMB签名、SMBv1（永恒之蓝）、NTLMv1、可写共享
RDP安全	网络级身份验证（NLA）、加密级别、暴露的RDP
LDAP/Active Directory	匿名绑定、LDAP签名、密码策略、Kerberos预认证
Kerberos安全	AS-REP roasting、Kerberoasting、过长的票据生命周期
SNMP	默认社区字符串、SNMPv1/v2c、写访问
DNS/NetBIOS	区域传输（AXFR）、LLMNR/NetBIOS投毒、mDNS
Windows系统	防火墙、注册表（UAC、LSA）、服务、权限提升
Linux系统	iptables/nftables、SSH、Samba/NFS、SUID二进制文件、sudo错误配置

JSON	`--output json`	机器可读报告（默认）
HTML	`--output html`	漂亮的 Minotaur 主题报告
同时	`--output both`	同时生成 JSON 和 HTML

`--target, -t`	IP/CIDR/domain	必需	目标：`192.168.1.0/24`，`10.0.0.1`，`corp.local`，逗号分隔列表
`--mode, -m`	safe, aggressive	`safe`	扫描模式（aggressive 模式需要同意令牌）
`--output, -o`	json, html, both	`json`	输出格式
`--ports, -p`	端口列表	自动检测	要扫描的端口（例如 `22,80,443` 或 `8000-9000`）
`--threads`	1-20	5	并发线程数
`--rate`	1-20	5	请求速率限制（req/s）
`--timeout`	秒	10	连接超时时间
`--verify-ssl`	标志	true	验证 SSL/TLS 证书（自签名证书请禁用）
`--verbose, -v`	标志	false	启用详细日志记录
`--diff`	last / scan_id	-	与之前的扫描进行比较（`--diff last` 或 `--diff 42`）
`--creds-file`	YAML 文件路径	-	从 YAML 文件加载所有凭据

`--auth`	`DOMAIN\user:pass`	用于 LDAP/Kerberos/SMB/AD 检查的域凭据
`--auth-ntlm`	`user:hash`	传递哈希 NTLM 认证
`--kerberos`	`user:pass@REALM`	Kerberos 凭据
`--winrm`	`DOMAIN\user:pass`	WinRM 远程 Windows 检查（防火墙、注册表、服务、AD）
`--ssh`	`user:pass`	用于远程 Linux 检查的 SSH 密码认证
`--ssh-key`	`user:/path/key`	基于 SSH 密钥的认证
`--sudo-password`	`pass`	用于 Linux 特权检查的 sudo 提权密码
`--bastion`	`host:user:key`	用于多跳 SSH 的跳板/堡垒主机

安全模式	非侵入式网络检查	❌ 否	5 请求/秒
激进模式	深度 AD/系统测试	✅ 是	10 请求/秒
AI 分析	漏洞分析	✅ 是	N/A

`--use-ai`	标志	false	启用 AI 驱动分析
`--ai-tone`	technical, non_technical, both	technical	AI 分析格式
`--ai-provider`	openai, anthropic, ollama	openai	AI 提供商
`--ai-model`	模型名称	gpt-4o-mini-2024-07-18	要使用的 AI 模型
`--ai-budget`	USD 金额	-	如果预计成本超过此值则中止 AI
`--ai-stream`	标志	false	实时将 AI 令牌流式输出到 stdout
`--ai-agent`	标志	false	LangChain 代理模式，带有 NVD CVE 查询工具
`--ai-compare`	`prov/model,prov/model`	-	多模型比较

asterion-network-minotaur

最受欢迎

实际运行

🎯 什么是Asterion？

为什么选择Asterion？

扫描内容

✨ 功能

🛡️ 核心网络安全扫描```bash

One command, comprehensive network analysis

🔐 同意令牌系统

1. Generate token

2. Place token (choose one method)

HTTP: Upload to https://corp.local/.well-known/verify-abc123.txt

DNS: Add TXT record: corp.local = "asterion-verify=verify-abc123"

SSH: Create file /tmp/consent_verify-abc123 with token content

3. Verify ownership

4. Now you can use aggressive mode

🚀 快速开始

前提条件

安装 — 自动设置（推荐）

Linux / macOS```bash

Clone repository

Run setup script

安装 — 手动设置

第1步：克隆仓库```bash

步骤5：创建配置目录

步骤 6：（Linux/macOS only）创建全局命令```bash

Create wrapper script

Paste this content:

Make executable

Or permanently:

Or with dotnet

Scan localhost (full path)

Scan local subnet (full path)

输出格式

AI 语气选项

基本示例

Build and start

Run a scan

View logs

Stop services

扫描命令选项

核心标志

凭证标志

AI 标志

快速参考示例

基本扫描```bash

Scan local subnet (default: JSON output, safe mode)

Scan with HTML report

Scan specific IP

性能调优```bash

Slow, stealthy scan (3 threads, 2 req/s)

Fast scan (15 threads, 15 req/s)

Specific ports only

Linux 系统审计```bash

Remote Linux SSH scan (password)

SSH with sudo elevation (for privileged checks)

SSH key authentication

Via bastion host

Full Linux audit: SSH + sudo + AI + HTML

调试```bash

Verbose output

Verbose + custom timeout

Test connectivity only (timeout 5s)

验证同意（3种方法）

1. Create file at: https://corp.local/.well-known/verify-a3f9b2c1d8e4f5a6.txt

2. Verify:

1. Create file: /tmp/consent_verify-a3f9b2c1d8e4f5a6

2. Verify:

真实世界场景

场景一：快速网络评估```bash

Fast, no-auth scan with HTML report

场景3：隐蔽扫描```bash

Slow, careful scan to avoid detection

🤖 人工智能驱动分析

支持的提供商

OpenAI GPT-4 Turbo

Ollama（本地模型）

Install Ollama: https://ollama.ai

Future feature