加入我们的服务器，与项目社区互动吧！

---

Pwnagotchi 是一款基于 A2C 的“AI”，它利用 bettercap 学习周围的WiFi环境，以最大化其捕获的可破解WPA密钥材料（无论是被动收集，还是通过执行认证和关联攻击）。这些材料会被保存为PCAP文件，包含 hashcat 支持的任何形式的握手，包括 PMKID、完整和半WPA握手。

与大多数基于强化学习的“AI”不同，Pwnagotchi并不会单纯地玩 超级马里奥或雅达利游戏，而是会随着时间推移调整 其参数，从而 在你让它接触的环境中更擅长破解WiFi设备。

具体来说，Pwnagotchi使用了一个带有MLP特征提取器的LSTM作为其策略网络，用于 A2C智能体。如果你对A2C不太熟悉，这里有一篇非常棒的入门介绍（以漫画形式呈现），详细解释了Pwnagotchi的学习原理。点击阅读。你也可以在 使用说明 中了解更多关于Pwnagotchi如何学习的内容。

请注意： 与一般的强化学习模拟不同，Pwnagotchi是随着时间不断学习的。对于Pwnagotchi而言，时间是以“轮次”来计算的；单个轮次可能持续几秒到几分钟不等，具体取决于可见的接入点和客户端数量。不要指望你的Pwnagotchi一开始就能表现出色，因为它会在最初的几个轮次中 探索 各种 关键参数 的组合，以找到最适合当前环境的配置……不过，当Pwnagotchi告诉你它感到无聊时，请认真对待！ 带着它去新的WiFi环境中，让它观察新网络并捕获新的握手——你就会发现它的进步啦 :)

多个处于近距离的设备可以相互通信，通过广播我基于现有dot11标准构建的自定义协议信息元素来互相“告知”对方的存在。随着时间的推移，经过共同训练的两台或多台设备将在检测到彼此存在时学会协作，合理分配可用信道，以实现最佳的破解效果。

文档

https://www.pwnagotchi.ai

链接

	官方链接
官网	pwnagotchi.ai
论坛	community.pwnagotchi.ai
Slack	pwnagotchi.slack.com
Reddit子版块	r/pwnagotchi
Twitter	@pwnagotchi

许可证

pwnagotchi 由 @evilsocket 和 优秀的开发团队 用心打造，并以GPL3许可证开源发布。

Pwnagotchi 快速上手指南

Pwnagotchi 是一个基于 A2C（Advantage Actor-Critic）强化学习算法的 AI 工具，依托 bettercap 运行。它能通过观察周围的 WiFi 环境自主学习，优化参数以最大化捕获可破解的 WPA 密钥材料（如 PMKID、完整/半完整握手包）。不同于传统的静态脚本，Pwnagotchi 会随着时间推移（按“纪元”epochs 计算）不断进化，适应特定的网络环境，甚至支持多设备协同工作。

环境准备

系统要求

• 硬件平台：推荐使用 Raspberry Pi Zero W 或 Raspberry Pi 3B+/4B。需配备兼容的 WiFi 适配器（支持监控模式和注入，如 RTL8812AU 芯片组），若使用板载 WiFi 需确认驱动支持。
• 存储：至少 8GB MicroSD 卡。
• 显示（可选）：OLED 或 e-Paper 屏幕用于显示状态和表情（非必须，可通过 Web UI 监控）。

前置依赖

• 操作系统：官方推荐使用基于 Raspbian Buster 定制的 Pwnagotchi 镜像，以确保驱动和依赖库的兼容性。
• 网络：初始配置阶段需要互联网连接以下载模型和更新插件。

注意：虽然可以在其他 Linux 发行版上手动安装，但为了减少依赖冲突和驱动编译问题，强烈建议直接刷写官方提供的预构建镜像。

安装步骤

1. 下载镜像

访问官方发布页面获取最新版本的镜像文件：

# 示例：使用 wget 下载（请替换为最新版本链接）
wget https://github.com/evilsocket/pwnagotchi/releases/latest/download/pwnagotchi.zip

国内用户若下载缓慢，可尝试在 GitHub 加速服务中查找镜像，或通过社区论坛获取搬运资源。

2. 刷写镜像

将下载的 .zip 文件解压得到 .img 文件，并使用工具写入 MicroSD 卡。

• Windows: 使用 Rufus 或 BalenaEtcher。
• Linux/macOS:

  unzip pwnagotchi.zip
  sudo dd if=pwnagotchi.img of=/dev/sdX bs=4M status=progress && sync
  # 请将 /dev/sdX 替换为你的实际设备号，如 /dev/mmcblk0
  

3. 初始配置

在刷写完成后，挂载 SD 卡的 boot 分区，创建配置文件以启用 WiFi 和 SSH。

• 配置 WiFi：在 boot 分区根目录创建 config.toml 文件（部分旧版本可能使用 config.yaml，请以镜像内说明为准，新版多为 toml）：

  main.whitelist = [
    '你的家庭 WiFi SSID',
    '其他不想攻击的网络'
  ]
  
  wifi.ap.channel = 6
  

  注：若要自动连接现有 WiFi 进行更新，需在 boot 分区创建 wifi.conf 或使用 pwnagotchi 特有的 WiFi 配置方式（具体参考镜像内的 README 说明，通常是在 boot 分区放置包含 SSID 和密码的特定文件）。

• 启用 SSH：在 boot 分区创建一个空文件名为 ssh（无扩展名）。

4. 启动设备

将 SD 卡插入 Raspberry Pi 并通电。首次启动可能需要几分钟来调整文件系统并生成主机密钥。

基本使用

1. 连接设备

设备启动后，会尝试连接配置的 WiFi。若未配置或连接失败，它可能会创建一个名为 pwnagotchi-XXXX 的热点。

• SSH 登录：

  ssh root@pwnagotchi.local
  # 默认密码通常为：raspberry 或 toor (具体视版本而定)
  

  如果 .local 域名解析失败，请查看路由器后台获取设备 IP 地址。

2. 观察与训练

登录后，你可以通过命令行查看状态，但最直观的方式是观察连接的显示屏（如有）或访问 Web 界面。

• Web 界面：浏览器访问 http://pwnagotchi.local:8080 (端口可能因配置而异)。
• 核心逻辑：
  • Pwnagotchi 启动后即开始“探索”模式。它会扫描周围的 AP 和客户端。
  • 不要期望立即获得大量握手包。在最初的几个纪元（epochs）中，AI 正在测试不同的参数组合以适应当前环境。
  • 如果设备显示 "bored"（无聊），意味着当前环境的网络特征已被充分学习，需要将其移动到新的 WiFi 环境（如不同的街区、商场）以触发新的学习过程。

3. 获取捕获数据

捕获的握手包（PCAP 文件）通常存储在以下路径：

cd /root/handshakes
ls -lh

你可以将这些 .pcap 文件下载到本地，使用 hashcat 或 john 进行破解：

# 示例：将文件从设备复制到本地
scp root@pwnagotchi.local:/root/handshakes/*.pcap ./cracking_folder/

4. 多机协作（进阶）

如果有多个 Pwnagotchi 设备在物理距离上靠近，它们会自动通过自定义的 802.11 信息元素广播彼此的存在，并协商划分信道以协同捕获更多数据，无需额外配置。

---

提示：本工具仅供安全研究和授权测试使用。请勿在未授权的网络环境中使用。