DockerSecurityPlayground

Docker Security Playground هو تطبيق يسمح لك بـ:

• إنشاء سيناريوهات الشبكة وأمن الشبكة، بهدف فهم بروتوكولات الشبكة،
  قواعدها، ومشاكل الأمان عن طريق تثبيت DSP على جهازك.
• تعلم تقنيات اختبار الاختراق من خلال محاكاة سيناريوهات مختبرات الثغرات.
• إدارة مجموعة من مشاريع docker-compose. الهدف الرئيسي لـ DSP هو التعلم
  في اختبار الاختراق وأمن الشبكة، ولكن مرونته تسمح لك بـ
  إنشاء، تحرير رسومي و إدارة تشغيل / إيقاف جميع مختبرات docker-compose الخاصة بك.

التثبيت

سير العمل المقترح لتثبيت DSP هو باستخدام جهاز افتراضي Kali:

• تثبيت docker و docker-compose
• تثبيت أحدث إصدار مستقر من nodejs
• تثبيت dsp

فيما يلي خطوات تثبيت DSP على جهاز افتراضي Kali. اتبع خطوات مماثلة لتوزيعات Linux الأخرى، ولكن تأكد من تثبيت جميع المتطلبات.

1. تثبيت متطلبات DSP:

sudo apt update && sudo apt install -y docker.io docker-compose nodejs npm git

ملاحظة (مشكلة kali keyring 2025).

إذا واجهت المشكلة التالية أثناء التثبيت:

root@kitploit:~

Fetched 34.0 kB in 1s (58.4 kB/s)
Warning: Failed to fetch http://http.kali.org/kali/dists/kali-rolling/InRelease  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY ED65462EC8D5E4C5
Warning: Some index files failed to download. They have been ignored, or old ones used instead.

تحتاج إلى إضافة المفتاح المفقود:

root@kitploit:~

wget https://http.kali.org/kali/pool/main/k/kali-archive-keyring/kali-archive-keyring_2025.1_all.deb
sudo dpkg -i kali-archive-keyring_2025.1_all.deb
rm kali-archive-keyring_2025.1_all.deb

2. تمكين بدء تشغيل docker عند الإقلاع وتكوين المستخدم الحالي لاستخدام docker بدون sudo:

sudo systemctl enable docker
sudo groupadd docker
sudo usermod -aG docker $USER

3. سجل الخروج ثم سجل الدخول (مطلوب للسماح للمستخدم الحالي باستخدام docker بدون sudo)، وتحقق من أنه يمكنك استخدام docker بدون sudo:

docker ps

أيضًا، تحقق من أن docker compose يعمل:

docker compose --version # أو docker-compose --version للإصدارات الأقدم

تحقق أيضًا من تثبيت npm و nodejs:

node -v
npm -v

ملاحظة لمستخدمي macOS M1

من الممكن تشغيل DSP على جهاز M1 عن طريق تفعيل Rosetta، لكنني أوصي بشدة بإنشاء جهاز افتراضي Kali باستخدام UTM أو Vmware fusion، ثم اتباع خطوات التثبيت السابقة وتثبيت حزمة binfmt-misc لتشغيل صور x86 على بنية ARM.

sudo apt install binfmt-support qemu-user-static

أعد تشغيل الجهاز.

ثم استخدم حاوية Tonisiigi لتسجيل جميع المترجمين الفوريين للمعماريات المختلفة:

docker run --privileged --rm tonistiigi/binfmt --install amd64

تحقق من أن صور docker يمكن تشغيلها على جهازك:

docker run --rm -it --platform linux/amd64 ubuntu uname -m

4. الآن يمكنك تثبيت DSP:

git clone https://github.com/DockerSecurityPlayground/DSP.git 
cd DSP 
npm install 

عند اكتمال التثبيت، يمكنك بدء تشغيل DSP:

npm start

سيعمل DSP على "http://localhost:18181" .

ملاحظة لاستخدام Wireshark على Kali: أقترح استخدام متصفح chromium، حيث أن حاوية wireshark تستخدم بعض الترميزات غير المدعومة من قبل firefox على Kali. يمكنك بدء تشغيل chromium بمجرد كتابة "chromium" في الطرفية.

ستكون الخطوة الأولى هي تثبيت جميع المجلدات المطلوبة في الجهاز الحالي.

يمكنك أيضًا أتمتة خطوة التثبيت هذه باستخدام متغير البيئة

export DSP_AUTOINSTALL=1  && npm start

تشغيل DSP في جهاز افتراضي - التعريض على واجهة 0.0.0.0

إذا كنت ترغب في استخدام متصفح المضيف، يمكنك التعريض على واجهة 0.0.0.0.
إذا كنت ترغب في التعريض على واجهة أخرى، قم بتغيير متغير البيئة DSP_IFACE:

export DSP_IFACE="0.0.0.0"

الآن يمكنك استخدام dsp على واجهة عن بعد.

تنظيف DSP

إذا حدث خطأ ما، يمكنك إعادة تعيين DSP إلى الإعدادات المصنعية باستخدام الأمر التالي:

npm run uninstall  

سيؤدي هذا إلى حذف كل شيء، ويمكنك بدء تشغيل DSP من خطوة التثبيت.

المستودع الرسمي

DSP_Repo يحتوي على مختبرات DSP الرسمية. ساهم في DSP عن طريق إنشاء مختبرات DSP جديدة

كيف يمكنني مشاركة مختبراتي مع العالم؟

أثناء التثبيت، يمكنك إنشاء بيئة محلية ليس لها رابط مع git، أو يمكنك ربط مستودع شخصي بالتطبيق. هذا مفيد جدًا إذا كنت ترغب في مشاركة عملك مع الآخرين.
يجب أن يكون مستودع DSP له عدة متطلبات، لذا قمت بإنشاء قالب مستودع DSP أساسي يمكنك استخدامه لإنشاء مستودعك الشخصي.
لذا، فإن أسهل طريقة لمشاركة المختبرات هي كالتالي:

1. انسخ مشروع NS-Unina: https://github.com/NS-unina/DSP_Repo.git
2. أثناء التثبيت، قم بتعيين معلمة دليل github إلى المستودع المنسوخ الخاص بك.
3. الآن قم بإنشاء مختبراتك وشاركها!

من المهم أن تكون جميع الصور التي تستخدمها متاحة للمستخدمين الآخرين، لذا:

• يمكنك النشر على docker hub حتى يتمكن المستخدمون الآخرون من سحب صورك لاستخدام مختبراتك.
• يمكنك توفير ملفات docker داخل الدليل .docker-images، حتى يتمكن المستخدمون من استخدام build.sh لبناء صورك واستخدام مستودعك.

إذا كنت بحاجة إلى "طريقة خاصة" لمشاركة المختبرات، فيجب عليك مشاركة المستودع بطرق أخرى، ولا يوجد حاليًا دعم لمشاركة المستودعات الخاصة.

في DSP يمكنك إدارة مستودعات مستخدمين متعددة (علامة تبويب المستودعات)

ميزات DSP

• محرر رسومي لـ docker-compose
• إدارة صور Docker وملفات Dockerfile
• تكامل GIT
• مستودع DSP مع مجموعة من سيناريوهات أمن الشبكة

أي سؤال؟

إذا كان لديك مشكلة، يمكنك استخدام قسم المشكلات (Issues).

الاختبارات

لتشغيل اختبار:

mocha test/<test-nodejs-file.js>   

تستخدم الاختبارات طريقة helper.start() لتهيئة بيئة الاختبار:

• يتم إنشاء تكوين اختبار
• يتم محاكاة دليل homedir، بحيث يمكن استخدام دليل dsp الداخلي للاختبارات.

استكشاف الأخطاء وإصلاحها

أثناء تثبيت DSP

إذا كان لديك الخطأ التالي أثناء التثبيت:

[2020-12-14T10:18:21.854Z]  INFO: DockerSecurityPlayground/1536 on vagrant: [DOCKER ACTIONS - DOWNLOAD IMAGE]
events.js:174
      throw er; // Unhandled 'error' event
      ^

Error: connect EACCES /var/run/docker.sock
    at PipeConnectWrap.afterConnect [as oncomplete] (net.js:1107:14)
Emitted 'error' event at:
    at Socket.socketErrorListener (_http_client.js:401:9)
    at Socket.emit (events.js:198:13)
    at emitErrorNT (internal/streams/destroy.js:91:8)
    at emitErrorAndCloseNT (internal/streams/destroy.js:59:3)
    at process._tickCallback (internal/process/next_tick.js:63:19)

تحقق من شيئين:

1. تم تثبيت docker
2. المستخدم الحالي موجود في مجموعة docker

لاختبار ذلك:

docker ps   

لا تستخدم SUDO إذا كنت تشغل DSP كمستخدم عادي.
إذا كان لديك الخطأ التالي:

vagrant@vagrant:~/git/DockerSecurityPlayground$ docker ps
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/json: dial unix /var/run/docker.sock: connect: permission denied

تحتاج إلى إضافة مستخدمك إلى مجموعة docker:
https://docs.docker.com/engine/install/linux-postinstall/

$ sudo groupadd docker
$ sudo usermod -aG docker $USER

سجل الخروج ثم سجل الدخول
الآن تحتاج إلى تنظيف DSP:

npm run uninstall  

والآن يجب أن يعمل كل شيء.

خطأ MacOS

خطأ MacOS ECONNRESET:

events.js:183
      throw er; // Unhandled 'error' event
      ^

Error: read ECONNRESET
    at _errnoException (util.js:992:11)
    at TCP.onread (net.js:618:25)

على Mac، يبدو أن هناك مشكلة مع بعض حزمة node، لذا لحل هذه المشكلة قم بتشغيل:

MacBook-Pro:DockerSecurityPlayground gaetanoperrone$ npm install [email protected] --save-dev --save-exact

معلومات أخرى هنا: http://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/docker-operation-errors

المساهمة

1. قم بعمل fork!
2. أنشئ فرع الميزة الخاص بك: git checkout -b my-new-feature
3. قم بإجراء التغييرات الخاصة بك: git commit -am 'Add some feature'
4. ادفع إلى الفرع: git push origin my-new-feature
5. قدم طلب سحب (pull request)، سنقوم بالمراجعة

أي أسئلة؟

استخدم المشكلات (Issues) لطرح كل ما تريد!.

الروابط

• 
• https://github.com/NS-unina/DSP_Repo.git : مستودع تم إنشاؤه لدورة أمن الشبكات لـ Simon Pietro Romano في جامعة الدراسات في نابولي، Federico II

المساهمون

شكر لـ Giuseppe Criscuolo و Alessandro Placido Luise على تصميم الشعار

سجل التغييرات

اذهب إلى CHANGELOG.md لرؤية جميع تغييرات الإصدار.

استشهد بهذا العمل

إذا كنت تستخدم Docker Security Playground في نشاطك البحثي، فاستشهد بالورقة التالية المنشورة من قبل IEEE (معهد مهندسي الكهرباء والإلكترونيات) https://ieeexplore.ieee.org/document/8169747

@INPROCEEDINGS{8169747,
  author={Perrone, G. and Romano, S. P.},
  booktitle={2017 Principles, Systems and Applications of IP Telecommunications (IPTComm)}, 
  title={The Docker Security Playground: A hands-on approach to the study of network security}, 
  year={2017},
  volume={},
  number={},
  pages={1-8},
  keywords={Security;Communication networks;Tools;Containers;Virtualization;Standards},
  doi={10.1109/IPTCOMM.2017.8169747}}

الترخيص

هذا المشروع مرخص تحت رخصة MIT