dirsearch v0.5.0 重磅更新！异步+Rust双引擎，目录扫描工具全面升级

maurosoria
maurosoria

鹏组安全

2026年8月15日 08:30
江西

在小说阅读器读本章

去阅读

前言

dirsearch作为渗透测试、资产测绘领域最主流的Web目录爆破工具，从v0.3 系列迭代至今，凭借轻量化、低误报、丰富自定义参数成为红队标配。 2026-08-14官方正式发布v0.5.0大版本，相比上一稳定版v0.4.3迎来底层架构重构：默认异步扫描、Rust原生后端、全新字典模板、数据库报告、可中断续扫会话、Python原生API六大核心革新，彻底解决旧版线程卡顿、字典拓展弱、报告单一、中断丢失进度等痛点。

一、底层引擎革新：速度与并发全面质变

1. 异步扫描默认启用，淘汰传统多线程

v0.5.0 将Async 异步协程设为默认运行模式，旧版线程栈仅通过--sync手动切换：

• 优势：I/O 密集型扫描 CPU 占用大幅降低，无线程切换开销；Ctrl+C可即时暂停，无需等待线程回收
• 兼容：仅 Python3.11 + 完整支持异步，官方编译包统一基于 Python3.14 构建
• 回退方案：老旧环境执行dirsearch -u target --sync切回传统线程模式

2. Rust 原生高性能后端，极速字典生成与 GET 扫描

新增双 Native 后端，纯 Rust 实现底层请求与字典解析，性能碾压 Python 原生：

# Rust请求后端（GET扫描专用）
dirsearch -u https://test.com --request-backend native
# Rust字典解析后端，超大字典秒加载
dirsearch -u https://test.com --wordlist-backend native

适用场景：超大词库批量扫描、高并发资产测绘，同等线程 / 协程下扫描速度提升 40%+，内存占用减半。

3. 精细化扫描过滤，对标 ffuf 全能匹配规则

新增多维度响应过滤 / 匹配，精准降噪减少误报：

• 状态码：支持区间匹配、黑白名单
• 响应指标：页面大小、单词数、行数、请求耗时过滤
• 正则过滤：自定义正则排除垃圾页面
• 智能去重：新增跳转感知重复检测、通配符页面自动过滤，内置隐蔽校准词库降低 WAF 拦截概率

4. 企业级扫描控制参数

• --max-runtime：单目标最大扫描时长，防止卡死长期无响应站点
• 支持指定网卡出口 IP 扫描多网卡服务器
• 直接导入 Nmap XML 结果批量爆破资产
• --disable-cli：无交互后台静默扫描，适配 CI / 自动化流水线

二、字典系统史诗级升级，模板化 + 分类词库

1. 分类式内置词库，一键匹配目标技术栈

--wordlist-categories按开发框架划分内置路径库，无需手动筛选字典： 可选分类：PHP、Python、Java、.NET、Node、ColdFusion、基础设施面板 示例：扫描 Java 后台自动加载对应管理路径

dirsearch -u https://java-web.com --wordlist-categories java

2. 模板占位符字典，动态生成扫描路径

支持在字典中嵌入变量自动填充，大幅简化自定义字典编写，内置占位符： %SUBJECT%、%CRUD_OP%、%AUTH_OP%、%DATE%、%API_VERSION%、%CATEGORY:name%、%EXT% 实战示例：API 接口批量爆破 字典内容：api/%API_VERSION%/user/%CRUD_OP% 扫描时自动生成：api/v1/user/get、api/v2/user/update等路径，适配 Restful 接口探测

3. 词库管理新参数

• --wordlist-max-size：限制加载字典文件大小，避免超大文本拖慢程序
• --wordlist-status：仅保留匹配指定状态码的字典条目，精简扫描范围 官方内置字典同步扩容：新增 WordPress/WooCommerce 后台、Ollama/OpenAI 大模型 API、路径穿越相关敏感地址，黑名单同步更新。

三、报告输出全面扩容，支持数据库持久化

旧版仅支持 TXT/CSV/HTML/XML，v0.5.0 新增MySQL、PostgreSQL 数据库报告，适配批量资产统一存储分析：

1. 多格式同时导出：单次扫描一次性生成 txt+json + 数据库入库
2. 报告路径 / 数据表支持变量命名，自动按目标、时间分表存储
3. 数据库驱动改为可选依赖，按需安装：

# MySQL支持
pip install dirsearch[mysql]
# PostgreSQL支持
pip install dirsearch[postgresql]
# 全数据库组件
pip install dirsearch[db]

1. --verbose增强：输出每条请求响应耗时、页面 Content-Type，便于接口分析

四、会话断点续扫，彻底告别进度丢失

重构会话存储逻辑，弃用不安全 pickle 序列化，改用 JSON 存储扫描进度：

1. 核心命令

# 查看本地所有扫描会话ID
dirsearch --list-sessions
# 根据会话ID恢复中断扫描
dirsearch --resume 会话ID

1. 跨平台兼容：Windows/macOS/Linux 时间戳路径自动适配，打包版会话统一存在用户家目录
2. 暂停优化：异步 / 线程 / 二进制打包程序统一支持Ctrl+C暂停，重启直接接续未完成字典，不用从头扫描

五、Python 可编程 API，赋能自动化安全流程

v0.5.0 对外暴露完整 Python 开发接口，可集成到自研扫描平台、Agent 自动化工具链：

• 核心类：FuzzerConfig（扫描配置）、DirsearchFuzzer（爆破实例）
• 能力：自定义词库、模板变量、回调获取结构化扫描结果
• 入口优化：支持python -m dirsearch模块调用，打包元数据修复，第三方集成无兼容问题

六、安全与供应链加固

1. 依赖版本固定锁定，强化供应链安全，移除老旧依赖安装逻辑
2. XML 解析增加安全防护，修复外部实体注入风险
3. 旧 pickle 会话文件不再自动加载，启动给出安全警告，避免反序列化漏洞
4. 可选数据库组件非强制安装，精简基础环境依赖

七、多平台打包发布，开箱即用无环境烦恼

官方 Release 同步发布全架构预编译二进制包，无需本地 Python 环境：

支持架构

Windows x64、Linux x64/Linux ARM64、macOS Intel、macOS Apple Silicon

三种编译变体按需选择

1. async：默认异步轻量包（推荐绝大多数场景）
2. threaded：传统线程兼容包
3. native-rust：集成 Rust 后端高性能包 配套提供便携压缩包（规避杀毒软件对 PyInstaller 误报）、Linux x64 官方 Docker 镜像，CI 流水线同步更新 CodeQL、Semgrep 安全扫描流程。

八、v0.5.0 实战常用命令示例

1. 默认异步 + Rust 后端高速扫描

dirsearch -u https://target.com --request-backend native --wordlist-backend native

2. Java 站点分类字典 + 递归深度 3

dirsearch -u https://java-admin.com --wordlist-categories java -r -R 3

3. 扫描中断后恢复会话

dirsearch --list-sessions
dirsearch --resume session_20260814_0225

4. 扫描结果同时存入 MySQL+HTML 报告

dirsearch -u https://api.test.com --db mysql://user:[email protected]/scan_result --html report.html

5. 老旧系统切回线程模式，限制最大扫描 10 分钟

dirsearch -u http://legacy-site.com --sync --max-runtime 600

九、升级 / 安装方式

1. Git 源码升级（推荐，获取完整内置字典）

git clone https://github.com/maurosoria/dirsearch.git
cd dirsearch
# 安装完整版含数据库依赖
pip3 install .[db]
# 验证版本
dirsearch --version

2. 直接下载 Release 预编译包

访问发布页：https://github.com/maurosoria/dirsearch/releases/tag/v0.5.0 根据系统架构下载对应 async/native-rust二进制文件，解压直接运行。

3. Docker 镜像快速启动

# 拉取异步版镜像
docker pull ghcr.io/maurosoria/dirsearch-async:v0.5.0
docker run -it ghcr.io/maurosoria/dirsearch-async:v0.5.0 -u https://target.com

文末小结

dirsearch v0.5.0 是一次架构级重构更新，异步+Rust双引擎解决了长久以来性能瓶颈，模板字典、数据库报告、会话续扫、可编程API四大功能补齐企业级自动化短板。对于日常Web目录探测从业者，新版本大幅降低扫描耗时、减少重复工作量，推荐尽快升级适配。

github:https://github.com/maurosoria/dirsearch/releases/tag/v0.5.0

鹏组安全社区站：您身边的安全专家-情报 | 攻防 | 渗透 | 线索 | 资源社区

扫码关注

社区

鹏组安全社区：comm.pgpsec.cn

专注网络技术与骇客的一个综合性技术性交流与资源分享社区

老用户续费88折扣

社区首页

互助中心

免责声明

由于传播、利用本公众号鹏组安全所提供的信息而造成的任何直接或者间接的后果及损失，均由使用者本人负责，公众号鹏组安全及作者不为此承担任何责任，一旦造成后果请自行承担！如有侵权烦请告知，我们会立即删除并致歉。谢谢！

好文分享收藏赞一下最美点在看哦