Python 3.8 或更高版本
pip（Python 包管理器）

# 克隆仓库
git clone https://github.com/SYLHETYHACKVENGER/HIKRAVEN
cd HIKRAVEN 

# 安装依赖
pip install -r requirements.txt

# 验证安装
python hikraven.py --version

requests>=2.31.0
scapy>=2.5.0
lxml>=4.9.0
cryptography>=41.0.0
colorama>=0.4.6
pyyaml>=6.0
tqdm>=4.66.0
packaging>=23.1
rich>=13.5.0
netifaces>=0.11.0
psutil>=5.9.5

# 数据包捕获可能需要 root 权限
sudo python hikraven.py --interface eth0

# 安装额外依赖
sudo apt-get install python3-scapy

# 以管理员身份运行以进行数据包捕获
python hikraven.py --interface "Ethernet"

# 安装 Npcap 以进行数据包捕获
# 下载地址：https://npcap.com/

# 数据包捕获可能需要 sudo
sudo python hikraven.py --interface en0

# 自动检测接口并扫描本地网络
python hikraven.py --auto-detect

# 扫描特定子网
python hikraven.py --subnet 192.168.1.0/24

# 带报告的完整漏洞扫描
python hikraven.py --interface eth0 --subnet 192.168.1.0/24 --vuln-scan --report html

# 带速率限制的低调扫描
python hikraven.py --interface eth0 --stealth --passive

# 安全漏洞利用测试
python hikraven.py --subnet 192.168.1.0/24 --vuln-scan --exploit

python hikraven.py --list-interfaces

# 无需主动扫描即可发现设备
python hikraven.py --interface wlan0 --passive --verbose

# 使用所有功能进行完整扫描
python hikraven.py --interface eth0 --subnet 10.0.0.0/24 --vuln-scan --report all

# 将报告保存到自定义位置
python hikraven.py --subnet 192.168.1.0/24 --vuln-scan --output /home/user/security-reports

# 高性能扫描
python hikraven.py --subnet 192.168.1.0/24 --threads 200 --timeout 5

# 保守扫描
python hikraven.py --subnet 192.168.1.0/24 --threads 20 --timeout 20 --stealth

# 生成所有报告格式
python hikraven.py --subnet 192.168.1.0/24 --vuln-scan --report all

# 生成特定格式
python hikraven.py --subnet 192.168.1.0/24 --vuln-scan --report html
python hikraven.py --subnet 192.168.1.0/24 --vuln-scan --report json

┌─────────────────────────────────────────────────────────────────┐
│                    HIKRAVEN 架构                                │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐         │
│  │  接口管理    │    │  发现引擎    │    │ 漏洞扫描器   │         │
│  │   Manager   │───▶│   Engine    │───▶│   Scanner   │         │
│  └─────────────┘    └─────────────┘    └─────────────┘         │
│         │                  │                  │                 │
│         ▼                  ▼                  ▼                 │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐         │
│  │    ARP      │    │   被动发现   │    │   CVE       │         │
│  │   嗅探      │    │  Discovery  │    │  检测       │         │
│  └─────────────┘    └─────────────┘    └─────────────┘         │
│                                                                 │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐         │
│  │漏洞利用引擎  │    │  报告生成器  │    │  数据库管理  │         │
│  │   Engine    │───▶│  Generator  │───▶│   Manager   │         │
│  └─────────────┘    └─────────────┘    └─────────────┘         │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    插件系统                              │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

version: 5.1.0
general:
  name: HIKRAVEN
  company: Security Research Team

interface:
  auto_detect: true
  preferred_interface: null
  scan_timeout: 5
  promiscuous: false

scan:
  max_threads: 100
  timeout: 10
  rate_limit: 20
  stealth_mode: false
  max_retries: 3

discovery:
  passive_timeout: 30
  use_arp: true
  use_multicast: true
  use_port_scan: true
  use_ping_scan: true
  ports:
    - 80
    - 443
    - 554
    - 8000
    - 37020
    - 8443
    - 37777
    - 37778

vulnerability:
  enabled: true
  check_default_creds: true
  timeout_per_check: 5
  max_checks_per_device: 20

reporting:
  formats:
    - json
    - html
    - csv
  output_dir: reports
  compress: false

database:
  path: hikraven.db
  encrypt_credentials: true
  max_size_mb: 100

logging:
  level: INFO
  file: hikraven.log
  console_output: true

# plugins/example_plugin.py
class Plugin:
    def pre_scan(self, scan_type, subnet):
        """Execute before scan starts"""
        pass
    
    def post_scan(self, results):
        """Execute after scan completes"""
        pass
    
    def on_device_discovered(self, device):
        """Called when a device is discovered"""
        pass

# Example of programmatic usage
import asyncio
from hikraven import HikRaven

async def custom_scan():
    app = HikRaven()
    app.initialize(interface='eth0')
    results = await app.run_scan(
        scan_type='active',
        subnet='192.168.1.0/24',
        vuln_scan=True
    )
    
    for device in results.devices:
        print(f"{device.ip_address}: {device.get_vulnerability_count()} vulns")
    
    app.generate_reports(['json', 'html'])

asyncio.run(custom_scan())

# .github/workflows/security-scan.yml
name: Security Scan
on: [push]

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run HIKRAVEN
        run: |
          python hikraven.py --subnet 192.168.1.0/24 --vuln-scan --report json
      - name: Upload Reports
        uses: actions/upload-artifact@v3
        with:
          name: security-reports
          path: reports/

# 克隆仓库
git clone https://github.com/SYLHETYHACKVENGER/HIKRAVEN 
cd HIKRAVEN

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 安装开发依赖
pip install -r requirements-dev.txt

# 运行测试
pytest

# 运行 linter
flake8 hikraven.py

HIKRAVEN - 高级海康威视安全评估框架
版权所有 (c) 2024

本软件仅授权用于教育和研究用途。

特此免费授予任何获得本软件及相关文档文件（"软件"）副本的人
在遵守以下条件的前提下，将本软件用于教育和研究目的：

1. 上述版权声明和本许可声明应包含在
   软件的所有副本或实质性部分中。

2. 对本软件的任何使用必须仅用于教育或研究目的。

3. 未经作者事先书面许可，严禁将本软件用于商业用途。

4. 作者不对本软件的任何使用（无论是合法的还是其他方面的）
   承担任何责任。

本软件按"原样"提供，不附带任何明示或暗示的担保，
包括但不限于适销性、特定用途适用性和不侵权保证。
在任何情况下，作者或版权持有人均不对任何索赔、损害或其他
责任负责，无论是合同行为、侵权行为还是其他行为，
无论是因本软件或与本软件相关或与本软件的使用或其他交易
而产生的。