BlobRunner - Quickly debug shellcode extracted during malware a

项目说明

![Chat]() ![Support]()

BlobRunner

BlobRunner is a simple tool to quickly debug shellcode extracted during malware analysis.
BlobRunner allocates memory for the target file and jumps to the base (or offset) of the allocated memory. This allows
an analyst to quickly debug into extracted artifacts with minimal o and effort.

!BlobRunner Sample

To use BlobRunner, you can download the compiled executable from the releases page or build your own using the steps below.

Building

Windows

__Build Steps__

- Open Studio Command Prompt
- Na to the directory where BlobRunner is checked out
- Build the executable by running:

#### Building BlobRunner x64

Building the x64 is the same as above, but simply uses the x64 tooling.
- Open x64 Studio Command Prompt
- Na to the directory where BlobRunner is checked out
- Build the executable by running:

Usage

To debug:

- Open BlobRunner in your fa debugger.
- Pass the shellcode file as the first parameter.
- Add a breakpoint before the jump into the shellcode
- Step into the shellcode

Debug into file at a specific offset.

Debug into file and don't pause before the jump. __Warning:__ Ensure you have a breakpoint set before the jump.

#### Just-In-Time (JIT) Debugger

The optional parameter --jit can be used to debug the shell code with the configured Just-In-Time (JIT) debugger.
To trigger the debugger - BlobRunner remo access from the newly allocated memory region. This causes the program to raise
an Access (0xC0000005) exception when attempting to execute the loaded shellcode.

Instructions for configuring the JIT debugger on windows can be found here.
For x64Dbg see setjit or setjitauto.

Example:

Once the debugger is loaded grant executable access to the region. Using x64Dbg you can execute the command setpagerights
using the address returned by BlobRunner.

#### Debugging x64 Shellcode

Inline assembly isn't supported by the x64 compiler, so to support debugging x64 shellcode the loader
creates a suspended thread which allows you to place a breakpoint at the thread entry, before the thread is resumed.

#### Remote Debugging Shell Blobs (IDAPro)

The process is identical to debugging shellcode locally - with the exception that the you need to copy the shellcode file
to the remote system. If the file is copied to the same path you are running _win32_remote.exe_ from, you need to use
the file name for the parameter. Otherwise, you will need to specify the path to the shellcode file on the remote system.

Shellcode Samples

You can quickly generate shellcode samples using the Metasploit tool msfvenom.

Generating a simple Windows exec payload.

Feedback / Help

- Any questions, comments or requests you can find us on twitter: or
- Pull requests welcome!

项目信息

开发语言：C

Star 数：638

技术要点

该项目属于病毒分析方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Quickly debug shellcode extracted during malware analysis展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。