Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

付録:演習環境クイックスタート(DVWA / Juice Shop / crAPI)

本付録は、exercises/ 配下の演習環境(DVWA / Juice Shop / crAPI)を「起動 → 疎通確認 → 停止」まで最短で進めるための導線をまとめる。詳細な注意事項や補足は、各ディレクトリの README.md を参照する。

スクリプトで実行する場合(推奨)

演習環境の起動・停止は、scripts/ 配下の補助スクリプトでも実行できる。

例(DVWA を起動):

bash scripts/setup_exercises.sh dvwa

例(DVWA を停止):

bash scripts/cleanup_exercises.sh dvwa

共通の前提

  • 演習環境は意図的に脆弱である。必ずローカル環境(または許可された検証環境)でのみ利用する。
  • Docker Engine と docker compose(Compose v2)が利用可能であること。
  • ポート公開は 127.0.0.1 バインドを前提とし、外部ネットワークから到達できない構成で運用する。

Juice Shop(Part 2〜3)

  • ディレクトリ:exercises/juice-shop/
  • 起動:
cd exercises/juice-shop
docker compose up -d
  • アクセス:http://127.0.0.1:3000/
  • 停止:
docker compose down

DVWA(Part 2〜3)

  • ディレクトリ:exercises/dvwa/
  • 起動:
cd exercises/dvwa
docker compose up -d
  • アクセス:http://127.0.0.1:8081/
  • 停止:
docker compose down

補足:初回起動時は、画面の案内に従って DB 初期化(/setup.php)が必要になる場合がある。

crAPI(Part 4)

  • ディレクトリ:exercises/crapi/
  • 事前準備(推奨):.env を作成し、LISTEN_IP=127.0.0.1 を明示する。
cd exercises/crapi
cp .env.example .env
  • 起動:
docker compose up -d
  • アクセス:
    • crAPI Web:http://127.0.0.1:8888/
    • crAPI Web(HTTPS):https://127.0.0.1:8443/(検証用証明書のためブラウザ警告は想定内)
    • MailHog UI:http://127.0.0.1:8025/(テスト用メールの確認に利用可能)
  • 停止:
docker compose down

補足:演習ごとにデータベース状態をリセットする場合は docker compose down -v を利用する(named volume が削除されるため注意)。