Nyx PowerShell 源码深度剖析:Windows 事件日志清理与内存加固的完整实现原理

原创2026-10-21 15:10:441,961 阅读

Nyx PowerShell 源码深度剖析:Windows 事件日志清理与内存加固的完整实现原理

Nyx 是一款自包含的取证痕迹清理工具,其 Windows 端核心脚本 nyx.ps1 通过 PowerShell 实现事件日志清理、注册表痕迹清除与内存加固,帮助你在 Windows 系统上快速抹除可被逆向追踪的活动轨迹。本文深入剖析 nyx.ps1 中 Windows 事件日志清理与内存加固两大核心功能的实现原理,带你读懂这个 1206 行脚本的设计思路。

Nyx 项目标识图:Windows 事件日志清理与内存加固取证工具

一、Nyx 速览:一个脚本,七大清理模块

Nyx 的命名来自希腊神话中的黑夜女神,寓意"让痕迹在夜色中消失"。它在 Windows 上将清理能力拆分为 7 个模块,在 Invoke-Cleaners 函数中可以看到完整的模块清单与分发逻辑:

模块 清理目标
events Windows 事件日志(Security、System、Sysmon、WinRM、PowerShell 等)
history PowerShell/CMD 历史、Prefetch、Jump Lists
registry 注册表 MRU、USB 历史、BAM/DAM、ShellBags
filesystem USN 日志、回收站、缩略图缓存、SRUM 数据库
temp 临时文件、DNS 缓存、卷影副本、WER 崩溃报告
security EDR/杀毒日志(CrowdStrike、SentinelOne 等)
advanced 证书、计划任务、WiFi/VPN 配置

默认行为是全部执行,也可以通过 -Modules events,temp 只挑选需要的模块运行。模块名校验逻辑(L1034-L1041)采用"白名单 + 快速失败"策略:未知模块名会直接报错退出,避免拼写错误导致静默漏清理。

二、nyx.ps1 整体架构:1206 行脚本如何组织

Nyx Windows 端清理脚本 nyx.ps1 的整体架构示意

上图中的 Nyx 标识对应本仓库的 nyx.ps1 脚本:整个 Windows 端清理能力都封装在这一个文件中,无需依赖任何第三方模块。

参数与全局状态设计

脚本开头的 param 块 定义了全部命令行开关,且每个开关都带单字母别名(-DryRun/-n、-Force/-f、-Advanced/-a),兼顾易用性与可脚本化。值得学习的设计点:

  • 严格模式:Set-StrictMode -Version Latest 在编辑期就能捕获变量拼写错误;
  • 全局计数器:$script:CLEANED_COUNT 与 $script:FAILED_COUNT 让每个模块在成功/失败后累加统计,最终由 Show-Summary 统一输出"共清理 N 项 / 失败 M 项"的汇总报告;
  • 可选审计日志:所有 Print-* 输出函数(L70-L132)在写入 LogFile 时都会附带时间戳,形成完整的操作审计链。

权限检查与确认交互

主流程 Main 的执行顺序是:打印 Banner → 打印不可逆警告 → Check-Privileges 校验管理员权限 → Confirm-Action 二次确认 → 执行清理 → 输出汇总。-DryRun 模式下跳过权限检查,普通用户也能先预览清理范围,这是非常稳妥的"先看后动"设计。

三、Windows 事件日志清理模块深度解析

事件日志是 Windows 取证的第一现场:登录记录、进程启动、PowerShell 执行(4104 事件)都留存在这里。核心实现在 Clean-WindowsEventLogs 函数,共三步。

第 1 步:高效枚举 Administrative 与 Operational 日志

Get-WinEvent -ListLog * |
    Where-Object { $_.LogType -eq 'Administrative' -or $_.LogType -eq 'Operational' }

源码注释里点明了原因:直接调用 wevtutil el 枚举全部日志非常慢,而改用 Get-WinEvent -ListLog * 并按 LogType 过滤(L198-L201)速度更快,同时只保留有取证价值的 Administrative(如 Security、System)和 Operational(如 Sysmon、PowerShell/Operational)日志,跳过了 Analytics 等无关日志。

第 2 步:以 wevtutil cl 为主力清空

拿到日志名列表后,脚本对每个日志名循环执行 wevtutil cl。选择 wevtutil cl 而非 PowerShell cmdlet 的原因在于它对 ETL 格式日志(如 Sysmon)兼容性最好、行为最底层。每次调用都包在独立 try/catch 中,单个日志失败只累加 $script:FAILED_COUNT,不会中断整个清理流程——这种"局部失败隔离"是批量清理类工具的通用工程范式。

第 3 步:Clear-EventLog 兜底保障关键日志

作为双保险,脚本对 Application、System、Security 三大关键日志(L216-L224)额外调用 Clear-EventLog 兜底,防止 wevtutil cl 因权限或句柄问题静默跳过。

Dry-run 模式的处理也很有意思:预演时不真正枚举(枚举本身耗时),而是直接给出近似值 $count = 180(注释说明约为 Win11 的日志数量,L193-L196),让快速预览不被拖慢。

四、内存加固实现原理深度解析

事件日志之外,内存同样是重要取证面:休眠文件会保存关机前的全部物理内存映像,页面文件(pagefile.sys)则长期驻留着被换出的敏感数据。Nyx 的内存加固逻辑位于 Clean-WindowsTempFiles 函数中,且仅在显式传入 -Advanced 参数时才启用(避免默认行为影响用户日常体验)。

禁用休眠:powercfg -h off 删除 hiberfil.sys

powercfg -h off

执行 powercfg -h off 后,Windows 会立即删除 hiberfil.sys。这个文件体积通常与物理内存相当,且完整保存着内存中的凭据、密钥与会话数据,是内存取证的"黄金文件"。删除它等于从根源上切断了"关机后仍可从磁盘恢复内存"的攻击路径。此外,temp 模块还会顺带清除 C:\Windows\MEMORY.DMP 与 Minidump 目录中的崩溃转储(L656-L657),因为蓝屏转储同样是完整的内存镜像。

关机时清空页面文件:ClearPageFileAtShutdown 注册表键

reg add 'HKLM\System\CurrentControlSet\Control\Session Manager\Memory Management' `
    /v ClearPageFileAtShutdown /t REG_DWORD /d 1 /f

该注册表操作将 ClearPageFileAtShutdown 置为 1,效果是:每次关机时系统会用零覆写整个 pagefile.sys。代价是关机时间变长,收益是页面文件中不再残留历史敏感数据。源码注释明确标注了 "requires reboot to take effect"(L681),提醒用户该项加固需要重启后生效。

⚠️ 注意:-Advanced 模式还会通过 vssadmin delete shadows(L630)删除卷影副本与系统还原点,操作不可逆。使用前务必确认重要文件已备份。

五、其他值得借鉴的安全设计

  • 文件操作封装:Safe-Remove 与 Truncate-File 统一处理了存在性检查、Dry-run 分支与异常计数,所有模块复用同一套安全删除语义;
  • 进度可视化:Invoke-Cleaners 在模块级使用 Write-Progress 绘制百分比进度条,长耗时的全量清理不再"黑盒";
  • 双启动入口:仓库还附带了一个两行的 nyx.cmd 启动器,以 powershell -NoLogo -NoProfile -ExecutionPolicy Bypass 方式绕过执行策略限制,方便从 cmd 环境直接调用。

六、快速上手:三步运行

# 1. 先预演,不改动任何内容
.\nyx.ps1 -DryRun

# 2. 只清理事件日志与临时文件
.\nyx.ps1 -Modules events,temp -Force

# 3. 启用内存加固(禁用休眠 + 关机清空页面文件)
.\nyx.ps1 -Advanced -Force -LogFile "nyx-audit.log"

参数说明与更多示例见 Show-Usage 与 Show-Modules 函数,整体用法也可参考项目 README.md。如需获取完整源码:

git clone https://gitcode.com/gh_mirrors/nyx19/nyx

七、如何验证清理效果

仓库的 tests/ 目录内置了基于 Docker + systemd 的完整验证流水线(见 tests/README.md):先由 create-artifacts.sh 注入带 NYX-TEST 标记的"污染痕迹",运行清理器后,再由 verify-cleanup.sh 做严格的"文件必须为 0 字节 / 标记必须消失"断言。虽然这套自动化测试面向 Linux 端(docker-compose.yml),但其"注入 → 清理 → 断言"的三段式验证思路,完全可以照搬到 Windows 环境中手工验证 nyx.ps1 的清理效果。

八、总结

Nyx 的 Windows 端源码展现了单文件 PowerShell 脚本的良好工程范式:

  1. 事件日志清理:Get-WinEvent 高效枚举 + wevtutil cl 主力清空 + Clear-EventLog 兜底,三重设计兼顾速度与可靠性(Clean-WindowsEventLogs);
  2. 内存加固:powercfg -h off 根除 hiberfil.sys、ClearPageFileAtShutdown 关机覆写页面文件,双管齐下封堵内存残留路径(nyx.ps1);
  3. 工程细节:严格模式、失败隔离、Dry-run 预演、审计日志与汇总统计,让"危险操作"变得可控、可审计。

理解这套实现原理后,你既能安全地使用 Nyx,也能从中借鉴批量系统清理工具的设计方法。

登录后查看全文
nyx