セルフホスト型CTF:オリジナルのWebチャレンジ+スコアボードを、GitLab CIとGitOpsエージェント経由でDocker Composeによりデプロイ。フラグは1つのCIシークレットから導出され、すべてのパイプラインがスタックをデプロイし、全チャレンジを自動で解きます。
自分で運営できる完全なキャプチャー・ザ・フラッグイベントです。4つのオリジナルWebチャレンジ、スコアボード、そしてコミットのたびに全体をビルド・スキャン・デプロイし、プレイまで行うGitLab CI/CD + GitOpsの仕組みを備えています。
紹介する内容
compose.yamlで6つの堅牢化されたコンテナを実行し、バインドマウントを使用しないため、同じファイルをラップトップ、CIのDocker-in-Dockerサービス、またはSSH経由のリモートホストにデプロイできます。depends_onによる順序制御、リソース制限、読み取り専用ルートファイルシステム、ドロップされたケーパビリティ、非rootユーザー、再デプロイ後も存続する永続ボリューム。mainが望ましい状態です。プルベースのエージェント(ctfops reconcile、systemdタイマー)は、パイプラインが成功した後にのみコミットをデプロイし、検証し、正常に起動しない場合は自動的にロールバックします。意図的なロールバックはgit revertです。flowchart LR
players((Players)) -->|":8000"| gw
players -->|":9001-9004"| gw
subgraph host["Docker host (compose project 'ctf')"]
gw["gateway<br/>nginx, rate limits"]
subgraph sbnet["network: scoreboard (internal)"]
sb["scoreboard<br/>Flask + SQLite"] --- vol[("scoreboard-data")]
end
subgraph c1["net-paper-trail (internal)"]
pt["paper-trail"]
end
subgraph c2["net-cookie-jar (internal)"]
cj["cookie-jar"]
end
subgraph c3["net-bookworm (internal)"]
bw["bookworm"]
end
subgraph c4["net-fetch-docs (internal)"]
fd["fetch-docs"]
end
gw --> sb & pt & cj & bw & fd
end
ルーティング可能なネットワーク上に存在するのはゲートウェイのみです。各チャレンジは internal ネットワーク上に単独で配置されるため、あるチャレンジでコード実行を達成したプレイヤーは、スコアボードにも、他のチャレンジにも、インターネットにも到達できません。ctfops verify-isolation は、すべてのコンテナの内部から CI 上でこのことを証明します。
| サービス | イメージ | 備考 |
|---|---|---|
gateway | nginx-unprivileged(ダイジェスト固定) | 単一のイングレス。フラグ送信はクライアントあたり 2 req/s、ログイン/登録は 1 req/s、IP ごとの接続数上限、バージョンバナーなし。アップストリームを遅延解決するため、1 つのチャレンジが差し替えられてもプラットフォーム全体が停止することはありません。 |
scoreboard | Python 3.13 / Flask / gunicorn | チーム、フラグ送信(HTML + JSON API)、ファーストブラッド付きランキング、イベント期間、管理者統計。scrypt パスワード、ハッシュ化された API トークン、CSRF トークン、CSP。 |
paper-trail、cookie-jar、bookworm、fetch-docs | 共有の challenge.Dockerfile | 意図的に脆弱なアプリで、1 コンテナにつき 1 つ。参照用ソルバーはイメージから削除されています。 |
すべてオリジナルです。配点は ctf.toml にあり、イベントの唯一の信頼できる情報源です。
| チャレンジ | 配点 | 説明 |
|---|---|---|
| Paper Trail | 100 | ゲストアカウントを備えた請求ポータル。 |
| Cookie Jar | 150 | Cookie でユーザーを記憶するスタッフ用掲示板。 |
| Bookworm | 200 | 検索ボックスを備えた図書館カタログ。 |
| Fetch Docs | 200 | 自作のパスフィルターを備えた内部ドキュメントビューア。 |
| チャレンジ | 脆弱性 | 参照エクスプロイト |
|---|---|---|
| Paper Trail | 安全でない直接オブジェクト参照: 請求書がログインのみを確認し、所有権を確認しない | ゲストとしてログインし、請求書 ID を #1001 まで順に下げる |
| Cookie Jar | 署名なしのクライアント側セッション(base64 JSON) | Cookie をデコードし、"role": "admin" を設定して再エンコードする |
| Bookworm | SQL インジェクション(SQLite) | sqlite_master から UNION SELECT して隠しテーブルを見つけ、それをダンプする |
| Fetch Docs | 1 回限りの ../ フィルターを回避するパストラバーサル | ....// が ../ に縮約される。フラグがプロセスに渡された /proc/self/environ を読み取る |
各エクスプロイトは challenges/<id>/solve.py に実装されており、すべてのパイプラインで実行されます。
Compose プラグイン付きの Docker と Python 3.11+ が必要です。
pip install -r requirements-dev.txt
export PYTHONPATH=src
python -m ctfops new-seed > .ctf-seed && chmod 600 .ctf-seed # gitignored; it IS every flag
python -m ctfops compose up -d --build --wait # build and start all six containers
python -m ctfops smoke --host localhost # play the CTF end to end
http://localhost:8000 を開き、チームを登録して、ポート 9001-9004 でハッキングを始めてください。
python -m ctfops compose down -v はスコアボードのデータを含むすべてを削除します。
ctfops compose ... は docker compose ... に、導出されたシークレットを Compose のプロセス環境に注入したものです。各コンテナは自身のシークレットのみを受け取り、シークレットなしで起動されたコンテナは起動を拒否します。そのため、シードを忘れたデプロイは推測可能なフラグを提供するのではなく、大きな音を立てて失敗します。
| ステージ | ジョブ | 何を証明するか |
|---|---|---|
| lint | python-lint、dockerfile-lint、compose-config | Ruff、Hadolint、Compose のパース;ctfops validate は ctf.toml、compose.yaml、gateway/nginx.conf、チャレンジフォルダが同じプラットフォームを記述していること、およびすべてのサービスがハードニングと分離を維持していることをチェックする |
| test | unit-tests、secret_detection、semgrep-sast | 100 以上のテスト(各チャレンジはそのソルバーによってインプロセスで攻略され、カバレッジゲートは 90% 超);GitLab Secret Detection:フラグやシードがコミットされていないこと;プラットフォームコードに対する SAST |
| build | build-images | 6 つのイメージすべての docker compose build + push、コミット SHA でタグ付け |
| scan | trivy-images、trivy-config | 修正可能な重大な CVE およびイメージ内で見つかったあらゆるシークレットで失敗;Dockerfile の設定ミス |
| verify | deploy-ephemeral | 使い捨てのシードを使って、プッシュされたイメージを Docker-in-Docker ホストにデプロイし、その後:ヘルス、セキュリティヘッダー、チャレンジ一覧、すべてのチャレンジの攻略とスコアリング、不正なフラグと不正なトークンの拒否、管理者認証、ゲートウェイのレート制限、分離プローブ、およびデータを保持しなければならないスコアボードの再作成 |
| release | promote-latest(main) | :latest を検証済みのイメージに移動する |
| deploy | deploy-production(main、手動) | SSH 経由のプッシュモードデプロイ;DEPLOY_HOST が設定された場合にのみ表示される |
すべてはジョブトークンを使って GitLab の共有ランナー上で実行されます:外部の認証情報やサーバーは不要です。 マージリクエストのパイプラインが実際のシードを見ることはありません。
docs/deploying.md を参照してください:シードの取り扱い、ホストの準備、プルベースの GitOps エージェント(deploy/systemd/)、プッシュモードのジョブ、そして TLS を前面に配置する方法。
challenges/<id>/app.py(FLAG からフラグを読み取る Flask の create_app(flag=None))と、challenges/<id>/solve.py(solve(base_url) -> flag のリファレンスエクスプロイト)を作成します。ctf.toml に [[challenges]] エントリを、compose.yaml にサービスと内部ネットワークを、gateway/nginx.conf にリスナーを追加します(さらに gateway/Dockerfile に EXPOSE を追加)。python -m ctfops validate を実行します:見落としたものがすべて指摘されます。マージリクエストを開いてください;それがマージされてグリーンになれば、GitOps エージェントがそれを出荷します。ctf.toml event definition: the desired state
compose.yaml the platform as a Compose project
challenges/<id>/ app.py (vulnerable on purpose) + solve.py (reference exploit)
docker/ scoreboard and shared challenge Dockerfiles
gateway/ nginx ingress image
src/scoreboard/ scoreboard (Flask)
src/ctfops/ secrets, compose wrapper, validate, smoke, isolation, GitOps reconcile
deploy/systemd/ GitOps agent units for the CTF host
docs/deploying.md running a real event
tests/ unit and integration tests
これらのチャレンジは意図的に脆弱に作られています。必ずこの分離モデルの内部でのみ実行し、他のサービスと隣接して実行しないでください。プラットフォームが意図的に行っていること:
--require-hashes、wheelのみ)、pipはランタイムイメージから削除されています。cap_drop: [ALL]、no-new-privileges、非root、メモリ/CPU/PID制限、ログローテーション。/run/secrets配下のファイルとしてシークレットを受け入れることもできます。Fetch Docsはこのトレードオフを教訓に変えています。プロセスのファイルを読めるものは、その環境も読めるのです。MIT、LICENSEを参照してください。