# 目录扫描工具

**Repository Path**: youmulijiang/dirScan

## Basic Information

- **Project Name**: 目录扫描工具
- **Description**: 新疆政法大学培训-工具开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-28
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 目录扫描器

基于Python的多线程目录扫描工具，用于安全测试中发现网站的隐藏目录和敏感文件。

## 功能特点

- 多线程扫描（支持自定义线程数）
- 支持自定义字典文件
- 实时显示扫描进度
- 输出格式：`[时间] 状态码 - 长度 - 路径`
- 支持自定义超时设置
- 异常处理机制

## 安装依赖

```bash
pip install -r requirements.txt
```

## 使用方法

```bash
# 基础扫描
python scanner.py -u http://example.com

# 使用自定义字典和线程数
python scanner.py -u http://example.com -d custom.txt -t 20

# 设置超时时间
python scanner.py -u http://example.com --timeout 5
```

## 命令行参数

- `-u, --url`: 目标URL地址（必需）
- `-d, --dict`: 字典文件路径（默认：dicts/common.txt）
- `-t, --threads`: 线程数量（默认：10）
- `--timeout`: 请求超时时间，单位秒（默认：3）
- `-h, --help`: 显示帮助信息

## 输出示例

```
============================================================
           目录扫描器 v1.0
============================================================
[+] 目标: http://example.com
[*] 字典: dicts/common.txt
[*] 线程: 10
[*] 超时: 3s
============================================================

[11:11:09] 200 - 151B - /favicon.ico
[11:11:09] 403 - 162B - /admin
[11:11:10] 301 - 0B - /backup/

[*] 扫描完成! 共扫描 99 个路径，发现 3 个有效路径
```

## 项目结构

```
目录扫描器/
├── scanner.py              # 主程序入口
├── core/                    # 核心模块
│   ├── scanner.py          # 扫描器核心类
│   └── request.py          # HTTP请求处理
├── utils/                   # 工具模块
│   ├── dict_loader.py      # 字典加载
│   └── output.py           # 输出格式化
├── config/                  # 配置模块
│   └── settings.py         # 全局配置
├── dicts/                  # 字典文件
│   └── common.txt          # 常见路径字典
└── requirements.txt        # 依赖文件
```

## 技术栈

- Python 3.7+
- requests - HTTP请求库
- threading - 多线程支持
- argparse - 命令行参数解析

## 注意事项

⚠️ 仅用于授权的安全测试，未经许可扫描他人网站属于违法行为。

## 许可证

MIT License