Project Pwnag0dchi

多くの人がカスタマイズされたプラグインや設定について尋ねてきたので、これを作成しました。このガイドに従えば、あなたのPwnagotchiは、私のSNSやYouTube動画で見られるものとまったく同じように、約5分以内にセットアップできます。

また、ここには完全なPwnagotchi初心者向けビルドガイドと、一般的なトラブルシューティング方法も含まれています。

可能な限り更新を続けます。提案がある場合や、このプロジェクトで問題が発生した場合は、GitHub Issueを開いてください。一緒に話し合いましょう！

目次

• Project Pwnag0dchi Modifications
  • Features
  • Showcase & Tutorial Video
  • Installing Project Pwnag0dchi
    • Login Credentials (Web UI)
    • Initial settings to be changed

---

• Pwnagotchi Noob Guide
  • Parts To Get
  • Installation
  • SSH / Web UI Access Setup
  • FTP Access Setup
  • Setting Up Internet-Sharing
  • Local Handshake Cracking
  • Bluetooth Tethering Setup
  • Using External Wi-Fi Adapters
    • Enabling External Wi-Fi Adapter
    • Disabling External Wi-Fi Adapter

---

• Additional Customizations
  • Custom Faces
  • Massive Plugins List

---

• Troubleshooting
  • Internet Sharing Not Working
  • Can't connect 'gotchi to computer since switching to external adapter
  • Deauths even when "enable_deauth" plugin disabled
  • Associations even when "enable_assoc" plugin disabled
  • I got the tri-color variant of the Waveshare screen, and it sucks. Now what?
  • I don't like dark mode, how do I make the UI white like default?
  • memtemp-plus elements get cut-off

---

Project Pwnag0dchi Modifications

特徴

• ハンドシェイクが見つかると、デバイス上で辞書攻撃を自動的に実行（カスタマイズされた小さなワードリストを使用）
• アソシエーション攻撃とディオーセンティケーション攻撃を個別にオン/オフして、3つの攻撃アプローチから選択可能：
  • 完全攻撃的（アソシエーション + ディオーセンティケーション攻撃）
  • やや攻撃的（アソシエーション攻撃またはディオーセンティケーション攻撃のいずれか）
  • 完全パッシブ（攻撃なし、パッシブハンドシェイクキャプチャのみ）
• Web UIからハンドシェイクをダウンロード可能（修正済み）
• UI要素を徹底的に調整（位置、サイズ、フォントなど）
  • 「CH」の値にスペースを追加し、5GHzチャンネルが重複しないように対応
• プラグインの修正（見た目を整え、整理し、機能を若干改善（かもしれない））
• 画面に追加された情報：
  • 最新の解読済みハンドシェイクを平文で表示（WPA-secによる）
  • レベルとXPバー（ハンドシェイクを収集してXPを獲得し、レベルアップ）
  • 有効な攻撃（アソシエーション、ディオーセンティケーション、両方、またはなし）
  • ハードウェアモニタリング（現在のメモリ使用量、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 にコピー＆ペーストする際、キーの先頭や末尾にスペースがないことを確認してください

4. sudo systemctl restart pwnagotchi.service を実行して変更を適用するためにPwnagotchiサービスを再起動します。Web UIでは、webcfgプラグインの上部にある「Save and Restart」をクリックして行うこともできます

---

---

Pwnagotchi 初心者ガイド

必要なパーツ

• Waveshare 2.13インチ e-Inkディスプレイ（Amazon | Waveshare）

  • バージョン3と4が最適です。これは基板上の小さな丸いシールで示されています（こんな感じ）
  • 基板に印刷されている「Rev2.1」は無視してください。バージョンとは関係ありません
  • 黒/白/赤の3色バリアント（バリアント「B」）は購入しないでください。黒/白バージョンのみを購入してください。両方とも見た目はほぼ同じで価格も同じなので、間違って購入しやすいです

• Raspberry Pi Zero W - はんだ付けが必要（Amazon | Raspberry Pi）

• または Raspberry Pi Zero WH - はんだ付け不要（Amazon | 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 でアクセスできるようにする

チュートリアル: https://youtu.be/7nj5Euo5Bng?t=135

注意: 2:15から4:31までだけ従ってください

注意: RNDISドライバーを手動でインストールする必要がある場合は、このGitHubリポジトリ（「RNDIS Driver」ディレクトリ）からダウンロードしてください

ssh [email protected] または短く ssh [email protected]（パスワード = raspberry）

FTP でアクセスできるようにする

rootユーザーとしてPwnagotchiにFTP接続するには、最初にrootユーザーアカウントを初期化し、rootのFTPログインを有効にする必要があります：