إطار عمل قائم على Go لاستغلال الشبكات وهجمات الوسيط (MITM)، مخصص لاختبار الاختراق المصرح به، واستطلاع الشبكات، واعتراض حركة المرور، واختبار أمن الشبكات اللاسلكية، والبحث في الهجمات على الطبقات 2/3/7.
إطار عمل لتقييم الأمن المحلي والشبكي مكتوب بلغة Go. وهو أداة بحث واختبار اختراق مُصرَّح به يغطي مسار تقييم الشبكة — اكتشاف المضيفين والخدمات، والتعداد، وتدقيق بيانات الاعتماد، وتحديد الثغرات، والاستغلال المُصرَّح به. تمتد فئاته العشر لل وحدات عبر الاستطلاع، والتعداد، وOSINT، وMITM (تسميم ARP/DHCP/DNS/IPv6 واعتراض HTTP/HTTPS المباشر)، واللاسلكي، وطبقة المبدلات، والويب، والمصادقة، والتجسس، وما بعد الاستغلال — وكلها تُدار من جلسة تفاعلية، أو معالج موجَّه، أو تسلسلات أوامر لمرة واحدة.
MITM هي قدرة واحدة ضمن هذا النطاق الأوسع: فـ TOHA3EE ليست محدودة بسيناريوهات هجمات الرجل في المنتصف.
تحذير: يقوم toha3ee بإعادة توجيه حركة مرور الشبكة وتسميمها وفك تشفيرها واعتراضها بشكل نشط. استخدمه فقط على الشبكات التي تملكها أو لديك تصريح صريح باختبارها. تشغيل هذه الوحدات ضد أطراف ثالثة غير قانوني في معظم الولايات القضائية. اقرأ
docs/Security.mdأولاً.
تجلب برامج التثبيت ذات السطر الواحد الملف التنفيذي المُجمَّع مسبقًا لمنصتك من أحدث إصدار، وتتحقق من تجزئته SHA-256 وتضيفه إلى PATH الخاص بك. وإذا لم يكن هناك ملف تنفيذي مُجمَّع مسبقًا بعد، فإنها تبني من المصدر بدلاً من ذلك.
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.sh | sh
Windows (PowerShell):
irm https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.ps1 | iex
أو من نسخة مستخرجة:
make install # installs ~/.local/bin/toha3ee and adds it to PATH
خيارات التثبيت (Unix): --prefix <dir> (الافتراضي: /usr/local/bin كـ root،
وإلا ~/.local/bin)، و--no-path لتخطي تعديل shell rc، و--from-source
للبناء بدلاً من التنزيل، وTOHA3EE_VERSION=<tag> لتثبيت إصدار محدد.
شغّل باستخدام sudo sh ... للتثبيت على مستوى النظام. يضع مثبّت Windows
الملف التنفيذي في %LOCALAPPDATA%\Programs\toha3ee\bin ويحدّث PATH الخاص بالمستخدم؛
Windows-on-ARM64 يشغّل بناء x64.
على Linux يسجّل المثبّت التطبيق أيضاً لدى بيئة سطح المكتب: فهو
يثبّت الشعار في سمة أيقونات hicolor ويضع مدخلاً .desktop
بجوار بادئة التثبيت (مثل /usr/local/share أو ~/.local/share)، لذا
يظهر toha3ee في بحث GNOME مع أيقونته. على Windows ينسخ
ملف .ico وينشئ اختصاراً في قائمة ابدأ. تحمل حزمة الإصدار tarball/zip
الأيقونة حتى يتمكن المثبّت من تسجيلها من نفس الأثر المُتحقَّق منه.
إلغاء التثبيت: احذف الملف التنفيذي وسطر PATH الذي أضافه المثبّت إلى
shell rc الخاص بك (أو %LOCALAPPDATA%\Programs\toha3ee على Windows).
بعد التثبيت، حدّث باستخدام:
toha3ee updates # `toha3ee update` works as an alias
يتحقق من الإصدار المثبّت مقابل أحدث إصدار رسمي على GitHub لـ QYVORA، ويتحقق من SHA-256 للتنزيل مقابل checksum المنشور، ويستبدل الملف التنفيذي بشكل ذرّي. تُرفض عمليات التخفيض، وأي فشل يترك ملفك التنفيذي الحالي دون تغيير — دون الحاجة إلى Go toolchain أو Git. راجع docs/Update.md للتفاصيل.
يتطلب Go 1.26+ وlibpcap.
# Debian/Ubuntu
sudo apt install libpcap-dev
# then
go build ./cmd/toha3ee
تحتاج عمليات بناء Linux إلى ترويسات libpcap (يتحقق مسار التثبيت الاحتياطي من المصدر منها ويطبع أمر apt/dnf الصحيح إذا كانت مفقودة). يأتي macOS مزوّدًا بـ libpcap مع Xcode Command Line Tools.
# Interactive session (bare command drops straight in)
sudo ./toha3ee --iface eth0
# Interactive session (explicit subcommand)
sudo ./toha3ee tui --iface eth0
# Guided wizard
sudo ./toha3ee wizard --iface eth0
# One-shot: scan the subnet, then show what was found
sudo ./toha3ee --eval "net.scan; net.show" --iface eth0
# One-shot: procedural deep recon (synscan -> fingerprint -> service enum)
sudo ./toha3ee --eval "net.recon; net.profile" --iface eth0
# Non-interactive caplet script
sudo ./toha3ee run --iface eth0 caplets/basic.cap
# Dry-run a .toha3ee script (validates it, prints the plan, sends no packets)
./toha3ee build scripts/full-pipeline.toha3ee
# Execute a .toha3ee script non-interactively
sudo ./toha3ee script --iface eth0 scripts/full-pipeline.toha3ee
معظم وحدات الهجوم تتطلب صلاحيات الجذر (raw sockets، والتقاط الحزم، وإعادة توجيه IP). شغّلها كجذر أو باستخدام CAP_NET_ADMIN/CAP_NET_RAW حيثما أمكن. أضف --no-color لتعطيل الإخراج الملوّن، و-v لتفعيل التسجيل المفصّل.
الأفعال التي تلامس حزمة الشبكة (tui، wizard، eval، run، script) تعمل بصلاحيات المسؤول افتراضيًا: على Linux/macOS تعيد الأداة تنفيذ نفسها تحت sudo وتطلب كلمة مرور المسؤول (الجذر). الأفعال المحلية فقط لا ترتقي بالصلاحيات أبدًا ولا تحتاج إلى كلمة مرور — version، modules، capabilities، completion، help، updates، build وreport تعمل دون صلاحيات مرتفعة بصفة المستخدم المُستدعي. مرّر --no-sudo (أو عيّن TOHA3EE_NO_SUDO=1) لكبح تصعيد الصلاحيات لأفعال الشبكة أيضًا.
كل شيء عبارة عن وحدة. تسجّل الوحدات نفسها في init() الخاص بحزمتها وتُعرض تلقائيًا بواسطة السجل؛ وإضافة هجوم تعني إضافة حزمة تحت internal/attacks/ تُنفّذ عقد attacks.Module (انظر internal/attacks/attacks.go):
Meta() — المعرّف، الفئة، المخاطر، الأهداف، الوصف، القيودPreflight(ctx) — التحقق من الشروط المسبقة قبل التشغيلRun(ctx, opts) — حلقة الهجوم (يجب أن تحترم ctx.Done)Verify(ctx) — الإبلاغ عمّا حدثCleanup(ctx) — التراجع عن كل شيء، واستعادة الشبكةتتتبّع دورة حياة safety مركزية (internal/safety) عمليات التنظيف المسجّلة ونبضات القلب بحيث يُفكَّك كل هجوم حتى عند حدوث panic أو SIGINT، ويحتفظ store مشترك بجرد المضيفين، وبيانات الاعتماد الملتقطة، والجلسات، وسجل الأحداث الذي يغذّي مولّد التقرير.