新闻详情

新闻详情

首页 / 资讯中心 / 详情

Zeek 官方文档手册(Book of Zeek)导读:目录结构、版本管理与本地构建指南

发布时间:2026/11/17 22:31:08来源:尧图网络
Zeek 官方文档手册(Book of Zeek)导读:目录结构、版本管理与本地构建指南
网络安全网络IDS【免费下载链接】zeekZeek is a powerful network analysis framework that is much different from the typical IDS you may know.项目地址https://gitcode.com/gh_mirrors/ze/zeek点击查看免费下载本文以 Zeek 官方手册入口页 doc/index.rst 为核心骨架系统梳理 Book of Zeek 的章节组织、面向的读者群体、文档版本管理机制并结合仓库内的 doc/conf.py、doc/README.md 与VERSION文件说明该手册如何在 Zeek 开源仓库中维护、版本化与本地构建。读完本文你将掌握 Zeek 官方文档体系的整体地图、理解 current/lts/master 三档版本的语义差异并能在本地复现与官方一致的文档构建流程。一、Book of Zeek一份面向部署者的社区维护手册doc/index.rst 是 Zeek 官方手册书名Book of Zeek的入口页。该手册的定位在文档开篇即已点明协助 Zeek 社区在自己的环境中落地 Zeekimplementing Zeek in their environments。它并非纯概念性的白皮书而是围绕以下四类实战需求组织内容的操作型手册Zeek 的独特能力介绍与典型 IDS 的差异如何安装 Zeek如何解读 Zeek 默认生成的日志如何按需改造 Zeek。同时该手册强调其志愿者社区贡献属性内容由 Zeek 社区成员共同编写维护这一属性与仓库中 doc/acknowledgements.rst 记录的 30 余位文档贡献者名单Arne Welzel、Vern Paxson、Robin Sommer、Matthias Vallentin 等相互印证——这是一份由社区持续迭代的活文档。手册的读者分层与内容边界入口页通过三个次级章节对读者做了明确分层入门Get Started面向尚未安装 Zeek 的新用户教程Tutorial面向希望跟随交互式教程完成一次完整部署并上手脚本定制的用户参考Reference面向需要查询默认日志格式、脚本语言语法与内置框架细节的进阶用户高级主题Advanced Topics明确面向非普通用户的疑难排障、协议开发与 Zeek 内部机制研究。值得注意的是教程入口页 doc/tutorial/index.rst 特别声明教程不深入讨论第三方内容third-party content以保证教程长期有效对 Zeek 生态扩展感兴趣的用户被引导至 doc/customizations.rst 的 Popular Customizations 一节。这种核心教程自洽、扩展内容外置的设计是理解 Zeek 文档体系分工的关键。二、文档目录树七大章节与三条阅读路径入口页通过 Sphinx 的toctree指令定义手册主干maxdepth: 2表示目录树默认展开到二级标题。七个顶层章节如下章节源文件仓库根相对路径内容定位Get Started入门doc/get-started.rst安装、快速上手、安全注意事项、集群部署、源码编译About Zeek认识 Zeekdoc/about/index.rstZeek 是什么/不是什么、历史沿革、架构、监控理念Tutorial教程doc/tutorial/index.rst从零搭建、调用 Zeek、使用包、zeekctl、日志解读、脚本入门Reference参考doc/reference/index.rst默认日志、Zeek 脚本语言、内置框架速查Customizations定制doc/customizations.rst社区流行扩展GeoIP、Kafka、日志流式化等Advanced Topics高级主题doc/advanced/index.rst排障、部署方案、协议/脚本开发、子组件、Zeek 内部机制Acknowledgements致谢doc/acknowledgements.rst文档贡献者名单三条推荐的阅读路径根据各章节入口的描述可以从三条典型路径进入手册新用户路径Get Started → Tutorial。先通过 doc/get-started.rst 完成安装与首个运行再跟随 doc/tutorial/index.rst 的交互式教程逐步搭建、定制并理解日志。部署运维路径Tutorial → Customizations → Advanced Topics。在基础部署之上通过 doc/customizations.rst 选择社区成熟扩展如 Kafka 日志导出、GeoIP 地理定位、日志流式化再进入 doc/advanced/index.rst 的排障与部署专题。开发扩展路径Reference → Advanced Topics。先在 doc/reference/index.rst 查阅脚本语言与框架参考再进入 doc/advanced/index.rst 下的devel/协议解析器与脚本开发与subcomponentsBroker、Spicy 等子组件章节。三、文档版本管理current / lts / master 三档并存入口页专门用一节Documentation Versioning说明 Zeek 文档的版本策略这是使用在线文档前必读的重要提示入口页以attention警示块强调。版本发布节奏与文档对应关系Zeek 同时发布feature功能版本与long-term supportLTS 长期支持版本两种类型。默认情况下docs.zeek.org 指向最近发布的版本current。文档站点提供三档核心入口档位语义适用场景current最近发布的正式版本大多数用户应以此为默认lts长期支持版本生产环境采用 LTS 版 Zeek 的团队master持续开发中的最新源码开发者、尝鲜者、贡献者站点通常保留每个发布周期中的最后一个版本当前活动中的发布周期LTS 和/或 feature会保留该周期的全部版本但部分旧版本可能在 UI 下拉菜单中被隐藏。入口页还提示Zeek 的完整版本编号方案定义在 Release Cadence 策略中。仓库侧的实际佐证版本号如何进入文档这一版本机制在仓库中有直接实现文档构建配置 doc/conf.py 在构建时读取仓库根目录的VERSION文件并以其内容覆盖 Sphinx 的version与release变量version source try: # Use the actual Zeek version if available with open(../VERSION) as f: version f.readline().strip() except: print(VERSION file is missing) sys.exit(1) release version这意味着文档页面中显示的版本号与 Zeek 源码版本严格同步。本仓库当前VERSION文件内容为9.1.0-dev.146即处于 9.1.0 开发周期。同时conf.py将文档标题设置为Book of Zeek (9.1.0-dev.146)html_title fBook of Zeek ({release})进一步印证入口页中央的Version |release|占位符在构建时会被替换为实际版本号。配套基础设施除conf.py外版本管理还依赖以下仓库内文件协同工作doc/redirects.yml管理旧 URL 的重定向规则由 zeek-aux 仓库的doc-redirects工具消费doc/Makefile提供make构建 HTML、make livehtml借助 sphinx-autobuild 实时预览等构建目标在线托管采用 Read the DocsRTD并通过 subproject 机制让 Broker、Package Manager、Spicy 等子项目的文档共用docs.zeek.org域名详见 doc/README.md 的 Hosting 一节。四、从源码构建 Book of Zeek本地复现官方文档如果你希望像 Zeek 开发者那样在本地构建这套手册仓库给出了完整流程。以下内容基于 doc/README.md 并结合 doc/conf.py 的配置整理。环境依赖依赖说明Python ≥ 3.10构建脚本运行环境SphinxreST 文档引擎sphinx_rtd_themeRead the Docs 主题conf.py中html_theme sphinx_rtd_themeGitPython文档构建辅助sphinx-autobuild可选make livehtml实时预览所需若使用 pip一条命令即可安装全部依赖依赖清单见 doc/requirements.txtpip3 install -r requirements.txt构建 HTML 文档# 在 doc/ 目录下执行 make构建完成后HTML 文档以符号链接形式出现在build/html直接用浏览器打开其中的index.html即可阅读。实时编辑预览make livehtml该目标依赖sphinx-autobuild会在你编辑 reST 源文件时自动重编译并在独立浏览器窗口中实时展示渲染结果——适合为手册贡献内容时使用。构建系统的关键技术点自定义 Sphinx 扩展conf.py加载了ext/目录下的zeek、zeek_pygmentsZeek 脚本语法高亮、spicy-pygmentsSpicy 语法高亮等扩展其中zeek.py提供了手册中大量使用的:zeek:see:指令用于交叉引用 Zeekygen 自动生成的 API 文档。Zeekygen 自动生成文档参考章节中大量脚本级文档主要位于doc/scripts/下或以 autogenerated 开头由 Zeekygen 工具自动生成。其再生成流程是先按 doc/get-started.rst 中的 building-from-source 一节从源码构建 Zeek然后从仓库根目录运行 ci/update-zeekygen-docs.sh../ci/update-zeekygen-docs.sh官方通过 CIgenerate-docs.yml自动维护这些生成文档因此贡献者通常无需手动提交生成文件。需要强调修改自动生成文档应去修改其源文件例如doc/scripts/base/init-bare.zeek.rst对应scripts/base/init-bare.zeek而非直接编辑生成结果。五、从入口页继续深入推荐的第一站入口页本身是导航枢纽结合其指向的各章节内容建议按如下顺序开展阅读先读版本提示确认自己应使用 current、lts 还是 master 档文档对应你部署的 Zeek 版本。再走 Get Starteddoc/get-started.rst 下的 doc/install.rst、doc/quickstart.rst、doc/security-considerations.rst、doc/cluster-setup.rst 与 doc/building-from-source.rst 覆盖了从安装到集群部署的全链路。跟随 Tutorial 上手实操doc/tutorial/index.rst 下的setup、invoking-zeek、using-packages、invoking-zeekctl、logs、scripting/index六个子章节构成了一个可交互跟练的完整上手序列。按需查阅 Reference 与 Advanced日志格式、脚本语法、框架 API 在 doc/reference/index.rst排障与开发在 doc/advanced/index.rst。值得一提的是本手册的文档源码本身就是 Zeek 仓库的一部分阅读时若发现文档与源码不一致可直接对照 doc/ 目录与 scripts/ 目录中的对应实现例如 doc/customizations.rst 中提到的 GeoIP 功能对应源码 src/MMDB.cc 与 src/MMDB.hCommunity ID 功能对应 src/communityid.bif 的community_id_v1内建函数——文档、脚本与 C 实现三者在同一仓库中闭环可查这正是 Zeek 文档体系最独特的工程优势。赞分享网络安全网络IDS【免费下载链接】zeekZeek is a powerful network analysis framework that is much different from the typical IDS you may know.项目地址https://gitcode.com/gh_mirrors/ze/zeek点击查看免费下载相关推荐ScyllaDB 官方文档仓库全指南目录结构、写作规范与本地构建部署ScyllaDB 官方文档仓库全指南目录结构、写作规范与本地构建部署 本篇技术指南聚焦 ScyllaDB 项目仓库中的文档体系完整讲解其两级文档用户文档与数据库分布式数据库后端大数据Zeek 官方文档构建指南从 Sphinx 源码树到 docs.zeek.org 的完整工作流Zeek 官方文档构建指南从 Sphinx 源码树到 docs.zeek.org 的完整工作流 Zeek 的官方文档托管于 docs.zeek.org是一网络安全网络IDSPolybar 官方文档本地构建指南基于 Sphinx 与 CMake 生成 HTML 文档和 man 手册页Polybar 官方文档本地构建指南基于 Sphinx 与 CMake 生成 HTML 文档和 man 手册页 Polybar 项目将官方文档用户手册、模块桌面应用上一篇ELF可视化工具 Elfcat 使用指南下一篇zoxide 项目教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/17 19:43:34

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/17 19:43:32

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉