Skip to content

Commit

Permalink
Merge pull request #41 from Vasco0x4/patch-1
Browse files Browse the repository at this point in the history
Update README_EN.md
  • Loading branch information
INotGreen authored Dec 5, 2024
2 parents 2a3e2bf + 32335ad commit 08a9d31
Showing 1 changed file with 52 additions and 16 deletions.
68 changes: 52 additions & 16 deletions README_EN.md
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)
![Network Topology](Image/image-20240818150942815.png)

## 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

[![Star History Chart](https://api.star-history.com/svg?repos=INotGreen/XiebroC2&type=Date)](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.

0 comments on commit 08a9d31

Please sign in to comment.