跳到主要内容
中文
← 工具
工具 · 代码仓库

不用上传数据,排查广告间谍软件痕迹

在自己的电脑上,查找通过广告投放的 AdFection / Candiru 间谍软件活动痕迹。Zero Breach 读取本地浏览器记录、文件指纹及支持的 Windows 系统记录,列出发现的证据和未完成的检查,扫描结果留在本机。

@interplains Zero Breach
  • 间谍软件排查
  • 间谍软件
  • 数字取证
  • 隐私
  • 事件响应

前置要求

  • 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 包或管理员权限。

  1. 从 v0.1.8 发布页下载 zero-breach.py、zero-breach.py.asc 和 archivegenocide-signing-key.asc,放在同一个本地文件夹。在该文件夹打开 PowerShell。
  2. 准备 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。

  1. 核对下载文件的 SHA-256:
Get-FileHash zero-breach.py -Algorithm SHA256

v0.1.8 的预期值是 74740af20f609f82dc6e50d66f234d0c39a20f516caa35731c2d19c11684ef44。大小写不影响比对。macOS/Linux 可用 shasum -a 256 zero-breach.py。

  1. 确认 Python 版本,再检查工具版本:
python --version
python -X utf8 zero-breach.py --version

工具应显示 Zero Breach 0.1.8 (single-file build)。签名验证通过、指纹一致,文件版本和校验值也对应后,继续扫描。

先做一次快速检查

  1. 关闭要检查的浏览器,让数据库不再被持续写入或占用。
  2. 留在下载目录,在 PowerShell 执行:
python -X utf8 zero-breach.py --quick
  1. 运行结束后,先找 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 只限制这项额外检查,浏览器、文件指纹和主机检查仍按原范围执行。