HyperDbg Rust

HyperDbg 调试器的 Rust 实现，包含内核驱动和代码生成工具。

项目概述

本项目是 HyperDbg 调试器的 Rust 移植版本，使用 Rust 的内存安全特性来增强内核驱动的可靠性。

目录结构

HyperDbg_rust/
├── cmd/                        # 命令行工具
│   ├── mcp/                    # MCP 服务器 (自动生成)
│   │   └── mcp.go
│   └── rustgen/                # Rust 代码生成器
│       ├── main.go             # 入口
│       ├── rustgen.go          # 类型生成
│       ├── wdkgen.go           # WDK 绑定
│       └── mcpgen.go           # MCP 生成
│
├── debugger/                   # Go 类型定义
│   ├── interfaces.go           # 接口定义
│   ├── types.go                # 类型定义
│   ├── packet.go               # 通信协议
│   └── event_*.go              # 事件类型
│
└── rust-driver/                # Rust 驱动
    └── kd/                     # 主驱动 crate
        ├── Cargo.toml
        ├── build.ps1           # 构建脚本
        └── src/
            ├── lib.rs          # 入口
            ├── generated/      # 自动生成
            ├── go_script/      # Go 脚本引擎
            ├── hyperkd/        # 调试器
            ├── net/            # HTTP 服务器
            └── framework/      # 驱动框架

核心功能

1. Hypervisor (hyperhv)

VMX 操作 (VM Entry/Exit)
EPT 内存虚拟化
Hook 机制 (EPT Hook, Inline Hook)
多处理器支持

2. Debugger (hyperkd)

内核调试
用户态调试
内存读写
断点管理
调用栈追踪

3. 通信层

WSK HTTP Server (端口 50080)
JSON 序列化/反序列化
事件通知机制

4. Go 脚本引擎

Go 语法解析器
Hook 脚本执行
运行时代码生成

构建要求

| 组件 | 版本要求 | |------|---------| | Rust | 1.85+ | | Go | 1.21+ | | WDK | Windows 11 SDK | | EWDK | 最新版本 |

快速开始

1. 生成代码

cd d:\ux\examples\hypedbg\HyperDbg_rust\cmd\rustgen
go run .

2. 检查编译

cd d:\ux\examples\hypedbg\HyperDbg_rust\rust-driver\kd
cargo check

3. 构建驱动

cd d:\ux\examples\hypedbg\HyperDbg_rust\rust-driver\kd
powershell -ExecutionPolicy Bypass -File build.ps1

架构图

┌─────────────────────────────────────────────────────────────────┐
│                      用户空间 (Go)                               │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐             │
│  │   CLI UI    │  │  MCP Server │  │   Client    │             │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘             │
│         │                │                │                     │
│         └────────────────┼────────────────┘                     │
│                          │ HTTP/JSON                            │
└──────────────────────────┼──────────────────────────────────────┘
                           │ :50080
┌──────────────────────────┼──────────────────────────────────────┐
│                      内核空间 (Rust)                             │
│  ┌───────────────────────▼───────────────────────────────────┐  │
│  │                 net (WSK HTTP Server)                     │  │
│  └───────────────────────┬───────────────────────────────────┘  │
│                          │                                      │
│  ┌───────────────────────▼───────────────────────────────────┐  │
│  │              generated (类型 + 处理器)                     │  │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐       │  │
│  │  │ 事件类型    │  │ API 路由器  │  │ Hook 数据库 │       │  │
│  │  └─────────────┘  └─────────────┘  └─────────────┘       │  │
│  └───────────────────────┬───────────────────────────────────┘  │
│                          │                                      │
│  ┌───────────────────────▼───────────────────────────────────┐  │
│  │                    hyperkd (调试器)                       │  │
│  │  ┌─────────────────────────────────────────────────────┐ │  │
│  │  │                 hyperhv (Hypervisor)                │ │  │
│  │  │  ┌──────────┐  ┌──────────┐  ┌──────────┐          │ │  │
│  │  │  │   VMX    │  │   EPT    │  │  Hooks   │          │ │  │
│  │  │  └──────────┘  └──────────┘  └──────────┘          │ │  │
│  │  └─────────────────────────────────────────────────────┘ │  │
│  └───────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

文档

SKILL.md - 开发技能指南
rust-driver/README.md - 驱动说明
rust-driver/kd/IMPLEMENTATION_STATUS.md - 实现状态

许可证

GPL-3.0

Gui

Install / Use

README