
hate_crack v2.17.2
أداة لأتمتة منهجيات الاختراق عبر Hashcat من فريق TrustedSec.
___ ___ __ _________ __
/ | \_____ _/ |_ ____ \_ ___ \____________ ____ | | __
/ ~ \__ \\ __\/ __ \ / \ \/\_ __ \__ \ _/ ___\| |/ /
\ Y // __ \| | \ ___/ \ \____| | \// __ \\ \___| <
\___|_ /(____ /__| \___ >____\______ /|__| (____ /\___ >__|_ \
\/ \/ \/_____/ \/ \/ \/ \/
التثبيت
التثبيت من المصدر هو المسار المدعوم الوحيد. hate_crack ليس
موزعًا على PyPI: pip install hate-crack يُحل إلى عنصر نائب 0.0.0
يفشل عن قصد ويشير إلى هنا. الاسم محجوز فقط حتى لا يتمكن أي شخص آخر
من نشر نسخة مشابهة تحت هذا الاسم — راجع
packaging/pypi-placeholder/.
1. تثبيت hashcat
يجب تثبيت Hashcat وأن يكون متاحًا في PATH الخاص بك:
Ubuntu/Kali:
sudo apt-get install -y hashcat
macOS (Homebrew):
brew install hashcat
أو نزّل ملفًا ثنائيًا جاهزًا مسبقًا من https://hashcat.net/hashcat/ واضبط hcatPath في config.json على موقعه.
2. تنزيل hate_crack
استنسخ مع الوحدات الفرعية (مطلوب لـ hashcat-utils وprinceprocessor وpcfg_cracker وCorporate_Masks واختياريًا omen):
git clone --recurse-submodules https://github.com/trustedsec/hate_crack.git
cd hate_crack
إذا استنسخت دون الوحدات الفرعية، فقم بتهيئتها:
git submodule update --init --recursive
ثم خصّص الإعدادات إذا لزم الأمر. يستخدم hate_crack ملفَّي إعدادات، يملك كلٌّ منهما مجموعة مميزة من الإعدادات:
config.json— مسارات قوائم الكلمات، والأقنعة، والقواعد، والضبط الدقيق، وملف potfile، ومسار hashcat، وحدود المرشحين، ومفاتيح الإشعارات، وإعدادات تفضيلات سطر الأوامر الافتراضية (35 إعدادًا)..env— إعدادات التكامل مع الأطراف الثالثة فقط: بيانات اعتماد Hashview وHashmob، وبيانات اعتماد Pushover، وOllama، وpipal (14 إعدادًا). غير متتبَّع بواسطة git، ويُنشأ بوضع0600.
يقع هذا الفصل هناك لسبب واحد: .env هو الملف الذي قد يحتوي على أسرار. فبيانات الاعتماد الخاصة بالخدمات الخارجية وإعداداتها تذهب إلى الملف غير المتتبَّع ذي الوضع 0600؛ بينما يبقى كل ما يفعله hate_crack محليًا في config.json، وهو آمن للمشاركة والمقارنة والتدوين في ملاحظاتك الخاصة. ولهذا أيضًا توجد بيانات اعتماد Pushover في .env بينما توجد مفاتيح تشغيل/إيقاف Pushover في config.json — فالمفاتيح تفضيلات محلية وليست أسرارًا.
لكل مفتاح موطن واحد فقط. وأي مفتاح يوضع في الملف الآخر يُتجاهَل، ويطبع hate_crack تحذيرًا يذكر الملف الذي ينتمي إليه. ويمكن مع ذلك تجاوز أي مفتاح لتشغيل واحد عبر تصدير متغيّر بيئته. ويمكن لمعظم المستخدمين تخطّي هذه الخطوة لأن المسارات الافتراضية تعمل مباشرةً.
config.json دائم وأساسي — وهو غير مهجور ولا توجد جدولة زمنية لإزالته. الإعدادات الوحيدة التي انتقلت هي إعدادات التكامل.
هل ترقّي من config.json واحد؟ يقوم hate_crack بترحيله نيابةً عنك عند أول تشغيل: تُنسخ إعدادات التكامل إلى ملف .env جديد بوضع 0600، ثم تُزال من config.json حتى لا يدّعيها الملفان معًا. ويطبع المفاتيح التي انتقلت (وليس قيمها أبدًا)، ويحفظ نسختك الأصلية باسم config.json.pre-split.bak قبل المساس بها. ويُترك كل شيء آخر في config.json كما هو تمامًا، بما في ذلك ترتيب المفاتيح.
أول تشغيل: يُنشئ hate_crack كلا الملفين نيابةً عنك، فلا يوجد ما تفعله. لإعداد .env يدويًا بدلًا من ذلك، انسخ القالب المتتبَّع:
cp .env.example .env
chmod 600 .env
.env.example مُلتزَم به ويُشحن مع كل مفتاح اعتماد فارغ. يجب ألا يُلتزَم .env نفسه أبدًا — فهو مُستبعَد عبر gitignore، إلى جانب صيغ النسخ الاحتياطي المعتادة له، ويُنشئه hate_crack دائمًا بوضع 0600 (قراءة/كتابة للمالك فقط). يُولَّد .env.example من المخطط؛ أعد توليده بعد تغيير hate_crack/config_schema.py باستخدام uv run python -m hate_crack.config_writer.
3. تثبيت التبعيات وhate_crack
أسهل طريقة هي تشغيل make (أو make install)، الذي يكتشف نظام التشغيل لديك تلقائيًا ويثبّت:
- التبعيات الخارجية (p7zip، transmission-daemon / transmission-remote)
- يبني الوحدات الفرعية (hashcat-utils، princeprocessor، pcfg_cracker، وomen اختياريًا) ويستخرج مجموعة الأقنعة Corporate_Masks الخاصة بالبيانات فقط
- تبعيات Python عبر uv وواجهة CLI في
~/.local/bin/hate_crack
make
هذا الإجراء عديم الأثر - فهو يتخطى الأدوات المثبّتة مسبقًا. لإجبار النظام على إعادة تثبيت نظيفة:
make reinstall
أو قم بتثبيت التبعيات يدويًا:
التبعيات الخارجية
هذه مطلوبة لبعض عمليات التنزيل/الاستخراج:
7z/7za(p7zip) — تُستخدم لاستخراج أرشيفات.7z.transmission-daemon/transmission-remote— تُستخدم لتنزيل ملفات torrent الخاصة بـ Weakpass.
أوامر التثبيت اليدوي:
Ubuntu/Kali:
sudo apt-get update
sudo apt-get install -y p7zip-full transmission-daemon
macOS (Homebrew):
brew install p7zip transmission-cli # provides transmission-daemon and transmission-remote
ثم ثبّت اعتماديات Python وواجهة CLI:
uv sync
mkdir -p ~/.local/bin
printf '#!/usr/bin/env bash\nset -euo pipefail\nexec uv run --directory %s python -m hate_crack "$@"\n' "$(pwd)" > ~/.local/bin/hate_crack
chmod +x ~/.local/bin/hate_crack
بنية المشروع
أصبحت المنطق الأساسي الآن مقسّمًا إلى وحدات ضمن hate_crack/:
hate_crack/cli.py: أدوات مساعدة argparse وتجاوزات الإعدادات.hate_crack/api.py: تكاملات Hashview وWeakpass وHashmob (التنزيلات/القوائم/الأدوات المساعدة).hate_crack/attacks.py: معالجات هجمات القائمة.hate_crack/corpus_stats.py: إحصاءات كلمات المرور على مستوى المجموعة الكاملة المستخدمة لوصف مجموعة بيانات للنموذج اللغوي الكبير (LLM).hate_crack/plaintext.py: يستعيد كلمة المرور من سطر في مجموعة البيانات (إزالة بادئة التجزئة، وفك ترميز$HEX[...])؛ مشترك بين أوضاع LLM وcorpus_stats وrulegen.hate_crack/llm.py: توليد مرشّحات LLM المهيكلة (JSON) عبر Atomic Agents.hate_crack/menu.py: عارض القائمة المشترك، بما في ذلك التنقل الاختياري بمفاتيح الأسهم.hate_crack/noninteractive.py: موزّع أوامر الهجوم الفرعية النصية.hate_crack/notify/: حزمة الإشعارات (خلفية Pushover، متتبّع الذيل لكل كسر).hate_crack/username_detect.py: يكتشف ملفات الإدخال بصيغةusername:hashلتحديد استخدام--usernameفي hashcat.hate_crack/formatting.py،hate_crack/progress.py: أدوات مساعدة لتنسيق المخرجات وعرض التقدّم.hate_crack/main.py: التنفيذ الرئيسي لواجهة سطر الأوامر.
يبقى hate_crack.py في المستوى الأعلى نقطة الدخول الرئيسية وينسّق بين هذه الوحدات.
المراجع والشكر
يعتمد هذا المشروع على عدد من المشاريع والخدمات الخارجية ويستلهم منها. الشكر لـ:
- Hashview (http://github.com/hashview/)
- Weakpass (https://weakpass.com)
- Hashmob (https://hashmob.net)
الاستخدام
بعد التثبيت باستخدام make، شغّل hate_crack من أي مكان:
hate_crack
# or with arguments:
hate_crack <hash_file> <hash_type> [options]
أو بدلاً من ذلك، شغّله عبر uv:
uv run hate_crack.py <hash_file> <hash_type>
التشغيل كأداة (موصى به)
قم بالتثبيت باستخدام make من جذر المستودع - يقوم هذا ببناء الوحدات الفرعية وتجميع الأصول:
cd /path/to/hate_crack
make
hate_crack
يقوم أمر make install بإنشاء bash shim في ~/.local/bin/hate_crack يعمل من دليل المستودع، بحيث يتم العثور على الإعدادات والأصول دائمًا بغض النظر عن دليل العمل الحالي.
يتم البحث عن الإعدادات أيضًا في:
- جذر المستودع ودليل الحزمة
~/.hate_crack
ملاحظة: إن hcatPath في config.json مخصص لموقع ملف hashcat الثنائي فقط (اختياري إذا كان hashcat في PATH). يتم تحميل أصول Hate_crack (hashcat-utils، princeprocessor، pcfg_cracker، Corporate_Masks، omen) من دليل المستودع وتُضمَّن تلقائيًا بواسطة make install.
التشغيل كسكربت
يستخدم السكربت shebang الخاص بـ uv. اجعله قابلًا للتنفيذ وشغّله:
chmod +x hate_crack.py
./hate_crack.py
يمكنك أيضًا استخدام Python مباشرةً:
python hate_crack.py