Project Pwnag0dchi

创建这个项目是因为很多人都询问我使用的自定义插件和配置。按照本指南，你的 Pwnagotchi 将在约5分钟内与我在社交媒体和 YouTube 视频中的外观完全一致。

你还会在这里找到一份完整的 Pwnagotchi 新手构建指南以及一些常见的故障排除方法。

我会尽可能持续更新。如果你有任何建议或在使用本项目时遇到问题，请提交一个 GitHub Issue，我们可以一起讨论！

目录

• Project Pwnag0dchi 修改
  • 功能特性
  • 展示与教程视频
  • 安装 Project Pwnag0dchi
    • 登录凭据 (Web UI)
    • 需要更改的初始设置

---

• Pwnagotchi 新手指南
  • 所需配件
  • 安装
  • SSH / Web UI 访问设置
  • FTP 访问设置
  • 设置网络共享
  • 本地握手包破解
  • 蓝牙共享设置
  • 使用外部 Wi-Fi 适配器
    • 启用外部 Wi-Fi 适配器
    • 禁用外部 Wi-Fi 适配器

---

• 其他自定义
  • 自定义表情
  • 海量插件列表

---

• 故障排除
  • 网络共享不工作
  • 切换到外部适配器后无法通过 USB 连接'gotchi 到电脑
  • 禁用了 "enable_deauth" 插件后仍在发送解除认证帧
  • 禁用了 "enable_assoc" 插件后仍在关联
  • 我买的是三色版 Waveshare 屏幕，效果很差，怎么办？
  • 我不喜欢暗色模式，如何将 UI 恢复为默认白色？
  • memtemp-plus 元素被截断

---

Project Pwnag0dchi 修改

功能特性

• 在发现握手包后，自动在设备上进行字典攻击（使用自定义的小型字典）
• 单独开关关联攻击和解除认证攻击，可选择三种攻击方式之一：
  • 完全激进（关联 + 解除认证攻击）
  • 较低激进（仅关联或仅解除认证攻击）
  • 完全被动（无攻击，仅被动捕获握手包）
• 可从 Web UI 下载握手包（已修复）
• UI 元素经过大量调整（位置、大小、字体等）
  • "CH" 值增加空格以适应 5GHz 频道而不重叠
• 插件修改（为了美观、精简以及略微改进的功能（可能））
• 屏幕新增信息：
  • 最新破解的握手包明文（来自 WPA-sec）
  • 等级与经验条（收集握手包获取经验并升级）
  • 已启用的攻击（关联、解除认证、两者皆启或两者皆禁）
  • 硬件监控（当前内存使用率、CPU 使用率、CPU 频率和温度）
  • 互联网连接/共享状态
  • 当前接口的 IP 地址（有助于通过 SSH / web UI 连接）
• 还有一些我可能忘记的内容

炫酷功能展示与教程视频

安装 Project Pwnag0dchi

1. 将此 GitHub 仓库中 "Plugins" 目录下的文件复制到 /usr/local/share/pwnagotchi/custom-plugins/
2. 将此 GitHub 仓库中 "Configurations" 目录下的文件复制到 /etc/pwnagotchi/
3. 重启你的 Pwnagotchi 以应用所有更改

登录凭据 (Web UI)

changeme:changeme

需要更改的初始设置

通过 Web UI：插件 > webcfg

通过 /etc/pwnagotchi/config.toml

然后进行以下添加/修改：

1. main.name 设置为你想要给你的 Pwnagotchi 命名的名称（例如：Pwnag0dchi）
2. main.whitelist.#0 和 main.plugins.grid.exclude 应设置为你家 Wi-Fi 网络的 SSID，这样你的 Pwnagotchi 就不会攻击它（例如：Shuriken-WiFi_2.4GHz）
3. main.plugins.wpa-sec.api_key 应设置为你的 WPA-sec API 密钥（请先访问此处并点击 "Get key" 获取免费 API 密钥，密钥会通过电子邮件发送给你）

   注意：将 API 密钥复制粘贴到 main.plugins.wpa-sec.api_key 时，确保 API 密钥的开头或结尾没有空格

4. 使用 sudo systemctl restart pwnagotchi.service 重启 Pwnagotchi 服务以应用更改。在 Web UI 上，可以通过在 webcfg 插件中点击顶部的 "Save and Restart" 来完成

---

---

Pwnagotchi 新手指南

所需配件

• Waveshare 2.13 英寸电子墨水显示屏（亚马逊 | Waveshare）

  • 版本 3 和 4 效果最好。版本信息通过电路板上的一个小圆形贴纸标识（类似这样）
  • 忽略电路板上印刷的 "Rev2.1"，这跟版本无关
  • 不要购买黑/白/红三色变体（变体 "B"）。只购买黑/白版本。两者外观非常相似且价格相同，所以很容易买错

• Raspberry Pi Zero W - 需要焊接（亚马逊 | Raspberry Pi）

• 或者 Raspberry Pi Zero WH - 无需焊接（亚马逊 | Adafruit）

  • 这是预焊好排针的同一块板子（WH 中的 H 代表 "Headers" 排针）
  • WH 变体可能比 W 更难找到

• Micro-SD 卡 — 16GB 最佳，必须为 "UHS-I" 等级

安装

1. 将 Waveshare 显示屏连接到 Pi Zero（硬件部分完成！）
2. 下载 jayofelony 的 v2.8.9 发布镜像（经过充分测试）或 v2.9.3 发布镜像（在测试范围内可用）
3. 下载/安装 Balena Etcher
4. 将 Pwnagotchi 的 micro-SD 卡插入读卡器，再插入电脑
5. 打开 Balena Etcher
6. 选择下载的 Pwnagotchi 镜像文件
7. 仔细选择插入的 micro-SD 卡
8. 刷写！
9. 刷写完成后，将 micro-SD 卡插入 Pwnagotchi 并开机
10. 首次启动时，你的 Pwnagotchi 需要一些时间进行初始化（2 到 30 分钟不等）。在此初始化期间，如果显示屏空白或显示 "Generating keys, do not turn off..." 消息，请不要惊慌。一旦此过程完成，你的 Pwnagotchi 会自动重启并准备就绪

    注意：这仅适用于首次启动。以后每次启动只需等待约 2-3 分钟

11. 它活了！

通过 SSH / Web UI 访问 Pwnagotchi

教程：https://youtu.be/7nj5Euo5Bng?t=135

注意：仅关注 2:15 到 4:31

注意：如果需要手动安装 RNDIS 驱动，请从此 GitHub 仓库（"RNDIS Driver" 目录）下载

ssh [email protected] 或简写 ssh [email protected]（密码 = raspberry）

通过 FTP 访问 Pwnagotchi

要以 root 用户通过 FTP 访问你的 Pwnagotchi，首先需要初始化 root 用户帐户并启用 root FTP 登录：

1. 以 pi 用户通过 SSH 登录你的 Pwny（按常规操作）
2. sudo passwd root
3. 如果提示，输入 pi 用户的密码（raspberry）
4. 为 root 用户输入新密码
5. 保存并退出。现在你有了 root 用户。接下来启用 root FTP 登录
6. sudo nano /etc/ssh/sshd_config

   注意：是 sshd_config，不是 ssh_config

7. 将 PermitRootLogin prohibit-password 行改为 PermitRootLogin yes，如果该行被注释，则取消注释（去掉行首的 #）
8. 保存并退出
9. sudo service ssh restart

教程：https://www.youtube.com/watch?v=X-5jN0WjurQ&t=88s

设置网络共享（为 Pwnagotchi 提供互联网访问）

1. 连接你的 Pwnagotchi（数据端口，非电源端口）
2. 从本 GitHub 仓库下载 win_connection_share.ps1（"Internet Sharing" 目录）
3. 以管理员身份打开 PowerShell（右键单击 > "Run as administrator"）
4. cd .\Downloads\
5. .\win_connection_share.ps1 -SetPwnagotchiSubnet
6. 重启 Windows 机器
7. .\win_connection_share.ps1 -EnableInternetConnectionSharing
8. 开始 > 输入 "network" > "查看网络连接"
9. 右键单击你的 Pwnagotchi 的 RNDIS > 属性 > IPv4 配置 > 手动重新添加静态 IP（10.0.0.1, 255.255.255.0, 10.0.0.1, 8.8.8.8）
10. 右键单击你的主以太网 > 属性 > "共享" 选项卡 > 勾选两个复选框 + 为你的 Pwnagotchi 的 RNDIS 选择共享 > 确定
11. 重新连接 Pwnagotchi（数据端口，非电源端口）
12. 命令提示符 > ssh [email protected]（密码 = raspberry）
13. 等待 Pwnagotchi 完全初始化后，使用 ping google.com 确认互联网连接

仍然没有互联网？

1. sudo chattr +i /etc/resolv.conf
2. sudo nano /etc/resolv.conf
3. 该文件的内容应该只有这一行： nameserver 8.8.8.8