跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Dirsearch Web 路径扫描工具:安装、核心用法与实战案例

Dirsearch 是一款高效的多线程 Web 路径扫描工具,适用于渗透测试和资产测绘。文章涵盖安装步骤、常用参数详解及实战场景,包括单目标扫描、批量探测、自定义字典、状态码过滤及代理配置等核心用法。针对扫描过快触发 429 限制的情况提供了降速策略,并结合 CTF 信息搜集场景演示了如何从结果中提取敏感目录与文件,帮助安全研究人员快速定位隐藏资源。

DevStack发布于 2026/4/9更新于 2026/10/2693 浏览

Dirsearch Web 路径扫描工具:安装、核心用法与实战案例

Dirsearch 是一款高效、多线程的 Web 路径扫描工具,专为渗透测试人员和网络安全研究人员设计。它能快速发现目标网站的隐藏目录、敏感文件及未授权接口,支持自定义字典、代理配置和请求头伪装等功能。

环境准备

确保已安装 Python 环境,推荐使用 pip 进行安装。

pip install dirsearch

如果依赖项较多,建议升级并安装 requirements:

pip install --upgrade -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

核心用法

运行 python dirsearch.py -h 可查看完整帮助文档。以下是实际工作中最常用的参数组合与场景解析。

基础扫描

单目标扫描 这是最基础的用法,指定目标 URL 和需要扫描的文件扩展名。

python dirsearch.py -u http://example.com -e php,html
  • -u: 指定目标 URL。
  • -e: 指定扩展名列表(如 php, html),默认会替换字典中的 %EXT% 关键字。

批量扫描 当需要扫描多个站点时,可以将 URL 写入文本文件,每行一个地址。

python dirsearch.py -l urls.txt -t 5 -e php
  • -l: 读取包含 URL 列表的文件。
  • -t: 设置线程数,默认 20,根据网络状况调整。

高级配置

自定义字典 内置字典通常够用,但在特定场景下(如针对某 CMS),使用自定义字典能显著提高命中率。

python dirsearch.py -u http://example.com -w /path/to/custom_wordlist.txt
  • -w: 指定字典文件或目录。字典需为纯文本格式,每行一个路径或文件名。

状态码过滤 扫描结果往往充斥着大量 404 或 403,通过过滤可以聚焦有效资源。

python dirsearch.py -u http://example.com --exclude-status 403,500
  • --exclude-status: 排除指定的状态码(如 403 禁止访问,500 服务器错误)。
  • -i: 仅保留指定的状态码(如 -i 200,301)。

请求头伪装与代理 为了绕过简单的 WAF 或隐藏真实 IP,可以添加自定义请求头或使用代理。

python dirsearch.py -u http://example.com -H "User-Agent: Mozilla/5.0" --proxy http://127.0.0.1:8080
  • -H: 添加自定义 HTTP 请求头,可多次使用。
  • --random-agent: 自动随机切换 User-Agent。
  • --proxy: 指定代理服务器地址。

递归扫描 发现目录后继续深入扫描子目录。

python dirsearch.py -u http://example.com --recursive -R 3
  • --recursive: 启用递归扫描。
  • -R: 限制最大递归深度,防止扫描过深导致耗时过长。

结果导出

扫描完成后,将结果保存为结构化数据便于后续分析。

python dirsearch.py -u http://example.com -o report.json --format json
  • -o: 输出文件路径。
  • --format: 支持 json, csv, xml, md 等多种格式。

生成的 JSON 报告包含 URL、状态码、响应大小等字段,方便编写脚本二次处理。

常见状态码含义

在分析扫描结果时,理解状态码至关重要:

状态码含义场景价值
200成功请求大概率表示资源存在,可直接访问
301永久重定向原 URL 失效,跳转至新地址
302临时重定向资源暂时移动,可能指向登录页
403权限不足目录存在但无访问权限
404资源不存在无效路径,通常可忽略
500服务器错误服务端异常,可能是扫描触发了防护
429请求过于频繁触发限流,需降低扫描速度

实战场景:CTF 信息搜集

在 CTF 比赛或红队演练中,Dirsearch 常用于快速定位后台入口或敏感文件。

典型命令

python dirsearch.py -u http://目标网址 -e * -r -x 404 --full-url
  • -e *: 扫描所有常见后缀。
  • -r: 递归扫描。
  • -x 404: 排除不存在的页面,减少干扰。
  • --full-url: 显示完整 URL,方便直接点击验证。

遇到 429 怎么办?

如果扫描过程中出现大量 429 错误,说明触发了目标的频率限制。此时应调整策略:

  1. 降低线程数:将 -t 设为 5 或更低。
  2. 增加延迟:使用 --delay 1 或更大值,减缓请求节奏。
  3. 避开高峰:选择业务低峰期再进行扫描。

结果分析重点

扫描结束后,重点关注以下结果:

  1. 状态码 200:确认存在的目录或文件。
  2. 备份文件:如 .php~, .swp, .bak 等,可能包含源码。
  3. 配置文件:如 config.php, database.yml。
  4. 压缩包:如 backup.zip, source.tar.gz。
  5. robots.txt:查看是否暴露了敏感目录路径。

注意事项

  • 合法合规:仅对授权目标进行测试,严禁未授权扫描他人网站。
  • 性能调优:字典越大、线程越多,扫描时间越长,需根据目标规模平衡效率与隐蔽性。
  • 环境安全:若涉及敏感凭证(如 Cookie、Token),请在安全环境中执行命令,避免泄露。

掌握这些技巧后,Dirsearch 将成为你资产测绘和漏洞挖掘过程中的得力助手。

目录

  1. Dirsearch Web 路径扫描工具:安装、核心用法与实战案例
  2. 环境准备
  3. 核心用法
  4. 基础扫描
  5. 高级配置
  6. 结果导出
  7. 常见状态码含义
  8. 实战场景:CTF 信息搜集
  9. 注意事项

更多推荐文章

查看全部
  • 利用 Web Scraper 插件爬取知乎评论数据实战
  • 从 vw/vh 到 clamp():前端响应式设计痛点与进化
  • GitHub 仓库配置与推送:从 SSH 到冲突解决
  • 泰山派 RK3566 驱动开发:环境搭建与内核编译实战
  • 程序员转型大模型:2025 年 AI 职业发展路径分析
  • Python 设计模式实战:单例与工厂模式详解
  • C++ 进阶核心知识点整理
  • 基于 ToClaw 构建 AI 自动化助手:重复任务托管与远程协作实战
  • 双指针算法:从暴力遍历到线性高效重构数组操作
  • AI 工具泛滥时代,为何核心能力反而贬值?
  • Docker+K8s 微服务部署与运维实战指南
  • 动态规划:买卖股票的最佳时机 I、II、III 详解
  • Java 手写 AI Agent:ZenoAgent 核心设计与实现
  • AI 大模型技术入门与全栈开发实战指南
  • 2026 年 3 月 GitHub 榜单深度解析:AI 代理与工业级落地
  • AI 热榜观察:OpenClaw 之外的 5 个关键趋势
  • C++ 哈希表封装实战:从原理到 unordered_map 底层优化
  • DEIM 实时目标检测算法及 Visdrone2019 数据集实战
  • AI Coding 核心指南:从上下文工程到任务拆解策略
  • 大模型训练实战经验总结

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online