Scantron 项目常见问题解决方案

Scantron 项目常见问题解决方案

scantron A distributed nmap / masscan scanning framework complete with scan scheduling, engine pooling, subsequent scan port diff-ing, and an API client for automation workflows. 项目地址: https://gitcode.com/gh_mirrors/sc/scantron

项目基础介绍和主要编程语言

Scantron 是一个分布式的 nmap 和 masscan 扫描框架，旨在通过扫描调度、引擎池、后续扫描端口差异比较以及 API 客户端自动化工作流等功能，提供高效的网络扫描解决方案。项目主要由两个组件构成：

1. 控制台节点：包含一个用于调度扫描任务和存储扫描目标及结果的 Web 前端。
2. 引擎：从控制台拉取扫描任务并执行实际的扫描操作。

Scantron 项目主要使用 Python 3.6+ 进行开发，并采用了 Django 框架作为 Web 前端，Django REST Framework 作为 API 端点，PostgreSQL 作为数据库，Redis 作为任务队列，Postfix 用于发送扫描警报邮件。

新手使用项目时需要注意的3个问题及解决步骤

1. 环境配置问题

问题描述：新手在部署 Scantron 时，可能会遇到环境配置不正确的问题，导致项目无法正常运行。

解决步骤：

• 步骤1：确保系统满足项目的基本要求，建议使用 Ubuntu 18.04 或更高版本。
• 步骤2：安装 Python 3.6 或更高版本，并配置虚拟环境。
• 步骤3：按照项目提供的 Ansible 部署脚本进行自动化部署，确保所有依赖项正确安装。

2. 扫描任务调度失败

问题描述：新手在尝试调度扫描任务时，可能会遇到任务调度失败的情况，通常是由于 API 调用或任务队列配置不正确导致的。

解决步骤：

• 步骤1：检查控制台和引擎之间的网络连接是否正常，确保能够通过 REST API 进行通信。
• 步骤2：确认 Redis 任务队列是否正常运行，并检查任务队列的配置文件。
• 步骤3：使用项目提供的 API 客户端进行测试，确保能够成功调用 API 并调度扫描任务。

3. 扫描结果差异比较问题

问题描述：新手在使用 Scantron 进行扫描时，可能会遇到扫描结果差异比较功能无法正常工作的问题，通常是由于 pyndiff 库配置或邮件服务器配置不正确导致的。

解决步骤：

• 步骤1：确保 pyndiff 库已正确安装，并检查其配置文件是否正确。
• 步骤2：配置 Postfix 邮件服务器，确保能够正常发送邮件。
• 步骤3：在控制台中手动触发一次扫描任务，并检查是否能够成功生成扫描结果差异报告并通过邮件发送。

通过以上步骤，新手可以更好地理解和解决在使用 Scantron 项目时可能遇到的问题，确保项目能够顺利运行。

scantron A distributed nmap / masscan scanning framework complete with scan scheduling, engine pooling, subsequent scan port diff-ing, and an API client for automation workflows. 项目地址: https://gitcode.com/gh_mirrors/sc/scantron