Skip to content

快速开始

本页说明构建 Malefic 所需的环境准备。具体构建命令和配置字段参考各组件构建页。

推荐准备方式

推荐直接使用 release 中的 malefic.zip。该离线包已经包含完整源码、vendor 依赖和与源码匹配的 Linux 版 malefic-mutant：

Bash
wget https://github.com/chainreactors/malefic/releases/download/v0.3.0/malefic.zip
unzip malefic.zip
cd malefic/source_code

如果你是开发调试源码，也可以 clone workspace 并拉取 submodules：

Bash
git clone --recurse-submodules https://github.com/chainreactors/malefic
cd malefic
git submodule update --init --recursive

需要把 submodules 同步到各自 master 最新代码时，可以执行：

Bash
git submodule foreach 'git checkout master && git pull'

resources.zip 包含构建时可能用到的预置资源，包括 win-kit 相关产物。自动安装流程会下载资源；手动准备时，从最新 release 下载并解压到 resources/：

Bash
# release page:
# https://github.com/chainreactors/malefic/releases/latest

Docker Build

推荐优先使用 Docker 构建，因为跨 target Rust 构建依赖目标平台对应的 toolchain、linker、SDK 和系统库。ghcr.io/chainreactors/malefic-builder:latest 面向常见 Windows、Linux 和 macOS target triple。

手动编译时进入 source_code/，并使用包内配套的 malefic-mutant：

Bash
docker run \
  -v "$(pwd):/root/src" \
  --rm -it ghcr.io/chainreactors/malefic-builder:latest \
  sh -lc "cd /root/src && chmod +x ./bin/malefic-mutant && ./bin/malefic-mutant generate beacon && ./bin/malefic-mutant build malefic --target x86_64-pc-windows-gnu"

离线包已经包含 vendor 依赖，不需要额外挂载 Cargo cache。如果使用的是 Git clone 源码而不是 release 离线包，才需要根据网络和缓存情况自行决定是否挂载缓存目录。

构建产物位于 target/<target-triple>/release/。

使用源码包内置的 malefic-mutant

malefic-mutant generate 会根据当前源码生成配置、改写 feature 并写入运行时配置文件，因此需要与源码版本匹配。release 离线包中默认路径是 ./bin/malefic-mutant；如果你把二进制放在挂载目录根部，也可以使用 /root/src/malefic-mutant。遇到 RuntimeConfig 字段缺失、schema 不匹配或生成后的 Rust 代码编译失败时，先确认实际执行的是包内配套版本。

如果目标产物需要在 macOS 上运行，首次执行前可能需要清理 quarantine 标记并做本地签名，命令参考 Malefic 构建。

Local Build

本地构建适合开发调试，但需要准备正确的 Rust nightly、target toolchain 和 native linker。

Bash
rustup default nightly-2024-02-03
rustup target add x86_64-pc-windows-gnu
cargo install cargo-zigbuild

Linux 本地交叉构建前，先安装常用 native 依赖：

Bash
sudo apt install -y openssl libssl-dev libudev-dev cmake llvm clang musl-tools build-essential

Windows 上构建 MSVC target 需要 Visual Studio Build Tools；构建 GNU target 需要 MSYS2 MinGW toolchain。

Build Topics