不用上传数据,排查广告间谍软件痕迹
在自己的电脑上,查找通过广告投放的 AdFection / Candiru 间谍软件活动痕迹。Zero Breach 读取本地浏览器记录、文件指纹及支持的 Windows 系统记录,列出发现的证据和未完成的检查,扫描结果留在本机。
前置要求
- Python >= 3.8
- Windows / macOS / Linux
概览
你会得到什么
- 对照公开的 AdFection / Candiru 指标检查本机记录,扫描结果不上传,也不需要管理员权限。
- 区分保存的网页引用、连接记录、文件命中和持久化证据,并列出对应位置。
- 可读的摘要、未能执行的检查清单,以及可选的本地 JSON 报告。
适用场景
- 检查自己电脑上留存的记录,寻找这类间谍软件活动的已知指标。
- 保存检查结果及覆盖范围,供后续调查使用。
教程
先看清查什么、结果怎么读
想知道电脑是否留下可疑活动的记录,光看“命中了几个域名”还不够。你还需要知道它出现在哪里,是网页文字、连接记录,还是磁盘上的文件。
Zero Breach 对照公开的 AdFection / Candiru 指标,检查通过广告投放间谍软件的相关痕迹。检查在本机进行,结果不上传,也不修改系统设置。
| 检查对象 | 读取什么 |
|---|---|
| 浏览器 | 历史、Cookie 的域名与时间、缓存、存储及连接记录;支持 Chrome、Edge、Brave、Vivaldi、Chromium 和 Firefox 的常见配置目录 |
| 文件 | 常见用户可写目录中候选文件的 SHA-256 指纹,与已知样本及相关驱动的指纹比对 |
| Windows 系统 | 用户级 COM 注册、DNS 缓存及日志状态、hosts 和已知固定文件路径 |
这次先完成快速检查,再补上文件指纹并保存报告。阅读结果时,同时看摘要、证据位置和未检查范围。
下载并核验单文件工具
下面以 Windows PowerShell、Python 3.8 或更新版本为主线。macOS/Linux 也能运行,把后面扫描命令中的 python 换成 python3;Windows 系统记录检查只在 Windows 执行。默认检查不需要额外 Python 包或管理员权限。
- 从 v0.1.8 发布页下载
zero-breach.py、zero-breach.py.asc和archivegenocide-signing-key.asc,放在同一个本地文件夹。在该文件夹打开 PowerShell。 - 准备 GnuPG 的
gpg命令。Windows 可使用发布者核验页链接的 Gpg4win。确认gpg可用后,显示下载公钥的指纹:
gpg --show-keys --with-fingerprint archivegenocide-signing-key.asc
对照发布者核验页,确认完整指纹是 C24E C92B 12D6 670A 2516 065F 9B4D 5754 99AF A53C,再导入并验证文件:
gpg --import archivegenocide-signing-key.asc
gpg --verify zero-breach.py.asc zero-breach.py
下面是本站核验 v0.1.8 时输出的两行:
gpg: using EDDSA key C24EC92B12D6670A2516065F9B4D575499AFA53C
gpg: Good signature from "Archive Genocide <archive@archivegenocide.com>" [unknown]
Good signature 表示签名验证通过;再核对 using EDDSA key 后的完整指纹与前面一致。完整步骤见 SIGNING.md。
- 核对下载文件的 SHA-256:
Get-FileHash zero-breach.py -Algorithm SHA256
v0.1.8 的预期值是 74740af20f609f82dc6e50d66f234d0c39a20f516caa35731c2d19c11684ef44。大小写不影响比对。macOS/Linux 可用 shasum -a 256 zero-breach.py。
- 确认 Python 版本,再检查工具版本:
python --version
python -X utf8 zero-breach.py --version
工具应显示 Zero Breach 0.1.8 (single-file build)。签名验证通过、指纹一致,文件版本和校验值也对应后,继续扫描。
先做一次快速检查
- 关闭要检查的浏览器,让数据库不再被持续写入或占用。
- 留在下载目录,在 PowerShell 执行:
python -X utf8 zero-breach.py --quick
- 运行结束后,先找
SUMMARY摘要,再看WHAT COULD NOT BE CHECKED,最后读具体发现及位置。
--quick 跳过文件指纹,报告会把这项列为缺口。若 Windows DNS 历史记录未启用,报告也会说明没有可查询的历史;重新运行无法补回从未记录的事件。
若没有命中,先确认工具实际找到了哪些浏览器配置和记录。Opera、Arc、自定义配置目录等不在当前支持范围内;现有缓存和历史也只覆盖仍然留存的数据。
补上文件检查,保存本地报告
去掉 --quick,让默认检查包含文件指纹;用 --json 将报告存到当前目录:
python -X utf8 zero-breach.py --json report.json
终端仍会显示可读报告,并提示写入 JSON 的路径。确认当前文件夹出现 report.json,打开后核对三处:
| 字段 | 用来确认什么 |
|---|---|
timestamp、platform | 确认时间和系统与本次检查一致 |
modules | 各项检查的状态、发现和证据位置 |
verdict.gaps | 哪些检查没有完成,以及原因 |
与快速检查对照:文件指纹这一项应已执行,或给出本次无法执行的具体原因。其他缺口仍需逐项阅读。
命令退出码 0 表示未命中,2 表示有指标命中,1 表示扫描无法初始化。遇到 2 时继续读报告中的证据,不把它当作程序崩溃。
按证据决定下一步
在具体发现中,结合证据类型、指标用途、时间和位置阅读。可以先按下表分类:
| 报告标识 | 怎样理解与继续检查 |
|---|---|
referenced | 域名出现在保存的网页或存储内容中。先查看上下文,可能是一篇介绍该活动的文章 |
dns-record | 本地 DNS 记录中出现域名或地址。解析记录不能单独说明已建立连接 |
contacted | 有连接相关记录。再看它对应广告投放、控制服务器,还是其他已确认与该活动有关的网络设施 |
configured | 本地配置把域名映射到实际地址,查看对应配置及用途 |
on-disk | 文件指纹命中。区分 sample(已知间谍软件样本)与 vuln-driver(被滥用的合法驱动) |
persistence | 找到与指标相关的自动运行注册项,保留完整位置供进一步核查 |
出现已知样本或持久化命中时,先保留报告和证据路径,再联系 Access Now 数字安全援助等专业团队核查。只有网页引用时,先查看保存内容;未命中时,根据报告的覆盖范围决定是否补查。
需要对指定文件增加模式匹配时,再读官方可选检查说明。该模式需要 Python 3.9+ 和固定版本的 YARA-X;--pattern-path 只限制这项额外检查,浏览器、文件指纹和主机检查仍按原范围执行。