Pwnagotchi 项目安装与使用教程

Pwnagotchi 项目安装与使用教程

pwnagotchi (⌐■_■) - Deep Reinforcement Learning instrumenting bettercap for WiFi pwning. 项目地址: https://gitcode.com/gh_mirrors/pwnag/pwnagotchi

1. 项目的目录结构及介绍

Pwnagotchi 项目是一个开源的深度学习驱动黑客游戏，它使用神经网络来训练一个小机器人，使其能够自动执行无线渗透测试。以下是项目的目录结构及其简要介绍：

pwnagotchi/
├── data/                    # 存储项目数据，包括训练数据、模型文件等
├── docs/                    # 项目文档
├── firmware/                # 固件文件，用于部署到目标设备
├── html/                    # Web界面相关文件
├── img/                     # 项目图片文件
├── pwnagotchi/              # 核心代码目录
│   ├── __init__.py
│   ├── ai.py                # 深度学习模型相关代码
│   ├── agent.py             # 机器人代理逻辑
│   ├── config.py            # 配置文件解析
│   ├── display.py           # 显示相关代码
│   ├── game.py              # 游戏逻辑
│   ├── main.py              # 项目入口文件
│   ├── mqtt.py              # MQTT协议通信
│   ├── neural_network.py    # 神经网络相关代码
│   ├── stats.py             # 统计信息
│   └── utils.py             # 工具类函数
├── requirements.txt         # 项目依赖
├── tests/                   # 测试代码目录
└── README.md                # 项目说明文件

2. 项目的启动文件介绍

项目的启动文件是 pwnagotchi/main.py。这个文件是项目的入口点，它负责初始化并运行整个Pwnagotchi程序。以下是启动文件的主要内容：

# 导入必要的库和模块
from pwnagotchi import Pwnagotchi

def main():
    # 创建Pwnagotchi对象
    pwnagotchi = Pwnagotchi()

    # 启动Pwnagotchi
    pwnagotchi.run()

if __name__ == '__main__':
    main()

当你运行 python main.py 命令时，上述代码会被执行，程序会启动并开始运行Pwnagotchi。

3. 项目的配置文件介绍

项目的配置文件是 pwnagotchi/config.py。这个文件包含了程序运行时需要用到的各种配置信息，例如神经网络参数、MQTT服务器地址、显示设置等。以下是配置文件的一个示例：

# 默认配置
default_config = {
    'main': {
        'debug': False,
        'update_interval': 5.0,
        'training_interval': 30.0,
        'display': 'auto',
        'plugins': ['default'],
    },
    'wifi': {
        ' probes_file': 'data/probes.csv',
        'deauth threshold': 5,
    },
    'ai': {
        'model': 'mlp',
        'model_path': 'data/model',
        'trainings_per_epoch': 50,
    },
    'display': {
        'theme': 'default',
        'font': 'default',
        'language': 'en',
    },
    'mqtt': {
        'enabled': False,
        'host': 'localhost',
        'port': 1883,
        'username': None,
        'password': None,
    }
}

配置文件通常包含默认设置，用户可以根据自己的需求修改这些配置。修改配置后，重新启动程序以应用新的设置。

pwnagotchi (⌐■_■) - Deep Reinforcement Learning instrumenting bettercap for WiFi pwning. 项目地址: https://gitcode.com/gh_mirrors/pwnag/pwnagotchi