Dirsearch 是一个用于探测Web服务器上的隐藏目录和文件的工具。它通过发送HTTP请求来尝试访问可能存在的路径，从而找到不列在网站目录页面上的隐藏资源。

Dirsearch 的主要特点包括：

1.多线程：Dirsearch 采用多线程方式进行目录扫描，充分利用系统资源提高扫描效率。
2.字典支持：它支持使用自定义字典文件来进行目录爆破，你可以使用自己的字典文件或使用内置的常用字典。（注：字典必须是文本文件）
3.支持多种形式的网页（asp，php）
4.支持HTTP代理
5.启发式检测无效的网页
6.指定扩展名：你可以选择限制扫描的文件扩展名范围，以便更加精确地进行目录扫描。
7.进度追踪：Dirsearch 提供实时进度追踪，你可以看到当前扫描的进度和已发现的目录和文件。
8.结果输出：完成扫描后，Dirsearch 会生成详细的扫描报告（纯文本，JSON），展示已发现的隐藏目录和文件。

由于dirsearch是基于python3的，所以需保证本机含有python3环境。

python3环境读者可自行安装配置，本文不再赘述。

注意，当同时存在python3和python2时，要将两者的exe文件重命名为下图：

python3改为python.exe，python2改为python2.exe即可。

dirsearch下载地址： https://github.com/maurosoria/dirsearch

将zip包解压后放入python3的Dirsearch目录中

接着进入 C:\Python3\Dirsearch\dirsearch-master目录中，输入cmd：

即

进入命令行后，输入 PIP3 install DirSearch

下载失败，但我们看一下警告：

这个警告表示当前使用的 pip 版本为 21.2.4，但是还有更新的版本可用（版本号为 23.0），建议通过命令 C:\Python3\python.exe -m pip install --upgrade pip 来升级 pip。

于是我们输入 C:\Python3\python.exe -m pip install --upgrade pip

但还是下载失败，原因是依赖项未升级。

因此我们输入 pip install --upgrade -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

该命令会根据 requirements.txt 文件中列出的依赖项，自动安装或升级所需的包，并使用指定的阿里云镜像源来获取依赖项的安装文件。

下载成功：

现在，就可以开始正常使用dirsearch了。

接下来将介绍dirsearch的使用方法。

注意：dirsearch的命令必须在C:\Python3\Dirsearch\dirsearch-master目录下运行

输入 python dirsearch.py -h得到dirsearch帮助

用法：dirsearch.py [-u|--url] 目标 [-e|--extensions] 扩展名 [选项]

选项:
–version 显示程序的版本号并退出
-h, --help 显示此帮助消息并退出

必需：
-u URL, --url=URL 目标URL，可以使用多个选项指定多个目标URL
-l PATH, --urls-file=PATH
URL列表文件
–stdin 从标准输入读取URL
–cidr=CIDR 目标CIDR
–raw=PATH 从文件加载原始HTTP请求（使用’–scheme’标志设置方案）
-s SESSION_FILE, --session=SESSION_FILE
会话文件
–config=PATH 配置文件路径（默认为’DIRSEARCH_CONFIG’环境变量，否则为’config.ini’）

字典设置:
-w WORDLISTS, --wordlists=WORDLISTS
单词列表文件或包含单词列表文件的目录（以逗号分隔）
-e EXTENSIONS, --extensions=EXTENSIONS
扩展名列表，以逗号分隔（例如：php,asp）
-f, --force-extensions
在每个单词列表条目的末尾添加扩展名。默认情况下，dirsearch只替换%EXT%关键字为扩展名。
-O, --overwrite-extensions
使用指定的扩展名覆盖单词列表中的其他扩展名（通过’-e’选择）
–exclude-extensions=EXTENSIONS
排除的扩展名列表，以逗号分隔（例如：asp,jsp）
–remove-extensions 删除所有路径中的扩展名（例如：admin.php -> admin）
–prefixes=PREFIXES 将自定义前缀添加到所有单词列表条目中（以逗号分隔）
–suffixes=SUFFIXES 将自定义后缀添加到所有单词列表条目中，忽略目录（以逗号分隔）
-U, --uppercase 单词列表转为大写
-L, --lowercase 单词列表转为小写
-C, --capital 单词首字母大写

通用设置:
-t THREADS, --threads=THREADS
线程数
-r, --recursive 递归地进行强制破解
–deep-recursive 在每个目录深度上执行递归扫描（例如：api/users -> api/）
–force-recursive 对找到的每个路径执行递归强制破解，而不仅仅是目录
-R DEPTH, --max-recursion-depth=DEPTH
最大递归深度
–recursion-status=CODES
用于执行递归扫描的有效状态码，支持范围（以逗号分隔）
–subdirs=SUBDIRS 扫描给定URL的子目录（以逗号分隔）
–exclude-subdirs=SUBDIRS
在递归扫描期间排除以下子目录（以逗号分隔）
-i CODES, --include-status=CODES
包括的状态码，以逗号分隔，支持范围（例如：200,300-399）
-x CODES, --exclude-status=CODES
排除的状态码，以逗号分隔，支持范围（例如：301,500-599）
–exclude-sizes=SIZES
根据大小排除响应，以逗号分隔（例如：0B,4KB）
–exclude-text=TEXTS 根据文本排除响应，可以使用多个标志
–exclude-regex=REGEX
根据正则表达式排除响应
–exclude-redirect=STRING
如果此正则表达式（或文本）与重定向URL匹配，则排除响应（例如：‘/index.html’）
–exclude-response=PATH
排除类似于此页面响应的响应，路径作为输入（例如：404.html）
–skip-on-status=CODES
每当命中这些状态码之一时跳过目标，以逗号分隔，支持范围
–min-response-size=LENGTH
响应的最小长度
–max-response-size=LENGTH
响应的最大长度
–max-time=SECONDS 扫描的最大运行时间
–exit-on-error 发生错误时退出

请求设置:
-m METHOD, --http-method=METHOD
HTTP请求方法（默认为GET）
-d DATA, --data=DATA HTTP请求数据
–data-file=PATH 包含HTTP请求数据的文件
-H HEADERS, --header=HEADERS
HTTP请求标头，可以使用多个标志
–headers-file=PATH 包含HTTP请求标头的文件
-F, --follow-redirects
跟随HTTP重定向
–random-agent 每个请求选择一个随机User-Agent
–auth=CREDENTIAL 认证凭据（例如：user:password或bearer token）
–auth-type=TYPE 认证类型（basic、digest、bearer、ntlm、jwt）
–cert-file=PATH 包含客户端证书的文件
–key-file=PATH 包含客户端证书私钥的文件（未加密）
–user-agent=USER_AGENT
–cookie=COOKIE

连接设置:
–timeout=TIMEOUT 连接超时时间
–delay=DELAY 请求之间的延迟
-p PROXY, --proxy=PROXY
代理URL（HTTP/SOCKS），可以使用多个标志
–proxies-file=PATH 包含代理服务器的文件
–proxy-auth=CREDENTIAL
代理认证凭据
–replay-proxy=PROXY 用于重放已发现路径的代理
–tor 使用Tor网络作为代理
–scheme=SCHEME 原始请求的协议或URL中没有协议时使用的协议（默认为自动检测）
–max-rate=RATE 每秒请求数最大值
–retries=RETRIES 失败请求的重试次数
–ip=IP 服务器IP地址

高级设置:
–crawl 在响应中爬取新路径

显示设置:
–full-url 在输出中显示完整URL（在静默模式下自动启用）
–redirects-history 显示重定向历史记录
–no-color 不使用彩色输出
-q, --quiet-mode 安静模式

输出设置:
-o PATH/URL, --output=PATH/URL
输出文件或MySQL/PostgreSQL数据库URL（格式：
scheme://[username:password@]host[:port]/database-
name）
–format=FORMAT 报告格式（可用：simple、plain、json、xml、md、csv、html、
sqlite、mysql、postgresql）
–log=PATH 日志文件

Dirsearch具体实战可参考CTF赛题： 极客大挑战PHP解题详析 【Dirsearch使用实例+php反序列化】

本文举个简单的渗透例子：

在C:\Python3\Dirsearch\dirsearch-master路径下输入 python dirsearch.py -u http://101.43.57.52:41080/ (某题目地址)

得到如下结果：

成功发现该网站目录页面上的隐藏资源，之后进行访问等操作即可实现命令执行等。

以上为Dirsearch 工具的安装、使用详细教程，读者可结合官方文档躬身实践。