عملة الفريق الأحمر

---

RedTeamCoin هو تنفيذ لتجمّع تعدين عملات رقمية قائم على تقنية البلوكتشين، مصمم لاختبارات الأمان المصرح بها وعمليات الفريق الأحمر. مبني بلغة Go مع دعم عملاء Java، يحاكي هجمات التعدين الخفي في العالم الحقيقي لمساعدة المؤسسات على تقييم قدراتها في الكشف وتقدير الأضرار المحتملة الناتجة عن عمليات تعدين الجهات الخبيثة.

تمكّن هذه الأداة فرق الأمان من إظهار سيناريوهات هجمات التعدين الخفي بشكل آمن وقانوني على الأنظمة المؤسسية، وإنتاج تقارير تأثير شاملة، والتحقق من ضوابط الأمان—كل ذلك ضمن بيئة خاضعة للسيطرة باستخدام بلوكتشين معزول وغير عام.

جدول المحتويات

• نظرة عامة
• الميزات
• بدء سريع
• كيف يعمل
• الاستخدام
  • تشغيل الخادم
  • تشغيل عامل تعدين
  • الاتصال بالخوادم البعيدة
• تعدين GPU
• الإعدادات
• مرجع API
• البنية
• التطوير
• المساهمة
• استكشاف الأخطاء وإصلاحها
• التوثيق
• الترخيص
• الإقرارات

نظرة عامة

لماذا استخدام RedTeamCoin؟

• إظهار التأثير الواقعي لهجمات التعدين الخفي
• اختبار والتحقق من أنظمة المراقبة والكشف الأمنية
• إنتاج تقييمات كمية للأضرار لتقارير الإدارة التنفيذية
• محاكاة عمليات التعدين بأمان دون الاتصال بسلاسل الكتل العامة

مكونات النظام:

• خادم تجمّع التعدين - يدير البلوكتشين وينسّق توزيع العمل
• عملاء التعدين - عملاء تعدين CPU/GPU (تطبيقات Go وJava)
• لوحة تحكم ويب - مراقبة وتحكم وإحصائيات في الوقت الفعلي
• أدوات التحليل - توليد تقارير شاملة لتقييم الأضرار

الميزات

• تنفيذ البلوكتشين: بلوكتشين مخصص بإثبات العمل مع صعوبة قابلة للتهيئة
• خادم تجمّع التعدين: إدارة عدة عمال تعدين وتوزيع العمل عبر gRPC
• عملاء التعدين: عملاء تعدين آليون (Go وJava) مع تسجيل عنوان IP واسم المضيف
• عامل تعدين Java مستقل: عامل تعدين سطح مكتب بواجهة رسومية
• عميل Java gRPC: عميل gRPC بدون واجهة رسومية للخوادم والأتمتة
• التحكم بعمال التعدين من جانب الخادم: إيقاف مؤقت، استئناف، تحديد استخدام CPU، وحذف عمال التعدين عن بُعد
• تحديد استخدام CPU: تحديد استخدام CPU لعامل التعدين من 0-100% لإدارة الموارد
• دعم تعدين GPU: دعم CUDA وOpenCL لتعدين مسرّع عبر GPU
• التعدين الهجين: تعدين متزامن عبر CPU وGPU لأقصى أداء
• لوحة تحكم ويب: مراقبة في الوقت الفعلي لعمال التعدين والإحصائيات والبلوكتشين مع أزرار تحكم
• مصادقة REST API: مصادقة آمنة قائمة على الرموز لنقاط نهاية API
• تشفير TLS لعميل gRPC: تشفير TLS اختياري لاتصالات gRPC الآمنة بين العميل والخادم
• تتبع IP مزدوج: تسجيل كل من عناوين IP المبلّغة من العميل والمكتشفة من الخادم
• إحصائيات CPU وGPU: تتبع وإبلاغ شامل لاستخدام الموارد
• بروتوكول بفر: اتصال فعّال بين العميل والخادم باستخدام protobuf/gRPC
• إنهاء تلقائي: يغلق عمال التعدين أنفسهم ويحذفون ذاتيًا تلقائيًا عند إزالتهم من الخادم

بدء سريع

شغّل RedTeamCoin في أقل من 5 دقائق:

المتطلبات الأساسية

• Go الإصدار 1.21 أو أحدث
• مترجم بروتوكول بفر (protoc)

أوبونتو/ديبيان:```bash sudo apt update sudo apt install -y golang-go protobuf-compiler

**macOS:**```bash
brew install go protobuf

Windows:

• ثبّت Go من https://golang.org/dl/
• ثبّت protoc من https://github.com/protocolbuffers/protobuf/releases

التثبيت```bash

Clone the repository

git clone https://github.com/xyplex3/RedTeamCoin.git cd RedTeamCoin

Install dependencies

make install-tools make deps

Build server and client

make build

### التحقق

تحقق من اكتمال البناء بنجاح:```bash
ls -lh bin/
# Expected output: server and client binaries (1-5 MB each)

./bin/server --help
# Expected output: Usage information for the server

تشغيل أول مجمع تعدين لك

1. ابدأ الخادم:```bash make run-server

يجب أن ترى مخرجات مثل:```text
RedTeamCoin Mining Pool Server
Authentication Token: abc123def456...
Dashboard URL: http://localhost:8080?token=abc123def456...
gRPC server listening on port 50051

2. ابدأ عامل تعدين (في طرفية جديدة):```bash make run-client

يجب أن ترى نشاط التعدين:```text
Connected to mining pool at localhost:50051
Registered as miner: miner-hostname-1234567890
Mining block #1... Hash rate: 2.5 MH/s
Block found! Nonce: 98765, Hash: 000000ab1cd...

3. عرض لوحة المعلومات:

افتح عنوان URL من الخطوة 1 في متصفحك، أو انتقل إلى:```text http://localhost:8080?token=YOUR_AUTH_TOKEN_HERE

سترى إحصائيات في الوقت الفعلي تشمل المعدّنين النشطين، ومعدلات التجزئة، والكتل المستخرجة.

**ملاحظة:** يستمع الخادم على جميع واجهات الشبكة - استبدل `localhost`
بعنوان IP الخاص بالخادم للوصول عن بُعد.

## كيف يعمل

يعمل مجمع التعدين باستخدام آلية إجماع إثبات العمل:

1. يقوم الخادم بتهيئة سلسلة الكتل باستخدام كتلة التكوين
2. يتصل المعدّنون عبر gRPC ويسجلون مع IP/اسم المضيف
3. يوزع الخادم مهام العمل (قوالب الكتل)
4. يحسب المعدّنون تجزئات SHA-256 للعثور على nonces صالحة
5. يقدم المعدّنون الحلول عند تحقيق هدف الصعوبة
6. يتحقق الخادم من الكتل ويضيفها إلى سلسلة الكتل
7. تعرض لوحة المعلومات إحصائيات الوقت الفعلي ونشاط المعدّنين

تتطلب كل كتلة إيجاد تجزئة بعدد محدد من الأصفار البادئة
(صعوبة قابلة للتكوين). يحصل المعدّنون على 50 RTC عن كل كتلة مستخرجة.

### تدفق البيانات```text
Client Miner                    Server
    |                              |
    |--RegisterMiner(IP,Hostname)->|
    |<--RegistrationResponse-------|
    |--GetWork()------------------>|
    |<--WorkResponse(Block)--------|
    | [Mining: compute hashes]     |
    |--SubmitWork(nonce,hash)----->|
    |                              | [Validate proof-of-work
    |                              |  and add block to chain]
    |<--SubmissionResponse---------|
    |--Heartbeat(stats)----------->|
    |<--HeartbeatResponse----------|

الاستخدام

تشغيل الخادم

HTTP (الافتراضي):```bash ./bin/server

- خادم gRPC: المنفذ **50051**
- لوحة التحكم على الويب: **http://localhost:8080**

**HTTPS/TLS (موصى به):**```bash
# Generate certificates (one time)
./generate_certs.sh

# Start with TLS
RTC_SERVER_TLS_ENABLED=true ./bin/server

• خادم gRPC: المنفذ 50051
• لوحة تحكم الويب: https://localhost:8443
• إعادة توجيه HTTP: http://localhost:8080

ملاحظة رقم 1: مع HTTPS، ستعرض المتصفحات تحذيرًا أمنيًا للشهادات الموقّعة ذاتيًا. انقر على "خيارات متقدمة" ← "المتابعة إلى localhost".

ملاحظة رقم 2: ستعمل لوحة تحكم الويب وخادم gRPC على جميع واجهات الخادم ويمكن استخدامها بدلاً من localhost.

تشغيل عامل تعدين

عميل Go (الملف الثنائي الأصلي)

الاستخدام الأساسي:```bash ./bin/client

**شغّل عدة معدّنين:**
افتح محطات طرفية إضافية وشغّل `./bin/client` في كل منها.

#### معدّنو Java

توفر RedTeamCoin تطبيقين لمعدّني Java:

##### عميل Java gRPC (بدون واجهة رسومية)