Ingram 项目安装与使用教程

1. 项目目录结构及介绍

Ingram 项目的目录结构如下：

Ingram/
├── .gitignore
├── LICENSE
├── README.en.md
├── README.md
├── requirements.txt
├── run_ingram.py
└── Ingram/
    ├── config.py
    ├── ...

目录结构说明

• .gitignore: 用于指定 Git 版本控制系统忽略的文件和目录。
• LICENSE: 项目的开源许可证文件，本项目使用 GPL-3.0 许可证。
• README.en.md: 英文版本的 README 文件，介绍项目的概况和使用方法。
• README.md: 中文版本的 README 文件，介绍项目的概况和使用方法。
• requirements.txt: 项目依赖的 Python 包列表，使用 pip 安装。
• run_ingram.py: 项目的启动文件，用于执行漏洞扫描任务。
• Ingram/: 项目的主要代码目录，包含配置文件和其他功能模块。

2. 项目的启动文件介绍

run_ingram.py 是 Ingram 项目的启动文件，负责执行漏洞扫描任务。以下是该文件的主要功能和使用方法：

主要功能

• 目标文件读取: 从指定的目标文件中读取要扫描的 IP 地址和端口。
• 漏洞扫描: 根据配置文件中的规则，对目标进行漏洞扫描。
• 结果输出: 将扫描结果保存到指定的输出目录中。

使用方法

python3 run_ingram.py -i 目标文件 -o 输出文件夹

• -i: 指定包含目标 IP 地址和端口的文件。
• -o: 指定扫描结果的输出目录。

可选参数

• -p: 指定要扫描的端口。
• -t: 指定并发扫描的进程数。
• -T: 指定请求的超时时间。
• --debug: 开启调试模式。

3. 项目的配置文件介绍

Ingram/config.py 是 Ingram 项目的配置文件，包含了扫描任务的各种配置选项。以下是该文件的主要内容和配置项：

主要配置项

• 默认端口: 定义了默认扫描的端口列表。
• 并发数: 定义了默认的并发扫描进程数。
• 超时时间: 定义了默认的请求超时时间。
• 调试模式: 是否开启调试模式。

配置示例

# 默认扫描端口
DEFAULT_PORTS = [80, 443, 8080, 8443]

# 默认并发数
DEFAULT_THREADS = 300

# 默认超时时间
DEFAULT_TIMEOUT = 5

# 调试模式
DEBUG_MODE = False

配置文件使用

在 run_ingram.py 中，可以通过命令行参数覆盖这些默认配置，例如：

python3 run_ingram.py -i 目标文件 -o 输出文件夹 -p 80 81 8000 -t 500 -T 10 --debug

以上命令将使用指定的端口、并发数、超时时间和调试模式进行扫描。