-
Notifications
You must be signed in to change notification settings - Fork 179
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #41 from Vasco0x4/patch-1
Update README_EN.md
- Loading branch information
Showing
1 changed file
with
52 additions
and
16 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,29 +1,65 @@ | ||
## Version update | ||
<p align="center"> | ||
<img src="https://badgen.net/github/stars/INotGreen/XiebroC2/?icon=github&color=black"> | ||
<a href="https://github.com/INotGreen/XiebroC2/releases"><img src="https://img.shields.io/github/downloads/INotGreen/XiebroC2/total?color=blueviolet"></a> | ||
<img src="https://badgen.net/github/issues/INotGreen/XiebroC2"> | ||
<a href="https://github.com/INotGreen/XiebroC2/wiki" style="text-decoration:none;"> | ||
<img src="https://img.shields.io/badge/%E6%96%87%E5%BA%93-wiki-yellow"> | ||
</a> | ||
</p> | ||
|
||
- 2024.2.18 XiebroC2-3.1 released | ||
## Main Features | ||
|
||
- 2024.2.20 XiebroC2-3.1 fixes file management process management | ||
- **Implant**: Written in Golang, compatible with Windows, Linux, and MacOS (support for mobile platforms under consideration for future updates). | ||
- **Teamserver**: Built with .NET 6.0, does not require the .NET Core runtime environment. | ||
- **Controller**: Supports reverse shell, file management, process management, network traffic monitoring, memory loading, reverse proxy (based on the [IOX](https://github.com/EddieIvan01/iox) model), screenshots, process injection and migration, AV/EDR detection, inline PowerShell commands. | ||
- **Memory Operations**: Supports loading PE files into memory on Windows/Linux, process injection and migration, allowing file-free execution. | ||
- **.NET Assemblies**: Execute .NET assemblies in memory (execute-assembly, inline-assembly). | ||
- **Lua Scripting**: Extend command centers and menus through Lua scripts (similar to CNA scripts). | ||
- **Custom RDI Shellcode**: (64-bit only, 32-bit requires manual client compilation) or generate shellcode using [donut](https://github.com/TheWover/donut) or [Godonut](https://github.com/Binject/go-donut). | ||
- **Telegram Integration**: Set up Telegram notifications for host check-ins by modifying the `profile.json` parameters for Chat ID and API Token. | ||
|
||
- 2024.2.29 XiebroC2 update, add Websocket communication protocol, support domain fronting and CDN online, fix several bugs in 3.1 | ||
## Supported Platforms | ||
|
||
- 2024 3.17 add reverse proxy service | ||
**Implant (Session)** | ||
|
||
- 2024.6.16 add Mac client and screenshot, fix Socks5 bug | ||
- **Windows**: Windows 7–11, Windows Server 2008–2022 | ||
- **Linux**: Supports glibc 2.17+ (e.g., Ubuntu, Debian, CentOS) | ||
- **MacOS**: macOS 10.15+ | ||
|
||
- 2024.8.13 fix server memory leak, client UI freeze, flicker and other problems, fix clr execute-assembly version identification problem, now compatible with win7 and win10 loading, improve RunPE, fix process migration injection, fix Linux file download and interactive shell, customize encrypted communication by modifying AES Key in the configuration file, add command prompt, Tab key completion | ||
The project is compiled using Go 1.20 for compatibility. Note that Go 1.20+ does not support Windows 7, Windows Server 2008, and some older Linux systems. The payload in XiebroC2 only supports x64 architecture. For older systems, you must compile the source code with Go versions 1.19–1.16. | ||
|
||
**Teamserver** | ||
|
||
- **Windows**: Windows 8–11, Windows Server 2012–2022 | ||
- **Linux**: Supports glibc 2.17+ systems. | ||
|
||
## Get started | ||
## How to Use | ||
|
||
* [QuickStart](https://github.com/INotGreen/XiebroC2/wiki/QuickStart) | ||
- Download binaries directly from: [Release](https://github.com/INotGreen/XiebroC2/releases) | ||
- Usage Guide: [XiebroC2 Wiki](https://github.com/INotGreen/XiebroC2/wiki) | ||
- Extend penetration testing tools into Lua plugins: [Xiebro-Plugins](https://github.com/INotGreen/Xiebro-Plugins) | ||
|
||
## Module introduction | ||
## Network Topology | ||
|
||
- [ProfileIntroduction](https://github.com/INotGreen/XiebroC2/wiki/ProfileIntroduction) | ||
View network traffic distribution with a visual topology diagram. | ||
|
||
* [Interactive terminal](https://github.com/INotGreen/XiebroC2/wiki/Commands) | ||
* [File management](https://github.com/INotGreen/XiebroC2/wiki/FileManagement) | ||
* [ReverseProxy](https://github.com/INotGreen/XiebroC2/wiki/ReverseProxy) | ||
* [Load lua plugin](https://github.com/INotGreen/XiebroC2/wiki/LoadPlugin) | ||
* [SourceCompile](https://github.com/INotGreen/XiebroC2/wiki/SourceCompile) | ||
 | ||
|
||
## Video Demonstration | ||
|
||
[Demo](https://private-user-images.githubusercontent.com/89376703/305162512-771c2e88-afd8-493d-a575-7e10149837dd.mp4) | ||
|
||
## TODO | ||
|
||
- Develop payloads for PowerShell, VBScript, HTA, JScript, etc. | ||
- Open more forms and API interfaces to facilitate Lua plugin development. | ||
|
||
## Star History | ||
|
||
[](https://star-history.com/#INotGreen/XiebroC2&Date) | ||
|
||
## Disclaimer | ||
|
||
This project is intended solely for educational and research purposes in penetration testing practice. It is currently in a testing phase. It is strictly prohibited to use this tool for any illegal activities, including black market operations or unauthorized penetration attempts. The internet is not a lawless space! By using this tool, you agree to comply with these terms. | ||
|
||
To prevent misuse by malicious actors, the most harmful features have been removed, leaving only basic functions for penetration testing demonstrations. The **Teamserver** and **Controller** components are not open-source. |