Scapy-fakeap 使用教程

1. 项目目录结构及介绍

Scapy-fakeap 是一个使用 Python 和 Scapy 实现的伪无线接入点（AP）项目。该项目的主要目录结构如下：

• examples/: 包含一些示例脚本，用于展示如何使用 scapy-fakeap 创建和运行一个伪无线接入点。
• fakeap/: 包含项目的核心代码，包括伪接入点的实现和相关的回调函数。
• .gitignore: 指定 Git 忽略的文件和目录。
• LICENSE: 项目的许可协议文件，采用 GPL-2.0 许可。
• README.md: 项目说明文件，包含项目的简介、安装步骤和使用示例。
• setup.py: 用于安装 scapy-fakeap 的 Python 脚本。

2. 项目的启动文件介绍

项目的启动主要通过 fakeap.py 文件中的 FakeAccessPoint 类来实现。以下是一个基本的启动示例：

from fakeap import *

# 创建并启动伪接入点
ap = FakeAccessPoint('mon0', 'Hello scapy-fakeap world!')
ap.run()

在这个例子中，'mon0' 是无线网卡在监控模式下创建的接口名称，'Hello scapy-fakeap world!' 是接入点的名称。ap.run() 会启动伪接入点，使其能够接收和响应无线网络请求。

3. 项目的配置文件介绍

Scapy-fakeap 的配置主要通过修改 fakeap.py 文件中的相关类和方法实现。以下是一些可以配置的选项：

• Callbacks(): 用于定义不同事件触发的回调函数，如接收数据包、probe 请求、认证请求等。
• cb_recv_pkt: 接收数据包时触发的回调函数。
• cb_dot11_probe_req: 收到 probe 请求时触发的回调函数。
• cb_dot11_auth: 收到认证请求时触发的回调函数。
• cb_dot11_assoc_req: 收到关联请求时触发的回调函数。

可以通过创建一个 Callbacks() 实例并为其指定不同的回调函数来定制伪接入点的行为。例如：

from fakeap import *

def custom_recv_pkt(packet):
    print("Received packet: ", packet)

# 创建回调实例并设置接收数据包的回调函数
callbacks = Callbacks()
callbacks.cb_recv_pkt = custom_recv_pkt

# 创建并启动伪接入点，使用自定义的回调
ap = FakeAccessPoint('mon0', 'Custom AP', callbacks=callbacks)
ap.run()

在这个例子中，每当伪接入点接收到一个数据包时，都会调用 custom_recv_pkt 函数打印出数据包信息。通过这种方式，用户可以根据自己的需求定制接入点的行为。