Build¶

目前支持的架构¶

malefic理论上支持rust能编译的几乎所有平台, 包括各种冷门架构的IoT设备, Android系统, iOS系统等等 (有相关需求可以联系我们定制化适配), 当前支持的架构可参考cross-rust

经过测试的target

x86_64-apple-darwin
aarch64-apple-darwin
x86_64-unknown-linux-musl
i686-unknown-linux-musl
x86_64-pc-windows-msvc
i686-pc-windows-msvc
i686-pc-windows-gnu
x86_64-pc-windows-gnu

Docker编译(推荐)¶

docker自动化编译

rust很复杂，不通过交叉编译的方式几乎无法实现所有架构的适配，所以我们参考了cross-rs/cross的方案，但它并不完美的符合我们的需求：

cross需要宿主机存在一个rust开发环境，编译环境不够干净，虽然这可以通过虚拟机、github action等方式解决
cross对很多操作进行了封装，不够灵活，比如一些动态的变量引入、一些复杂的操作无法方便的实现

因此，我们参考了cross创建了用于维护malefic(即implant)编译的仓库chainreactors/cross-rust. 这个项目提供了一些主流架构的编译环境。

使用前需要先安装docker

在docker中编译特征会更干净，通过volume映射源码，编译完成会在target目录下生成对应的二进制文件。

docker install¶

可参考官网介绍

curl -fsSL https://get.docker.com | sudo bash -s docker

国内安装docker

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

环境准备¶

因为malefic需要用到代码生成, 并鼓励用户修改代码, 因此我们没有将代码打包到docker中, 仅准备了空的编译环境, 通过挂载实现.

git clone¶

git clone --recurse-submodules https://github.com/chainreactors/malefic

注意clone子项目

需要添加--recurse-submodules递归克隆子项目. 如果已经clone也不必担心,git submodule update --init 即可

下载并解压对应的版本resources.zip, 包含了编译需要用到的预编译的malefic-win-kit lib/a库文件.

community的resources随着版本发布时的release发布: https://github.com/chainreactors/malefic/releases/lasest

编译¶

以x86_64-unknown-linux-musl举例, 在malefic的代码目录下执行

# docker bash
# /user/path/malefic/ 
docker run -v "$(pwd):/root/src" --rm -it ghcr.io/chainreactors/x86_64-unknown-linux-musl:nightly-2023-09-18-latest bash
# 通过mutant生成对应的配置
cargo run -p malefic-mutant -- generate beacon
# build对应的bin
cargo build -p malefic --target x86_64-unknown-linux-musl

本地编译¶

由于本地环境的限制，如果需要交叉编译请使用Docker编译. 以x86_64-pc-windows-msvc为例，

下载代码¶

下载源码:

git clone --recurse-submodules https://github.com/chainreactors/malefic

下载对应的版本resources.zip, 包含了编译需要用到的预编译的malefic-win-kit lib/a库文件.

community的resources随着版本发布时的release发布: https://github.com/chainreactors/malefic/releases/lasest:

解压到源码目录下的resrouces文件夹下: 最终结果应该类似这样:

配置环境¶

安装rust

curl https://sh.rustup.rs -sSf | sh

安装toolchain

rustup default nightly-2023-09-18

添加target, 经过的测试的target推荐

rustup target add x86_64-pc-windows-msvc

??? windows配置gnu环境(非必要) 本地手动编译时，我们推荐windows用户使用msys2管理GNU工具链环境, 可通过官网二进制文件直接安装。

在msys2的terminal下执行如下安装可以保证64、32位GNU工具链的正常编译

```
pacman -Syy # 更新包列表
pacman -S --needed mingw-w64-x86_64-gcc
pacman -S --needed mingw-w64-i686-gcc
```

你可自行把msys64添加到环境变量中， 也可通过`notepad $PROFILE`将如下内容添加到powershell配置中，实现在powershell中快速切换`mingw64/32`.

```powershell
function mg {
    param (
        [ValidateSet("32", "64")]
        [string]$arch = "64"
    )

    $basePath = "D:\msys64\mingw" # 此处是你的msys2安装路径
    $env:PATH = "${basePath}${arch}\bin;" + $env:PATH
    Write-Host "Switched to mingw${arch} (bit) toolchain"
}
mg 64
```

切换用法参考下图:

![switch mingw](/wiki/IoM/assets/switch-mingw-in-powershell.png)

生成配置与代码¶

通过mutant生成对应的配置

cargo run -p malefic-mutant -- generate beacon

mutant完整文档

编译malefic¶

项目的配置(config.toml、cargo.toml、makefile.toml..)中提供了一些预设和编译优化选项. 熟悉rust的使用者也可以手动编译，malefic目前使用的rust版本是nightly-2023-09-18.

在进行手动编译前，请更改 beacon 对应的配置项, 关于配置项，请参考 beacon 配置说明

添加对应的目标编译架构,以x86_64-pc-windows-gnu为例

rustup target add x86_64-pc-windows-gnu

指定 target 编译

# mg 64
cargo build --release -p malefic --target x86_64-pc-windows-gnu
# mg 32
cargo build --release -p malefic --target i686-pc-windows-gnu

编译malefic-prelude¶

生成配置

malefic-mutant generate prelude autorun.yaml

cargo build --release -p malefic-prelude --target x86_64-pc-windows-gnu

编译malefic-pulse¶

与手动编译 malefic 相似，但目前 pulse 需要开启 lto 优化，因此需要使用开启了 lto 的配置选项，当然，如果熟悉rust的使用者也可以自行更改

在进行手动编译前，请更改 pulse 对应的配置项, 关于配置项，请参考 pulse 配置说明

malefic-mutant generate pulse

指定 target 编译

# mg 64
cargo build --profile release-lto -p malefic-pulse --target x86_64-pc-windows-gnu
# mg 32
cargo build --profile release-lto -p malefic-pulse --target i686-pc-windows-gnu

生成对应的 malefic-pulse.exe 文件后，您可以使用 objcopy 来进行 shellcode 的转化

objcopy -O binary malefic-pulse.exe malefic-pulse.bin

编译独立modules¶

malefic的windows平台目前支持动态加载module, 因此可以编译单个或者一组module, 然后通过load_module给已上线的implant添加新的功能.

load_module使用文档