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

Dirsearch 安装与使用教程

Dirsearch 这款高效的多线程 Web 路径扫描工具。内容涵盖安装方法、核心功能、常用参数详解及实战命令示例。重点讲解了如何通过自定义字典、状态码过滤、代理配置及递归扫描来发现隐藏目录和敏感文件。同时提供了 CTF 场景下的典型用法,强调合法合规使用及频率控制的重要性,适合渗透测试人员及安全研究人员参考。

DevStack发布于 2026/4/6更新于 2026/9/885 浏览

项目介绍

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

核心功能

  • 多线程扫描:默认 20 线程,可自定义调整以提高效率。
  • 智能错误处理:自动过滤重复状态码(如 404),降低误报率。
  • 灵活扩展支持:
    • 支持自定义字典(如 -w 指定字典文件)。
    • 支持多种扩展名扫描(如 -e php,asp,aspx)。
  • 结果输出:生成可读性强的报告(TXT/JSON/CSV),便于后续分析。
  • 绕过检测:支持随机 User-Agent、代理池、请求延迟等隐蔽扫描策略。

适用场景

  • 红队渗透:快速定位网站后台、敏感文件(如 admin.php、backup.zip)。
  • 漏洞验证:发现未授权访问的 API 接口(如 /api/v1/users)。
  • 资产梳理:扫描企业网站的暴露面资产(如遗留测试页面)。

安装教程

pip install --upgrade dirsearch

或从源码安装:

python3 setup.py install

确保已安装 Python 环境及 pip 包管理工具。

基础使用

语法及参数

运行 python dirsearch.py -h 可查看帮助信息。常用参数如下:

参数说明
-u URL指定目标 URL
-l PATH从文件读取 URL 列表
-w WORDLISTS指定字典文件或目录
-e EXTENSIONS指定扫描扩展名(如 php,html)
-t THREADS设置线程数(默认 20)
--timeout SEC设置请求超时时间
--random-agent启用随机 User-Agent
--proxy PROXY
使用代理服务器
-o PATH输出结果到文件
--format FORMAT指定输出格式(json, csv, html 等)
-x CODES排除特定状态码
-i CODES仅包含特定状态码
-r递归扫描子目录
--delay SEC请求间隔延迟

常见命令示例

1. 扫描单个目标
python dirsearch.py -u http://example.com -e php,html -t 20
  • -u:指定目标网址。
  • -e:枚举 .php 和 .html 结尾的文件。
  • -t:限制线程数为 20。

示例输出:

[10:00:00] Starting scan...
[10:00:01] 200 - 123B /index.html
[10:00:03] 403 - 456B /admin/
[10:00:05] 200 - 789B /config.php
  • 200:资源存在且可访问。
  • 403:资源存在但无权限。
  • 404:资源不存在(默认不显示)。
2. 批量扫描
python dirsearch.py -l urls.txt -t 5 -e php

从 urls.txt 读取目标列表进行扫描。

3. 使用自定义字典
python dirsearch.py -u http://example.com -w /path/to/custom_wordlist.txt

使用用户提供的字典文件替代内置字典,提高针对性。

4. 过滤状态码
python dirsearch.py -u http://example.com --exclude-status 403,500

排除 403(禁止访问)和 500(服务器错误)的结果,聚焦有效资源。

5. 添加自定义 HTTP 头
python dirsearch.py -u http://example.com -H "Authorization: Bearer token"

模拟身份验证或绕过 WAF 防护。

6. 代理与延迟控制
python dirsearch.py -u http://example.com --proxy http://127.0.0.1:8080 --delay 2

通过代理隐藏 IP,并设置请求间隔避免触发限流。

7. 递归扫描
python dirsearch.py -u http://example.com --recursive -R 3

深度为 3 的递归扫描,深入探索目录结构。

8. 导出报告
python dirsearch.py -u http://example.com -o report.json --format json

将结果保存为 JSON 格式以便后续分析。

CTF 场景实战

在 CTF 比赛中,重点在于发现备份文件、配置文件及敏感目录。

python dirsearch.py -u http://目标网址 -e * -r -x 404 --full-url
  • -e *:扫描所有常见后缀。
  • -r:递归扫描。
  • -x 404:排除无效路径。
  • --full-url:显示完整 URL。

重点关注:

  1. 状态码 200:直接存在的文件/目录。
  2. 备份文件:如 index.php~、.swp 文件。
  3. 压缩包:如 backup.zip、source.tar.gz。
  4. robots.txt:可能暴露敏感路径。

注意事项

  1. 合法合规:仅对授权目标使用,未经允许扫描他人网站可能违法。
  2. 频率控制:避免频繁扫描导致被 WAF 拦截,建议调整线程数或增加延迟。
  3. 字典优化:根据目标 CMS 类型选择专用字典提升效率。
  4. 结果分析:结合响应大小和内容判断资源有效性。

目录

  1. 项目介绍
  2. 核心功能
  3. 适用场景
  4. 安装教程
  5. 基础使用
  6. 语法及参数
  7. 常见命令示例
  8. 1. 扫描单个目标
  9. 2. 批量扫描
  10. 3. 使用自定义字典
  11. 4. 过滤状态码
  12. 5. 添加自定义 HTTP 头
  13. 6. 代理与延迟控制
  14. 7. 递归扫描
  15. 8. 导出报告
  16. CTF 场景实战
  17. 注意事项

更多推荐文章

查看全部
  • Happy Coder:Claude Code 的移动端与 Web 客户端
  • 字节开源 DeerFlow 2.0:Super Agent 运行时基础设施详解
  • Git 远程操作与标签管理实战指南
  • Python 网络爬虫原理与 Selenium 实战指南
  • Python 核心应用实战:数据分析与自动化脚本开发指南
  • TRAE vs Qoder vs Cursor vs GitHub Copilot 深度对比与选型指南
  • 中小团队低成本搭建项目管理系统:基于 Ubuntu 的 Dootask 私有化部署
  • CameraLink 图像输出与采集时序详解(FPGA 开发)
  • C 语言指针与数组的深度关联及实战应用
  • C++ 笔试刷题 Day 16:字符串替换、神奇数及 DNA 序列
  • 转行 Python 工程师:学习路径与数据分析方向指南
  • Antigravity 工具实测:集成 Gemini 3 与 Claude 4.5 的 AI 编程 IDE
  • HTML 基础教程:后端开发者快速入门
  • Spring Boot 集成 MyBatis 操作数据库详解
  • Python 稳居 TIOBE 编程语言排行榜榜首
  • 使用 Trae AI 将设计稿自动生成前端代码指南
  • 普通人零基础进入 AIGC 大模型人形机器人赛道自学攻略与应用案例
  • AI 大模型入门教程:从零基础到精通
  • Linux 进程池原理与实现:从核心逻辑到代码实战
  • Python 接口、抽象基类与协议详解

相关免费在线工具

  • 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