CTF مستضاف ذاتيًا: تحديات ويب أصلية + لوحة نتائج، تُنشر باستخدام Docker Compose عبر GitLab CI ووكيل GitOps. تُشتق الأعلام (Flags) من سر CI واحد؛ وكل خط أنابيب ينشر الحزمة ويحل كل تحدٍ تلقائيًا.
حدث التقاط الأعلام (capture-the-flag) كامل يمكنك تشغيله بنفسك: أربعة تحديات ويب أصلية، ولوحة نتائج، وآلية GitLab CI/CD + GitOps التي تبني وتفحص وتنشر وتلعب الحدث بأكمله مع كل عملية commit.
ما الذي تستعرضه
compose.yaml واحد يشغّل ست حاويات محصّنة، دون أي bind mounts، بحيث ينشر
الملف نفسه على حاسوب محمول، أو خدمة CI Docker-in-Docker، أو مضيف بعيد عبر SSH.depends_on، وحدود للموارد، وأنظمة ملفات جذرية للقراءة فقط،
وقدرات مُسقَطة، ومستخدمون غير جذريين، وحجم تخزين دائم يبقى بعد عمليات إعادة النشر.main هو الحالة المرغوبة. وكيل قائم على السحب (ctfops reconcile، مؤقت systemd)
ينشر عملية commit فقط بعد نجاح خط أنابيبها، ويتحقق منها، ويتراجع تلقائيًا إن لم تنهض بحالة سليمة. والتراجع
المتعمد يكون عبر 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 (digest مثبّت) | نقطة دخول واحدة. 2 طلب/ثانية لكل عميل عند إرسال الرايات، و1 طلب/ثانية عند تسجيل الدخول/التسجيل، وحدود اتصالات لكل IP، ودون لافتة إصدار. يحلّ المصادر العلوية بتأخير، لذا فإن استبدال تحدٍّ واحد لا يُسقط المنصة أبدًا. |
scoreboard | Python 3.13 / Flask / gunicorn | الفرق، إرسال الرايات (HTML + JSON API)، الترتيب مع أول إصابة، نافذة الحدث، إحصاءات المشرف. كلمات مرور scrypt، ورموز API مُجزّأة، ورموز CSRF، وCSP. |
paper-trail، cookie-jar، bookworm، fetch-docs | ملف challenge.Dockerfile مشترك واحد | تطبيقات ضعيفة عمدًا، واحد لكل حاوية. يُزال الحلّال المرجعي من الصورة. |
جميعها أصلية. توجد قيم النقاط في ctf.toml، المصدر الوحيد للحقيقة للحدث.
| التحدي | النقاط | الوصف |
|---|---|---|
| Paper Trail | 100 | بوابة فواتير مع حساب ضيف. |
| Cookie Jar | 150 | لوحة إعلانات للموظفين تتذكرك عبر ملف تعريف ارتباط. |
| Bookworm | 200 | فهرس مكتبة مع مربع بحث. |
| Fetch Docs | 200 | عارض مستندات داخلي مع مرشّح مسارات محلي الصنع. |
| التحدي | الثغرة | الاستغلال المرجعي |
|---|---|---|
| Paper Trail | مرجع كائن مباشر غير آمن: تتحقق الفواتير من تسجيل الدخول، لا من الملكية | سجّل الدخول كضيف، وتنقّل عبر معرّفات الفواتير نزولًا إلى #1001 |
| Cookie Jar | جلسة من جانب العميل غير موقّعة (base64 JSON) | فكّ ترميز ملف تعريف الارتباط، واضبط "role": "admin"، ثم أعد الترميز |
| Bookworm | حقن SQL (SQLite) | UNION SELECT من sqlite_master للعثور على جدول مخفي، ثم استخراجه |
| Fetch Docs | اجتياز المسار متجاوزًا مرشّح ../ أحادي التمرير | ....// تنطوي إلى ../؛ اقرأ /proc/self/environ، حيث سُلّمت الراية إلى العملية |
كل استغلال مُنفَّذ في challenges/<id>/solve.py ويعمل في كل خط أنابيب.
يتطلب Docker مع إضافة Compose و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 | docker compose build + push لجميع الصور الست، موسومة بـ commit 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 shared runners باستخدام رمز المهمة: لا بيانات اعتماد خارجية ولا خوادم. خطوط أنابيب طلبات الدمج لا ترى البذرة الحقيقية أبدًا.
راجع docs/deploying.md: التعامل مع البذرة، تحضير المضيف، وكيل GitOps القائم على السحب
(deploy/systemd/)، مهمة وضع الدفع، ووضع TLS في المقدمة.
challenges/<id>/app.py (تطبيق Flask create_app(flag=None) يقرأ علمه من FLAG) و
challenges/<id>/solve.py (استغلال مرجعي solve(base_url) -> flag).[[challenges]] إلى ctf.toml، وخدمة وشبكة داخلية إلى compose.yaml، و
مستمعًا إلى gateway/nginx.conf (بالإضافة إلى EXPOSE في gateway/Dockerfile).python -m ctfops validate: سيسمّي أي شيء فاتك. افتح طلب دمج؛ وبمجرد دمجه و
نجاحه، ينشره وكيل GitOps.