NetSour 项目启动与配置教程

1. 项目目录结构及介绍

NetSour 项目的主要目录结构如下所示：

NetSour/
├── .github/
├── .gitignore
├── LICENSE
├── README.md
├── __init__.py
├── main.py
├── netsour_debug.log
├── requirements.txt
├── setup.py
└── test_main.py

• .github/：此目录用于存放 GitHub 相关的配置文件。
• .gitignore：用于指定 Git 忽略跟踪的文件和目录。
• LICENSE：项目使用的 AGPL-3.0 许可证文件。
• README.md：项目的说明文件，包含了项目的基本信息、功能、安装和使用方法等。
• __init__.py：Python 包的初始化文件，本项目中的此文件为空。
• main.py：项目的启动文件，包含了程序的主要逻辑。
• netsour_debug.log：用于记录调试信息的日志文件。
• requirements.txt：项目运行所需的 Python 包依赖列表。
• setup.py：用于打包和分发项目的配置文件。
• test_main.py：项目的单元测试文件。

2. 项目的启动文件介绍

项目的启动文件是 main.py。该文件包含了以下几个主要功能：

• is_root()：检查脚本是否以 root 权限运行。
• process_packet()：提取并格式化包信息。
• sniff_packets()：使用 Scapy 捕获网络包。
• detect_dos()：识别潜在的 DoS 攻击。
• display_packets()：管理主用户界面。
• analyze_packet()：为选定的包提供详细分析。

启动项目的命令为：

sudo python main.py

程序运行后，会提示用户输入网络接口名称，并使用箭头键导航捕获的包。用户可以按 'a' 键分析特定包，按 'q' 键退出应用程序。

3. 项目的配置文件介绍

项目的配置文件主要包括 .gitignore 和 requirements.txt。

• .gitignore：此文件列出了应该被 Git 忽略的文件和目录，例如日志文件、环境配置文件、以及其他不应该提交到版本控制系统的个人或临时文件。

• requirements.txt：此文件列出了项目运行所需的 Python 包依赖。用户可以通过以下命令安装所有依赖：

  pip install -r requirements.txt
  

确保安装了所有必需的依赖项后，就可以按照前面的步骤启动和运行项目了。