# exe-analyzer

**Repository Path**: shgm/exe-analyzer

## Basic Information

- **Project Name**: exe-analyzer
- **Description**: No description available
- **Primary Language**: Python
- **License**: AFL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-04
- **Last Updated**: 2025-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## exe analyzer
一款64位Exe程序动态追踪执行流程以及保存信息的工具

演示以及讲解视频：https://www.bilibili.com/video/BV1VdSHYUE4Q/

### 安装
程序分为三部分

1. exe-analyzer: 调试跟踪工具
2. exe-analyzer-be: 流程图生成以及模拟执行，作为后端
3. exe-analyzer-fe: 前端展示流程图，以及调试信息

#### exe-analyzer
无安装过程使用即可，这里附带了vcruntime的环境，防止部分机器没有vc环境

#### exe-analyzer-be
这里使用conda生成的python 3.12.7，具体安装过程在exe-analyzer-be中有命令介绍

#### exe-analyzer-fe
使用的nodejs v18.20.4，具体安装过程在exe-analyzer-fe中有命令介绍

### exe-analyzer使用
```bash
trace exe and analyzer cfg.
Usage:
  exe-analyze.exe [OPTION...]

  -d, --debug arg       debugger, 0 is Windows API Debugger with Start, 1
                        is Windows API Debugger with Additional,2 is VEH
                        Debugger with Additional, VT pls wait a moment.
                        (default: 0)
  -a, --app arg         Application path (for debug mode 0) (default: "")
  -p, --params arg      Application params (for debug mode 0) (default: "")
  -i, --pid arg         App pid (for debug mode 1 and 2). (default: 0)
  -f, --func arg        func (0 is analyzer cfg, 1 is py dbg) (default: 0)
  -s, --start arg       Start offset (for func mode 0), if debug is 0(
                        Windows API Debugger with Start ),then 0 is start
                        from entry point. (default: 0)
  -e, --end arg         End offset (for func mode 0), 0 is stop until
                        process exit. (default: 0)
  -w, --workspace arg   Workspace name (for func mode 0) (default: "")
  -l, --pythonhome arg  Python home path (for func mode 1) (default: "")
  -m, --mainfile arg    Python main file (for func mode 1) (default: "")
  -j, --jsonfile arg    Json file configure (default: "")
  -h, --help            Print help
```

1. `--app`      参数： 指定需要跟踪的exe程序
2. `--pid`		参数： 指定需要跟踪的程序PID
3. `--debug`	参数： 调试方式，具体见参数解析
4. `--params`   参数： exe程序执行的参数字符串
5. `--workspace`参数： 保存的工作空间路径，如果没有将会递归创建
6. `--start`    参数： 追踪的起始偏移地址，0则代表从EOP开始追踪
7. `--end`      参数： 追踪的结束偏移地址，0则代表直到程序退出
8. `--pythonhome`参数：指定python家目录
9. `--mainfile` 参数： 指定需要执行python程序路径
10.`--func`	参数： 指定需要使用功能，0为CFG，1为python引擎
11.`--jsonfile` 参数： 指定需要的解析的json文件，具体格式见config.json，用来代替参数形式传递

程序将会在工作空间存储相关追踪信息，此工作空间需要传递给exe-analyzer-be使用。


## exe-analyzer CFG使用

### exe-analyzer-be使用
```bash
usage: run.py [-h] [-w WORKSPACE]

exe any be.

options:
  -h, --help            show this help message and exit
  -w WORKSPACE, --workspace WORKSPACE
                        work space
```

1. `-w`参数： 指定exe-analyzer创建的工作空间

程序将会在static文件夹下创建svg流程图供exe-analyzer-fe使用，并开启5000端口。

### exe-analyzer-fe使用
```bash
npm run dev
```
启动即可，程序将会监听8080端口。

访问8080端口，即可进行查看以及操作流程图。

双击指令地址，即可查看此条指令处的相关寄存器信息以及内存状态。

灰色填充中的块代表的是系统层的调用，蓝色圈中代表当前程序空间函数，不同的环使用不同颜色标注，为了对抗自定义堆栈类型的操作，所以这里会将一部分的系统层代码进行步入。

![img](resource/1.png)