psychoPATH 项目教程

psychoPATH 项目教程

psychoPATHpsychoPATH - an advanced path traversal tool. Features: evasive techniques, dynamic web root list generation, output encoding, site map-searching payload generator, LFI mode, nix & windows support, single byte generator, payload export.项目地址:https://gitcode.com/gh_mirrors/ps/psychoPATH

1. 项目目录结构及介绍

psychoPATH/
├── README.md
├── requirements.txt
├── psychoPATH/
│   ├── __init__.py
│   ├── core/
│   │   ├── __init__.py
│   │   ├── scanner.py
│   │   └── utils.py
│   ├── config/
│   │   ├── __init__.py
│   │   └── config.py
│   ├── tests/
│   │   ├── __init__.py
│   │   └── test_scanner.py
│   └── main.py
└── setup.py

• README.md: 项目介绍和使用说明。
• requirements.txt: 项目依赖的Python包列表。
• psychoPATH/: 项目的主目录。
  • init.py: 使psychoPATH成为一个Python包。
  • core/: 核心功能模块。
    • scanner.py: 扫描器的主要实现。
    • utils.py: 工具函数和辅助功能。
  • config/: 配置文件模块。
    • config.py: 配置文件的读取和设置。
  • tests/: 测试模块。
    • test_scanner.py: 扫描器的单元测试。
  • main.py: 项目的启动文件。
• setup.py: 项目的安装脚本。

2. 项目启动文件介绍

main.py

main.py 是项目的启动文件，负责初始化配置、加载扫描器并执行扫描任务。以下是 main.py 的主要功能：

import argparse
from psychoPATH.core.scanner import Scanner
from psychoPATH.config.config import Config

def main():
    parser = argparse.ArgumentParser(description="psychoPATH - Web Application Path Scanner")
    parser.add_argument('--url', required=True, help="Target URL to scan")
    parser.add_argument('--config', default='config.json', help="Path to configuration file")
    args = parser.parse_args()

    config = Config(args.config)
    scanner = Scanner(config)
    scanner.scan(args.url)

if __name__ == "__main__":
    main()

• argparse: 解析命令行参数，包括目标URL和配置文件路径。
• Config: 从配置文件中读取配置信息。
• Scanner: 初始化扫描器并执行扫描任务。

3. 项目的配置文件介绍

config.py

config.py 负责读取和解析配置文件，配置文件通常是一个JSON文件，包含扫描器的各种设置。以下是 config.py 的主要功能：

import json

class Config:
    def __init__(self, config_path):
        self.config_path = config_path
        self.config = self.load_config()

    def load_config(self):
        with open(self.config_path, 'r') as file:
            return json.load(file)

    def get_config(self):
        return self.config

• load_config: 从指定路径加载配置文件并解析为Python字典。
• get_config: 返回解析后的配置信息。

配置文件示例 (config.json)

{
    "threads": 10,
    "timeout": 5,
    "user_agent": "psychoPATH/1.0",
    "extensions": [".php", ".html", ".js"]
}

• threads: 扫描线程数。
• timeout: 请求超时时间。
• user_agent: 请求头中的User-Agent。
• extensions: 扫描时考虑的文件扩展名。

通过以上配置，psychoPATH 可以根据用户的需求进行灵活的扫描设置。

psychoPATHpsychoPATH - an advanced path traversal tool. Features: evasive techniques, dynamic web root list generation, output encoding, site map-searching payload generator, LFI mode, nix & windows support, single byte generator, payload export.项目地址:https://gitcode.com/gh_mirrors/ps/psychoPATH