# socket-shellcode

**Repository Path**: JIHAIXUAN/socket-shellcode

## Basic Information

- **Project Name**: socket-shellcode
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-09
- **Last Updated**: 2025-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Shellcode Generator

一个用于生成反向shell shellcode的工具，可以自定义目标IP地址和端口。

## 项目描述

这个工具可以生成针对特定IP地址和端口的反向shell shellcode。生成的shellcode会创建一个socket连接到指定的远程主机，并建立一个简单的通信通道，将从远程主机接收的数据输出到标准输出。

主要特点：
- 自定义目标IP地址和端口
- 生成优化的汇编代码
- 自动编译为可执行文件
- 支持x86_64架构

## 安装要求

- Python 3.x
- GCC编译器
- GNU Make
- Linux操作系统（x86_64架构）

## 安装步骤

1. 克隆仓库到本地：
   ```
   git clone <repository-url>
   cd shellcode-generator
   ```

2. 确保所有文件具有正确的执行权限：
   ```
   chmod +x build/gen.py
   ```

## 使用方法

1. 进入项目目录：
   ```
   cd shellcode-generator
   ```

2. 运行生成脚本，指定目标IP地址和端口：
   ```
   cd build
   python3 gen.py <IP地址> <端口>
   ```

   例如：
   ```
   python3 gen.py 192.168.1.100 4444
   ```

3. 生成的shellcode将保存在当前目录中，并自动编译为可执行文件。

## 项目结构

```
.
├── Readme.md          # 项目说明文档
├── build/
│   ├── config.py      # 配置文件，定义编译器和编译选项
│   ├── gen.py         # 主要生成脚本
│   └── makefile       # 用于编译生成的汇编代码
└── src/
    ├── remote_code_gen.c  # 生成包含IP和端口的汇编代码
    └── shellcode.S        # 基础shellcode汇编模板
```

## 技术细节

### 工作原理

1. `gen.py`脚本接收用户提供的IP地址和端口参数
2. 脚本编译并运行`remote_code_gen.c`程序，生成包含目标IP和端口的汇编代码
3. 生成的代码与`shellcode.S`模板合并，创建完整的shellcode
4. 使用makefile编译生成最终的可执行文件

### 生成的Shellcode功能

生成的shellcode执行以下操作：
1. 创建一个TCP socket
2. 连接到指定的IP地址和端口
3. 从连接读取数据
4. 将接收到的数据写入标准输出
5. 循环继续读取和写入数据

## 许可证

此项目采用 [MIT许可证](LICENSE) - 详情请参阅LICENSE文件。