Zeek 实战指南:把 pcap 变成可查询的网络证据链
结论先行: Wireshark 解决"这一条流里发生了什么",Suricata 解决"这条流像不像已知攻击",而 Zeek 解决的是**"过去 30 天这个网段发生过什么"——它不做告警,它把流量翻译成结构化日志(连接、DNS、HTTP、TLS、文件、异常),让你用 zeek-cut、awk 或 SIEM 去问问题。所以 Zeek 的部署重点不是"能不能跑起来",而是日志字段设计、会话串联(uid)、以及日志保留与容量**。装完不调策略,你会得到每天几十 GB 的原始流水,查不动也用不上。
本文以 Zeek 9.0 LTS 为例,命令与路径均来自官方文档,可在预演环境直接复现。
1. 版本与安装:先选 LTS 线
Zeek 的版本节奏是"每年一个 LTS、中间若干个特性版":x.0.0 是 LTS,x.y.0(y 大于 0)是特性版。截至 2026 年 10 月:当前 LTS 是 9.0.0(2026-08-21 发布);上一条 LTS 8.0.x 仍在维护(8.0.10,2026-08-19),官方说明会在 9.1 发布后停止更新;特性线为 8.2.x(8.2.2,2026-08-19)。
选型建议很简单:新上生产跟 9.0 LTS;已有 8.0 环境不必立刻升级,但要排进 9.x 的迁移计划。特性版只放验证环境。
官方二进制包通过 openSUSE Build Service 分发,Debian/Ubuntu 系安装流程如下(以 Ubuntu 24.04 为例,其他发行版把路径中的 xUbuntu_24.04 换成对应目录):
echo 'deb https://download.opensuse.org/repositories/security:zeek/xUbuntu_24.04/ /' | sudo tee /etc/apt/sources.list.d/security:zeek.list
curl -fsSL https://download.opensuse.org/repositories/security:zeek/xUbuntu_24.04/Release.key \
| gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/security_zeek.gpg > /dev/null
sudo apt update
sudo apt install zeek-9.0三个要点:
- 二进制包的安装前缀是
/opt/zeek(源码编译默认是/usr/local/zeek),下文用$PREFIX指代。 - 包名分两类:
zeek跟随"最新发布"(当前即 9.0 LTS),zeek-9.0/zeek-8.0固定到具体 LTS 线。固定版本线的包不会跨线自动升级——这正是官方设计意图,避免生产环境被一次apt upgrade带到大版本。 - 装完先补 PATH,否则
zeek: command not found:
export PATH=/opt/zeek/bin:$PATH
echo 'export PATH=/opt/zeek/bin:$PATH' >> ~/.bashrc2. 第一次跑:从 pcap 到日志
Zeek 最基本的用法就是对离线抓包做分析。切到一个空目录再执行,因为日志会直接落在当前工作目录:
mkdir -p ~/zeek-lab && cd ~/zeek-lab
zeek -r /path/to/capture.pcap
ls官方 quickstart 用的示例 pcap 只包含两次 HTTP 请求,因此只生成 conn.log、http.log、weird.log 三份。日志是按流量类型生成的:抓包里没有 DNS 就没有 dns.log,没有 TLS 就没有 ssl.log。所以"日志少"通常不是配置问题,而是流量本身没有覆盖到那些协议。
关键点是 uid。Zeek 为每条连接生成一个唯一标识,conn.log、http.log、dns.log、files.log 里出现的同一个 uid,指的就是同一条连接。这就是"证据链"的物理基础:一条 HTTP 请求可以从 http.log 追到 conn.log 看字节数和持续时间,再追到 files.log 看落地文件的哈希。
weird.log 常被忽略,但它记录的是协议异常——比如非标准 HTTP 方法、畸形头部。官方 quickstart 的例子里,一次 WEIRD 方法的请求就同时出现在 http.log(method: WEIRD)和 weird.log(name: unknown_HTTP_method)中。狩猎时这份日志的信噪比往往比想象中高。
要输出 JSON(便于进 SIEM 或 jq 处理),两种方式:
# 单次运行
zeek -r capture.pcap LogAscii::use_json=T# 长期生效:写进 site/local.zeek
@load policy/tuning/json-logs3. 读懂 TSV:#fields 才是字典
Zeek 默认输出制表符分隔的 TSV,文件头自带元数据:
#separator \x09
#set_separator ,
#empty_field (empty)
#unset_field -
#path conn
#fields ts uid id.orig_h id.orig_p id.resp_h id.resp_p proto service ...
#types time string addr port addr port enum string ...#fields 给出列名,#types 给出类型,- 表示未设置、(empty) 表示空值。任何脚本都不要写死列号,一律按 #fields 解析——Zeek 升级时字段会追加(例如 conn.log 后来新增了 ip_proto),写死列号必炸。
zeek-cut 是官方提供的小工具,按字段名取列,只接受标准输入,不接受文件名参数:
cat conn.log | zeek-cut id.orig_h id.resp_h resp_bytes duration
# 等价写法
zeek-cut id.orig_h id.resp_h resp_bytes duration < conn.log时间字段默认是 epoch,加 -d 转成可读格式,-D 可指定 strftime 格式:
zcat conn.log.gz | zeek-cut -d ts id.orig_h id.resp_h service4. 常用日志速查
| 日志 | 主要用途 | 值得先看的字段 |
|---|---|---|
conn.log | 所有连接的元数据,是其他日志的索引 | uid id.* proto service duration orig_bytes resp_bytes conn_state |
dns.log | 查询与应答,隧道与 DGA 的主战场 | query qtype_name answers rcode_name |
http.log | 方法、Host、URI、UA、状态码 | method host uri user_agent status_code resp_mime_types |
ssl.log | TLS 握手与证书 | server_name version cipher validation_status |
files.log | 传输过的文件与哈希 | fuid mime_type filename md5 sha256 seen_bytes |
notice.log | 策略脚本产生的告警 | note msg src dst |
weird.log | 协议层异常 | name addl |
capture_loss.log | 丢包统计,判断"没日志"还是"没流量" | percent_lost |
conn_state 里,SF 是正常完成,S0 是只发 SYN 无响应(扫描的典型形态),REJ 是被拒绝。只看 S0 的数量就能做粗略的扫描发现,但要先排除 NAT 超时和防火墙静默丢包造成的假阳性。
5. 用 zeekctl 常驻:三行配置跑起来
离线分析只是热身,生产要的是 7×24。zeekctl 随 Zeek 一起安装,改两处配置即可。
第一处,$PREFIX/etc/node.cfg,单机独立模式(文档中的官方示例):
[zeek]
type=standalone
host=localhost
interface=eth0把 eth0 换成实际监听网卡。多网卡或大流量场景再改成 cluster 模式,节点分四类:worker 负责抓包与协议解析,manager 汇总集群状态,proxy 分担脚本与通知处理,logger 负责把各节点的日志流落盘。
第二处,$PREFIX/share/zeek/site/local.zeek——这是站点级脚本,zeekctl 默认加载,且升级不会覆盖,所有自定义都写这里。
然后进交互控制台:
zeekctl
[ZeekControl] > deploy
[ZeekControl] > top
[ZeekControl] > stoptop 会列出各节点 PID、内存与 CPU,等价于集群健康检查。日志不在当前目录,而在 $PREFIX/logs/current;停止后按日期归档到 $PREFIX/logs/YYYY-MM-DD/,并自动 gzip 压缩(weird.11:03:38-11:03:43.log.gz 这种命名)。日志保留策略必须提前定:粗估公式是"连接数 × 每连接产生日志行数 × 单行字节"。千兆满速出口每天几十 GB 并不罕见,按这个量级倒推保留天数与磁盘容量,比事后删日志安全得多。
采集点同样要先想清楚。交换机端口镜像(SPAN)配置简单、零成本,但镜像口在高负载下容易丢包,而且双向流量叠加后可能超过端口带宽;分光器(TAP)通常不丢包、时延稳定,但要断开链路施工、有硬件成本。先量出口峰值带宽,再决定是镜像还是分光——很多"Zeek 抓不全"的根因不在软件,而在镜像口被打满。
还有一条容易被忽略:Zeek 只做解析,不做阻断。它是"证据系统"而不是"防线"。真正要拦的时候,需要把 notice.log 的产出接到防火墙、EDR 或 SOAR 上执行动作,中间这段联动往往才是项目落地的真正工作量。
6. 站点策略:把通用引擎调成你的环境
Zeek 自带大量 policy/ 脚本,按需 @load 即可,不必自己写解析器:
# $PREFIX/share/zeek/site/local.zeek
@load policy/protocols/conn/known-hosts
@load policy/protocols/conn/known-services
@load policy/protocols/ssl/validate-certs
@load policy/protocols/ssh/detect-bruteforcing
@load policy/misc/capture-loss
@load policy/tuning/json-logs需要重点文件留证时再加 @load policy/frameworks/files/extract-all-files——注意它会把流量里的文件全部落盘,磁盘与合规风险要一并评估。有自有情报源时接 @load policy/frameworks/intel/seen,配合 Intelligence Framework 把 IP、域名、文件哈希做成匹配。
known-hosts 与 known-services 的价值在于建立资产基线,但它们不写 notice.log,而是各自产出 known_hosts.log 与 known_services.log:前者记录新出现的内部主机,后者记录新出现的端口与服务。判读时要注意默认行为:Known::enable_hosts_persistence 默认为 F,基线只存在于内存,zeekctl 重启后清零;开启持久化后,条目按 Known::host_store_expiry(默认 1day)过期。也就是说,这两种状态都不是严格的"历史上首次",想判断长期变化得自己拉长窗口比对。
对比绝对"首次",更实用的做法是看变化量:某天 known_services.log 突然多出十几个内部主机的高位端口,这种聚集比单条"首次"信号更有判别力。
7. 三个可直接用的狩猎查询
其一,找长连接(隧道与心跳的共性)。 正常业务连接大多在秒级,持续数小时且流量平稳的连接值得逐个看:
zeek-cut id.orig_h id.resp_h id.resp_p duration orig_bytes resp_bytes < conn.log \
| awk '$4 > 3600 {print}' | sort -k4 -nr | head -30其二,找大流量外传。 按目的地址聚合出站字节,排序看头部:
zeek-cut id.resp_h orig_bytes < conn.log \
| awk '{a[$1]+=$2} END {for (h in a) print a[h], h}' | sort -nr | head -30zeek-cut 只做字段选择,聚合要交给 awk。判读时先扣掉备份、视频会议、云盘同步这几类已知大流量源,剩下的再看目的地址是否陌生。
其三,找 DNS 异常。 先看超长查询名(编码载荷的典型特征),再看重复查询 Top N:
zeek-cut query < dns.log | awk '{print length($0), $0}' | sort -nr | head -20
zeek-cut id.orig_h query < dns.log | sort | uniq -c | sort -nr | head -20后一条命令统计的是"完全相同的主机 + 查询名"出现次数,抓的是固定域名的心跳型回连。DNS 隧道不能靠它发现——隧道往往每次带随机子域,query 值各不相同,必须按时间窗口统计"同一父域下唯一子域数量",那已经需要进 SIEM 或写 Zeek 脚本,不是一两条 shell 能解决的。这一点被很多"一条命令查隧道"的文章带偏了。
8. 五个必踩的坑
- 校验和丢包:本机抓包时,网卡校验和卸载会让 Zeek 丢掉"校验和错误"的包。官方文档明确建议本机监听加
-C忽略校验和:zeek -i eth0 -C。 - 抓包引擎选型:默认
AF_PACKET在高流量下丢包明显,capture_loss.log的percent_lost只要不为 0,所有"没看到"的结论都不成立。上量前先看这份日志。 uid不是包级标识:它是连接级标识,同一条连接里的多次 HTTP 请求共用一个uid,要区分请求得看trans_depth。- 时区:日志里的
ts是 epoch,展示层统一转 UTC+8,别在采集端做本地化,否则跨时区取证会错位。 - 字段别写死:升级后字段可能追加,所有解析逻辑按
#fields走。
9. 参考来源
- Zeek 官方文档:Quick Start Guide(
zeek -r、LogAscii::use_json、node.cfg、local.zeek、zeekctl deploy/top/stop、日志归档路径) - Zeek 官方文档:Installing Zeek(OBS 二进制包、
/opt/zeek前缀、zeek-8.0包名) - Zeek 官方文档:Log Formats(TSV 头部
#separator/#fields/#types、zeek-cut用法与-d/-D) - Zeek 官方博客,《Introducing Zeek 9》(9.0 为当前 LTS,8.0.x 在 9.1 发布后停止更新)
- Zeek GitHub Releases(v9.0.0 于 2026-08-21 发布;v8.0.10 于 2026-08-19 发布)
- Zeek 源码
scripts/policy/protocols/conn/known-hosts.zeek(Known::enable_hosts_persistence、Known::host_store_expiry = 1day、known_hosts.log)
合规提示:本文内容仅限授权环境的流量分析与防御研究使用,抓包与日志留存须遵守所在组织的隐私与合规要求。