C07-Nuclei使用教程

# 基本介绍

Nuclei 是一款由 ProjectDiscovery 团队用Go语言开发的开源漏洞扫描工具，基于 YAML 模板驱动，专注于定制化模板实现高效安全检测。
它支持多种协议，如 HTTP、DNS、TCP、SSL 等，并具备高性能架构，可进行大规模并发扫描。
Nuclei 的核心优势在于其灵活的定制和扩展能力，用户可以自定义模板或使用社区维护的丰富模板库。
此外，Nuclei 还支持云平台集成、WAF 绕过等功能，适用于渗透测试、红队演练、漏洞验证及日常安全监控等多种场景。

中文教程：
https://github.com/projectdiscovery/nuclei/blob/dev/README_CN.md

# 程序下载

https://github.com/projectdiscovery/nuclei/releases

例如Windows下载：
nuclei_3.4.2_windows_amd64，解压放到一个没有空格和中文的目录

为方便调用，把nuclei.exe的路径添加到PATH环境变量：

![](/media/202505/2025-05-08_101418_6415970.9095672642172694.png)

# 更新模板（漏洞规则库）
第一次启动，会自动下载模板库。手动更新模板库使用命令：
`nuclei -update-templates`
或者：`nuclei -ut`

模板默认存储目录：
`C:\Users\用户名\nuclei-templates`
例如：
`C:\Users\Administrator\nuclei-templates`

# 基本扫描语法

`nuclei -u http://example.com -t /path/to/templates/`

-u 指定目标 URL
-t 指定规则模板目录（模板既有自带的，也可以自己编写）。

# 支持的命令
```
用法：
  nuclei [命令]

命令：
目标：
   -u, -target string[]                  指定扫描的目标URL/主机（多个目标则指定多个-u参数）
   -l, -list string                      指定包含要扫描的目标URL/主机列表的文件路径（一行一个）
   -resume string                        使用指定的resume.cfg文件恢复扫描（将禁用请求聚类）
   -sa, -scan-all-ips                    扫描由目标解析出来的所有IP（针对域名对应多个IP的情况）
   -iv, -ip-version string[]             要扫描的主机名的IP版本（4,6）-（默认为4）

模板：
   -nt, -new-templates                    仅运行最新发布的nuclei模板
   -ntv, -new-templates-version string[]  仅运行特定版本中添加的新模板
   -as, -automatic-scan                   基于Wappalyzer技术的标签映射自动扫描
   -t, -templates string[]                指定要运行的模板或者模板目录（以逗号分隔或目录形式）
   -turl, -template-url string[]          指定要运行的模板URL或模板目录URL（以逗号分隔或目录形式）
   -w, -workflows string[]                指定要运行的工作流或工作流目录（以逗号分隔或目录形式）
   -wurl, -workflow-url string[]          指定要运行的工作流URL或工作流目录URL（以逗号分隔或目录形式）
   -validate                              使用nuclei验证模板有效性
   -nss, -no-strict-syntax                禁用对模板的严格检查
   -td, -template-display                 显示模板内容
   -tl                                    列出所有可用的模板
   -sign                                  使用NUCLEI_SIGNATURE_PRIVATE_KEY环境变量中的私钥对模板进行签名
   -code                                  启用加载基于协议的代码模板

过滤：
   -a, -author string[]                  执行指定作者的模板（逗号分隔，文件）
   -tags string[]                        执行带指定tag的模板（逗号分隔，文件）
   -etags, -exclude-tags string[]        排除带指定tag的模板（逗号分隔，文件）
   -itags, -include-tags string[]        执行带有指定tag的模板，即使是被默认或者配置排除的模板
   -id, -template-id string[]            执行指定id的模板（逗号分隔，文件）
   -eid, -exclude-id string[]            排除指定id的模板（逗号分隔，文件）
   -it, -include-templates string[]      执行指定模板，即使是被默认或配置排除的模板
   -et, -exclude-templates string[]      排除指定模板或者模板目录（逗号分隔，文件）
   -em, -exclude-matchers string[]       排除指定模板matcher
   -s, -severity value[]                 根据严重程度运行模板，可选值有：info,low,medium,high,critical   
   -es, -exclude-severity value[]        根据严重程度排除模板，可选值有：info,low,medium,high,critical
   -pt, -type value[]                    根据类型运行模板，可选值有：dns, file, http, headless, network, workflow, ssl, websocket, whois
   -ept, -exclude-type value[]           根据类型排除模板，可选值有：dns, file, http, headless, network, workflow, ssl, websocket, whois
   -tc, -template-condition string[]     根据表达式运行模板

输出：
   -o, -output string                    输出发现的问题到文件
   -sresp, -store-resp                   将nuclei的所有请求和响应输出到目录
   -srd, -store-resp-dir string          将nuclei的所有请求和响应输出到指定目录（默认：output）
   -silent                               只显示结果
   -nc, -no-color                        禁用输出内容着色（ANSI转义码）
   -j, -jsonl                            输出格式为jsonL（ines）
   -irr, -include-rr                     在JSON、JSONL和Markdown中输出请求/响应对（仅结果）[已弃用，使用-omit-raw替代]
   -or, -omit-raw                        在JSON、JSONL和Markdown中不输出请求/响应对
   -ot, -omit-template           省略JSON、JSONL输出中的编码模板
   -nm, -no-meta                         在cli输出中不打印元数据
   -ts, -timestamp                       在cli输出中打印时间戳
   -rdb, -report-db string               本地的nuclei结果数据库（始终使用该数据库保存结果）
   -ms, -matcher-status                  显示匹配失败状态
   -me, -markdown-export string          以markdown格式导出结果
   -se, -sarif-export string             以SARIF格式导出结果
   -je, -json-export string              以JSON格式导出结果
   -jle, -jsonl-export string            以JSONL(ine)格式导出结果

配置：
   -config string                        指定nuclei的配置文件
   -fr, -follow-redirects                为HTTP模板启用重定向
   -fhr, -follow-host-redirects          允许在同一主机上重定向
   -mr, -max-redirects int               HTTP模板最大重定向次数（默认：10）
   -dr, -disable-redirects               为HTTP模板禁用重定向
   -rc, -report-config string            指定nuclei报告模板文件
   -H, -header string[]                  指定在所有http请求中包含的自定义header、cookie，以header:value的格式指定（cli，文件）
   -V, -var value                        以key=value格式自定义变量
   -r, -resolvers string                 指定包含DNS解析服务列表的文件
   -sr, -system-resolvers                当DNS错误时使用系统DNS解析服务
   -dc, -disable-clustering              关闭请求聚类功能
   -passive                              启用被动模式处理本地HTTP响应数据
   -fh2, -force-http2                    强制使用http2连接
   -ev, env-vars                         启用在模板中使用环境变量
   -cc, -client-cert string              用于对扫描的主机进行身份验证的客户端证书文件（PEM 编码）
   -ck, -client-key string               用于对扫描的主机进行身份验证的客户端密钥文件（PEM 编码）
   -ca, -client-ca string                用于对扫描的主机进行身份验证的客户端证书颁发机构文件（PEM 编码）
   -sml, -show-match-line                显示文件模板的匹配值，只适用于提取器
   -ztls                                 使用ztls库，带有自动回退到标准库tls13 [已弃用] 默认情况下启用对ztls的自动回退
   -sni string                           指定tls sni的主机名（默认为输入的域名）
   -lfa, -allow-local-file-access        允许访问本地文件（payload文件）
   -lna, -restrict-local-network-access  阻止对本地/私有网络的连接
   -i, -interface string                 指定用于网络扫描的网卡
   -at, -attack-type string              payload的组合模式（batteringram,pitchfork,clusterbomb）
   -sip, -source-ip string               指定用于网络扫描的源IP
   -rsr, -response-size-read int         最大读取响应大小（默认：10485760字节）
   -rss, -response-size-save int         最大储存响应大小（默认：1048576字节）
   -reset                                删除所有nuclei配置和数据文件（包括nuclei-templates）
   -tlsi, -tls-impersonate               启用实验性的Client Hello（ja3）TLS 随机化功能

交互：
   -inserver, -ineractsh-server string   使用interactsh反连检测平台（默认为oast.pro,oast.live,oast.site,oast.online,oast.fun,oast.me）
   -itoken, -interactsh-token string     指定反连检测平台的身份凭证
   -interactions-cache-size int          指定保存在交互缓存中的请求数（默认：5000）
   -interactions-eviction int            从缓存中删除请求前等待的时间（默认为60秒）
   -interactions-poll-duration int       每个轮询前等待时间（默认为5秒）
   -interactions-cooldown-period int     退出轮询前的等待时间（默认为5秒）
   -ni, -no-interactsh                   禁用反连检测平台，同时排除基于反连检测的模板

模糊测试:
   -ft, -fuzzing-type string             覆盖模板中设置的模糊测试类型（replace、prefix、postfix、infix）
   -fm, -fuzzing-mode string             覆盖模板中设置的模糊测试模式（multiple、single）

UNCOVER引擎:
   -uc, -uncover                         启动uncover引擎
   -uq, -uncover-query string[]          uncover查询语句
   -ue, -uncover-engine string[]         指定uncover查询引擎 （shodan,censys,fofa,shodan-idb,quake,hunter,zoomeye,netlas,criminalip,publicwww,hunterhow） （默认 shodan）
   -uf, -uncover-field string            查询字段 （ip,port,host） （默认 "ip:port"）
   -ul, -uncover-limit int               查询结果数 （默认 100）
   -ur, -uncover-ratelimit int           查询速率，默认每分钟60个请求（默认 60）

限速：
   -rl, -rate-limit int                  每秒最大请求量（默认：150）
   -rlm, -rate-limit-minute int          每分钟最大请求量
   -bs, -bulk-size int                   每个模板最大并行检测数（默认：25）
   -c, -concurrency int                  并行执行的最大模板数量（默认：25）
   -hbs, -headless-bulk-size int         每个模板并行运行的无头主机最大数量（默认：10）
   -headc, -headless-concurrency int     并行指定无头主机最大数量（默认：10）

优化：
   -timeout int                          超时时间（默认为10秒）
   -retries int                          重试次数（默认：1）
   -ldp, -leave-default-ports            指定HTTP/HTTPS默认端口（例如：host:80，host:443）
   -mhe, -max-host-error int             某主机扫描失败次数，跳过该主机（默认：30）
   -te, -track-error string[]            将给定错误添加到最大主机错误监视列表（标准、文件）
   -nmhe, -no-mhe                        disable skipping host from scan based on errors
   -project                              使用项目文件夹避免多次发送同一请求
   -project-path string                  设置特定的项目文件夹
   -spm, -stop-at-first-path             得到一个结果后停止（或许会中断模板和工作流的逻辑）
   -stream                               流模式 - 在不整理输入的情况下详细描述
   -ss, -scan-strategy value             扫描时使用的策略（auto/host-spray/template-spray） （默认 auto）
   -irt, -input-read-timeout duration    输入读取超时时间（默认：3分钟）
   -nh, -no-httpx                        禁用对非URL输入进行httpx探测
   -no-stdin                             禁用标准输入

无界面浏览器：
    -headless                            启用需要无界面浏览器的模板
    -page-timeout int                    在无界面下超时秒数（默认：20）
    -sb, -show-brower                    在无界面浏览器运行模板时，显示浏览器
    -ho, -headless-options string[]      使用附加选项启动无界面浏览器
    -sc, -system-chrome                  不使用Nuclei自带的浏览器，使用本地浏览器
    -lha, -list-headless-action          列出可用的无界面操作

调试：
    -debug                               显示所有请求和响应
    -dreq, -debug-req                    显示所有请求
    -dresp, -debug-resp                  显示所有响应
    -p, -proxy string[]                  使用http/socks5代理（逗号分隔，文件）
    -pi, -proxy-internal                 代理所有请求
    -ldf, -list-dsl-function             列出所有支持的DSL函数签名
    -tlog, -trace-log string             写入跟踪日志到文件
    -elog, -error-log string             写入错误日志到文件
    -version                             显示版本信息
    -hm, -hang-monitor                   启用对nuclei挂起协程的监控
    -v, -verbose                         显示详细信息
    -profile-mem string                  将Nuclei的内存转储成文件
    -vv                                  显示额外的详细信息
    -svd, -show-var-dump                 显示用于调试的变量输出
    -ep, -enable-pprof                   启用pprof调试服务器
    -tv, -templates-version              显示已安装的模板版本
    -hc, -health-check                   运行诊断检查

升级：
    -up, -update                         更新Nuclei到最新版本
    -ut, -update-templates               更新Nuclei模板到最新版
    -ud, -update-template-dir string     指定模板目录
    -duc, -disable-update-check          禁用nuclei程序与模板更新

统计：
    -stats                               显示正在扫描的统计信息
    -sj, -stats-json                     将统计信息以JSONL格式输出到文件
    -si, -stats-inerval int              显示统计信息更新的间隔秒数（默认：5）
    -mp, -metrics-port int               更改metrics服务的端口（默认：9092）

云服务：
   -auth                  配置projectdiscovery云服务（pdcp）API密钥
   -cup, -cloud-upload    将扫描结果上传到pdcp仪表板
   -sid, -scan-id string  将扫描结果上传到指定的扫描ID

例子:
扫描一个单独的URL:
	$ nuclei -target example.com

对URL运行指定的模板:
	$ nuclei -target example.com -t http/cves/ -t ssl

扫描hosts.txt中的多个URL:
	$ nuclei -list hosts.txt

输出结果为JSON格式:
	$ nuclei -target example.com -json-export output.json

使用已排序的Markdown输出（使用环境变量）运行nuclei:
	$ MARKDOWN_EXPORT_SORT_MODE=template nuclei -target example.com -markdown-export nuclei_report/
```

# 编写yml文件

把POC发给AI，可以直接生成yaml
https://cloud.projectdiscovery.io/templates

nuclei 模板通常包含以下几个部分：
- id：模板的唯一标识符。
- info：包含模板的基本信息，如名称、作者、版本等。
- author：模板作者。
- severity：漏洞的严重性等级。
- tags：用于分类的标签。
- requests：定义了如何与目标进行交互的请求部分。
  - method：HTTP 方法，如 GET 或 POST。
  - path：请求的路径。
  - headers：请求头。
  - body：请求体。
  - payloads：用于定义可能的输入值。
- response：定义了如何分析响应以确定是否发现漏洞。
  - status：期望的 HTTP 状态码。
  - headers：期望的响应头。
  - body：期望的响应体内容。

# yaml示例文件
## 命令执行漏洞模板
```
# 任务信息
info:
  name: Command Injection Vulnerability Scan
  author: your_name
  severity: critical
  description: The scan checks for command injection vulnerabilities by sending specially crafted payloads.

# HTTP 请求
http:
  # GET 请求
  - method: GET
    path:
      - "{{BaseURL}}cmd=whoami"
    matchers:
      - type: regex
        part: body
        regex:
          - "root|administrator|www-data"

# POST 请求
  - method: POST
    path:
      - "{{BaseURL}}execute"
    body: "cmd=cat /etc/passwd"
    matchers:
      - type: regex
        part: body
        regex:
          - "rootx00"

# RAW 请求 (可选)
  - raw:
      - "GET {{BaseURL}}cmd={{rand_base64}} HTTP/1.1\r\nHost: {{Hostname}}\r\n\r\n"
    matchers:
      - type: dsl
        dsl:
          - "contains(tolower(body), 'rootx00')"
```

## SQL注入漏洞模板
```
id: sql-delay-injection-scan
info:
  name: SQL Delay Injection Detection
  author: your_name
  severity: critical
  description: This template detects SQL delay injection vulnerabilities by measuring the response time of crafted payloads.

http:
  - method: GET
    path:
      - "{{BaseURL}}/index.php?id=1"  # Example path, adjust according to the application's parameter
    headers:
      User-Agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3"

payloads:
      delay:
        - "1'"
        - "' AND (SELECT  FROM (SELECT(SLEEP(5)))a) AND '1'='1"

attack: clusterbomb  # This will send all payloads for each path

matchers:
      - type: dsl
        dsl:
          - "duration >= 5000"  # The response time should be greater than or equal to 5000ms (5 seconds) to indicate a potential delay

extractors:
      - type: regex
        part: body
        regex:
          - "SQL syntax.*SQL injection"  # Extracts error messages that may indicate SQL injection
```

## 任意文件读取漏洞模板
```
id: arbitrary-file-read-scan
info:
  name: "Arbitrary File Read Detection"
  author: "your_name"
  severity: "high"
  description: "The template checks for arbitrary file read vulnerabilities by attempting to access sensitive files."

http:
  - method: GET
    path:
      - "{{BaseURL}}/pathtosensitivefiles/file=etcpasswd"
      - "{{BaseURL}}/download/path=.../etc/shadow"
      - "{{BaseURL}}/viewfile/filename=.../var/www/html/config.php"

matchers:
      - type: regex
        part: body
        regex:
          - "root:x:.*"  # Typical line in /etc/passwd
          - "shadow:"    # Typical line in /etc/shadow
          - "DB_PASSWORD="  # Example of a configuration file containing a password

- type: status
        status:
          - 200

extractors:
      - type: regex
        part: body
        name: sensitive_files
        regex:
          - "(\/etc\/passwd|\/etc\/shadow|\/var\/www\/html\/config\.php)"  # Adjust the regex to match the files you are looking for

response:
  - status: 403  # Forbidden status code, indicating the file is protected but accessible
    headers:
      - "Content-Type: text/plain"  # Example of a header that might be returned for a protected file
  - status: 404  # Not Found status code, indicating the file does not exist or is not accessible
```

## XSS漏洞模板
```
id: reflected-xss-scan
info:
  name: "Reflected XSS Vulnerability Detection"
  author: "your_name"
  severity: "medium"
  description: "This template detects reflected XSS vulnerabilities by sending payloads to the target URL and checking for the presence of the payload in the response."

http:
  - method: GET
    path:
      - "{{BaseURL}}/search?q={{randstr}}"
      - "{{BaseURL}}/param={{randstr}}"

payloads:
      - payload: "{{randstr}}"
      - payload: "%3Cscript%3Ealert%28%27xss%27%29%3B%3C%2Fscript%3E"  # Encoded script: alert('xss');</script>

attack_chain:  # This will send the payloads after the randstr

matchers:
      - type: word
        part: body
        words:
          - "scriptalert('xss');script"  # Look for the exact payload in the response
          - "{{randstr}}"  # Look for the random string in the response

- type: status
        status:
          - 200

## 反序列化漏洞模板
```
id: snakeyaml-deserialization-scan
info:
  name: "SnakeYAML Deserialization Vulnerability Detection"
  author: "your_name"
  severity: "high"
  description: "Checks if the application is vulnerable to SnakeYAML deserialization attacks by sending serialized Java objects."

http:
  - method: POST
    path:
      - "{{BaseURL}}/apideserialize"  # 假设的反序列化处理接口

headers:
      Content-Type: "application/x-java-serialized-object"

body: |
      ACED00057372002D6F626A6563742E7365727665726C65735F7365727665726C6966652E5472696F6E67496E766F6B65...

matchers:
      - type: word
        part: body
        words:
          - "java.lang.ClassCastException"
          - "java.io.InvalidClassException"
        condition: or

- type: status
        status:
          - 500
```

## 弱口令漏洞模板
```
id: weak-password-detection
info:
  name: "Weak Password Detection"
  author: "your_name"
  severity: "info"
  description: "Attempts to detect weak passwords for basic auth, form logins, or specific APIs by sending common credentials."

http:
  - method: POST
    path:
      - "{{BaseURL}}/login"
    body: |
      username={{username}}&password={{password}}
    headers:
      Content-Type: "application/x-www-form-urlencoded"

# 定义 payload 提供用户名和密码组合
    payloads:
      - username: "admin"
      - password: "123456"  # 可以根据需要添加更多常见弱密码

# 使用 attack clusterbomb 模式发送所有用户名和密码的组合
    attack: clusterbomb

matchers:
      - type: dsl
        dsl:
          - "status_code==200 && contains(tolower(body), 'login successful')"  # 假设登录成功会返回 200 状态码和包含 'login successful' 文本
          - "cookiecontains(auth_token)"  # 假设登录成功会设置一个 auth_token 的 cookie
```

## 文件上传漏洞模板
```
id: arbitrary-file-upload-scan
info:
  name: "Arbitrary File Upload Vulnerability Detection"
  author: "your_name"
  severity: "high"
  description: "The template checks for arbitrary file upload vulnerabilities by attempting to upload files with known vulnerable extensions."

http:
  - method: POST
    path:
      - "{{BaseURL}}/upload"  # 假设的上传接口路径

headers:
      Content-Type: "multipart/form-data; boundary=----WebKitFormBoundaryX"

# 构造一个带有文件上传的请求体
    body: |
      ------WebKitFormBoundaryX
      Content-Disposition: form-data; name="uploadfile"; filename="{{randstr}}.php"
      Content-Type: "application/x-php"

php echo 'File uploaded successfully';
      ------WebKitFormBoundaryX--

matchers:
      - type: word
        part: body
        words:
          - "File uploaded successfully"  # 假设上传成功会返回特定的成功消息

- type: status
        status:
          - 200
```