昨天想把机器上那套 nuclei 升一下，顺手查了现在的版本，发现还是 v3.11.1，发布在今年 8 月 8 日，到 10 月中旬再核依然是最新稳定版。也就是说这个版本已经稳定跑了两个多月，没有出新版本顶掉它。我把这个版本的改动和常用命令整理了一下，命令全部照抄官方 README 原文，不做改写。
先说版本这条线怎么核的。GitHub 上 projectdiscovery/nuclei 的 release 页面显示 v3.11.1 由 ehsandeep 在 8 月 8 日发布，commit a8c88fe，GPG 签名验证通过。另外 what-version.com 的版本时间线显示，截至 10 月 19 日核实，当前版本仍是 3.11.1，往前依次是 3.11.0（7 月 6 日）、3.10.0（6 月 30 日）、3.9.0（6 月 10 日）、3.8.0（4 月 18 日）。Git Times 10 月 19 日那篇也是按 3.11.1 写的。三家一致，可以确定这就是当前版本。
这个版本实质性的改动有三处，其余大部分是依赖升级和缺陷修复。
第一处是 Lua 脚本支持参数和取值（PR #6561）。以前写 Lua 脚本，一个模板要覆盖多种目标就得复制多份；现在脚本能接收 args 和 values，一份模板可以参数化处理不同目标。对维护私有模板库的人是实打实省事。
第二处是并发扫描复用 metadata 缓存（PR #7608，在 feat(lib) 下）。改动说明写的是"thread-safe scans 复用 metadata cache"，影响的是把 nuclei 当库嵌进自己 Go 服务里的场景——并发跑的时候不用重复加载 metadata，能省掉一部分开销。
第三处是新增 gRPC JavaScript library（PR #7527）。这条的意义是让非 Go 的工具链也能驱动 nuclei 引擎，配合后面"add nuclei/http js client"（#7568）一起看，JS 侧的调用能力这个版本扩了不少。
剩下的改动里，有几条我觉得值得点出来：
http tlsmeta（#7586）——TLS 相关的元信息采集，做资产指纹和证书排查的时候用得上。
headless 模式在查找元素前先渲染 locator（#7549）——headless 模板的稳定性应该会好一点。
DNSSEC 的 DNS 记录类型（#7564）——DNS 协议模板覆盖面补齐。
-max-time 软终止通过 goflags 接进 CLI（#7589）——长任务的时间控制。
JS 执行绑定到 verified content（#7636）——这条归在安全相关，模板里的 JS 只对已验证内容执行。
往前看一个版本，v3.11.0（7 月 6 日）是带 Breaking Change 的：JavaScript 协议出于安全考虑要求签名模板。谁是从 3.10.x 跳过来的，升级前先看这条。再往前 v3.8.0（4 月 18 日）修了两个 nuclei 自身的安全问题，CVE-2026-41646 和 CVE-2026-41645，都跟模板表达式求值有关。这说明一件事：扫描器本身也是软件，也得跟着升。
安装，官方 README 原文：
go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
README 里写明需要 go >= 1.24.2。更多安装方式官方指向 https://docs.projectdiscovery.io/tools/nuclei/install
基本用法，以下全部是 README 原文命令：
查看所有参数：
nuclei -h
单目标扫描：
nuclei -target https://example.com
批量扫描（urls.txt 里放多个目标）：
nuclei -list urls.txt
网段扫描：
nuclei -target 192.168.1.0/24
用自定义模板扫描：
nuclei -u https://example.com -t /path/to/your-template.yaml
指定模板目录：
nuclei -target example.com -t http/cves/ -t ssl
JSON 输出：
nuclei -target example.com -json-export output.json
Markdown 报告（带环境变量排序）：
MARKDOWN_EXPORT_SORT_MODE=template nuclei -target example.com -markdown-export nuclei_report/
结果上传到 ProjectDiscovery 云：
nuclei -target https://example.com -dashboard
更新相关的 flag，README 帮助信息原文：
-up, -update update nuclei engine to the latest released version
-ut, -update-templates update nuclei-templates to latest released version
-ud, -update-template-dir string custom directory to install / update nuclei-templates
-duc, -disable-update-check disable automatic nuclei/templates update check
这里有个坑值得说：模板和引擎是两套东西，-up 升引擎、-ut 升模板，只跑一个不算更新完成。我以前就干过只升引擎不升模板的事，结果新出的洞扫不出来，还以为是工具的毛病。
官方对自己项目的定位也写得很直白：支持 TCP、DNS、HTTP、SSL、WHOIS、JavaScript、Code 等多种协议，能接 Jira、Splunk、GitHub、Elastic、GitLab，能进 CI/CD 做回归测试。同时 README 和第三方都提示项目处于活跃开发状态，版本之间可能有 breaking change，升级前看 changelog。Git Times 那篇还提到项目当前有 142 个 open issue。这些不是劝退，是提醒你在生产环境里别闭着眼睛升。
我自己的用法是：日常把它挂在 CI 里跑回归，配合私有模板库；临时排查单个漏洞时用 -t 指定那一個模板，不跑全量，快而且噪音小。全量跑的时候一定要加 -duc 之外的速率控制，不然容易把对方打挂，也容易把自己 IP 送进对方的封锁名单。
来源：
1. projectdiscovery/nuclei Release v3.11.1（GitHub 官方发布页，2026-08-08）
https://github.com/projectdiscovery/nuclei/releases/tag/v3.11.1
2. projectdiscovery/nuclei README（安装与用法命令原文）
3. What-Version：Nuclei Version History and Release Timeline（10 月 19 日核实当前版本 3.11.1）
4. The Git Times：Nuclei Adds Lua Arguments and Cuts Metadata Overhead for Scanners（2026-10-19）
5. projectdiscovery/nuclei Release v3.8.0（CVE-2026-41646 / CVE-2026-41645）
**HKTULU**
2026-10-25
|
|
