dirsearch - 网页路径发现

一个高级的网页路径暴力破解器

dirsearch 由 @maurosoria 和 @shelld3v 积极开发。

加入 Discord 服务器 与团队交流。

快速开始

dirsearch 需要 Python 3.11 或更高版本。

git clone https://github.com/maurosoria/dirsearch.git --depth 1
cd dirsearch
python3 dirsearch.py -u https://example.com -e php,html,js

你也可以直接通过 pip 从 GitHub 安装最新的 Python 栈：

pip3 install git+https://github.com/maurosoria/dirsearch.git
dirsearch -u https://example.com -e php,html,js

Rust 原生后端对于源码安装是可选的；请参阅 安装 了解原生构建步骤。

预构建的 PyInstaller 二进制文件和便携式文件夹档案可在 Releases 页面 上获取。

文档

完整文档现在位于 docs/ 目录下：

• 安装: 支持的平台、Python 安装、发布制品和 Docker。
• 使用指南: 常见扫描、递归、过滤器、代理、原始请求、报告和提示。
• 字典列表: %EXT%、类别、模板、前缀、后缀和转换。
• CLI 选项: 完整的命令行参考。
• 配置: config.ini 参考。
• 会话: 保存、列出和恢复扫描会话。
• Python API: 可导入的 API 示例。
• 构建: PyInstaller、便携式构建、Docker 镜像和 GitHub Actions。
• 参考资料: 外部教程和文章。

最小示例

python3 dirsearch.py -u https://target
python3 dirsearch.py -u https://target -e php,html,js
python3 dirsearch.py -u https://target -e php,html,js -w /path/to/wordlist
python3 dirsearch.py -u https://target -r --max-recursion-depth 3

使用 python3 dirsearch.py -h 获取完整的 CLI 帮助。

Python API

dirsearch 也可以从 Python 代码中使用，用于本地自动化、MCP 服务器、REST 包装器和智能体控制的扫描。可导入的 API 将其配置保存在 FuzzerConfig 中，因此调用者无需解析 CLI 标志或修改 CLI 全局变量。

参见 Python API 了解涵盖模板、自定义字典列表、回调、认证会话和面向智能体的扫描方案的示例。

贡献

欢迎提交拉取请求和功能请求。请参阅 CONTRIBUTORS.md 了解帮助改进 dirsearch 的人员。

许可证

Copyright (C) Mauro Soria ([email protected])

许可证：GNU 通用公共许可证，版本 2