المميزات

• التحقق من كلمات مرور فردية من سطر الأوامر
• معالجة كلمات المرور من ملف
• قبول إدخال SHA-1 المجزوء مسبقًا باستخدام -hashed
• فحص تصديرات Bitwarden المشفرة باستخدام -bw
• إخفاء كلمات المرور النصية الصريحة في المخرجات باستخدام -hide
• عرض معلومات تشخيصية على مستوى الطلب من HIBP باستخدام -v
• طباعة إحصائيات نهاية التشغيل باستخدام -stats

التثبيت

الإصدار المجمع مسبقًا

يمكنك تنزيل ملف ثنائي ثابت مجمع مسبقًا مصمم لنظام تشغيلك مباشرة من صفحة الإصدارات:

1. اذهب إلى صفحة الإصدارات.
2. قم بتنزيل الأرشيف المطابق لمنصتك وبنيان جهازك:
   • لينكس: pwnedcheck_x.x.x_linux_amd64.tar.gz (أو arm64)
   • ماك: pwnedcheck_x.x.x_darwin_amd64.tar.gz (أو arm64)
   • ويندوز: pwnedcheck_x.x.x_windows_amd64.zip
3. استخرج محتويات الأرشيف للحصول على الملف القابل للتنفيذ.

تشغيل الملف القابل للتنفيذ

لينكس / ماك: افتح الطرفية داخل المجلد المستخرج، اجعل الملف الثنائي قابلاً للتنفيذ، ثم شغله:

chmod +x pwnedcheck
./pwnedcheck -h

ويندوز: لم يتم اختباره، لكن الملاحظات مرحب بها.

افتح PowerShell أو موجه الأوامر داخل المجلد الذي يحتوي على pwnedcheck.exe المستخرج ونفذ:

.\pwnedcheck.exe -h

باستخدام Go

قم بتثبيت واجهة سطر الأوامر في مجلد Go bin الخاص بك:

go install github.com/mohamedation/PwnedCheck/cmd/pwnedcheck@latest

من المصدر باستخدام Make

git clone https://github.com/mohamedation/PwnedCheck.git
cd PwnedCheck
make install

سيقوم ذلك بتثبيت الملف الثنائي للنظام المضيف الحالي في مجلد bin الخاص بـ Go.

بناء ملفات ثنائية خاصة بالمنصة

استخدم ملف Makefile لإنتاج ملفات ثنائية للإصدار للينكس أو ماك:

make build-linux
make build-macos

تكتب الملفات الثنائية إلى dist/ مع بنيان Go الحالي في اسم الملف.

إذا كنت تريد نسخ الملف الثنائي إلى مجلد bin الخاص بـ Go باسم خاص بنظام التشغيل، استخدم:

make install-linux
make install-macos

تثبت هذه الأوامر الملف باسم pwnedcheck.

الاستخدام

تشغيل من المصدر:

go run ./cmd/pwnedcheck -v god

أو تشغيل الملف الثنائي المثبت:

pwnedcheck -i passwords.list -stats

أمثلة شائعة

التحقق من كلمة مرور واحدة:

pwnedcheck password123

التحقق من عدة كلمات مرور:

pwnedcheck love sex secret god

التحقق من كلمات مرور من ملف:

pwnedcheck -i passwords.list

التحقق من قيم SHA-1 مجزوءة مسبقًا:

pwnedcheck -hashed -i passwords.list

التحقق من تصدير Bitwarden مشفر:

pwnedcheck -bw -i bitwarden_encrypted_export.json -hide -stats

تفعيل تسجيل طلبات HIBP التفصيلي:

pwnedcheck -v password123

الخيارات

• -i, --input <string> : ملف الإدخال الذي يحتوي على كلمات المرور أو التصدير بصيغة JSON (الافتراضي "passwords.txt")
• -bw, --bitwarden : معاملة ملف الإدخال كتصدير JSON مشفر محمي بكلمة مرور من Bitwarden
• -H, --hashed : معاملة الإدخال على أنه تجزئات SHA-1 محسوبة مسبقًا بدلاً من النص الصريح
• -x, --hide : إخفاء كلمات المرور النصية الصريحة من مخرجات الكونسول
• -s, --stats : عرض ملخص وقت التشغيل والنتائج بعد الانتهاء
• -v, --verbose : طباعة حالة كل طلب HIBP والاستجابة لعرض تشخيصات API
• -c, --credits : عرض الإسنادات
• -h, --help : عرض المساعدة

نموذج الأمان

يستخدم PwnedCheck نهج عدم الكشف عن الهوية (k-anonymity) الذي تستخدمه HIBP:

• يتم إرسال أول 5 أحرف فقط من تجزئة SHA-1 إلى API
• لا يتم نقل كلمة المرور الكاملة أبدًا
• يتم فك تشفير تصديرات Bitwarden محليًا في الذاكرة قبل الفحص

مثال على المخرجات

[1/2] جاري الفحص...
كلمة مرور سيئة — تم اكتشاف خرق (العنصر #1)
	كلمة المرور: 123456

إجمالي وقت التشغيل: 1.5 ثانية
إجمالي كلمات المرور المفحوصة: 2
كلمات المرور السيئة التي تم إيجادها: 1
كلمات المرور الجيدة: 1

هيكل المستودع

• cmd/pwnedcheck: نقطة الدخول لسطر الأوامر وتحليل العلامات
• internal/checker: حلقة التشغيل وتنسيق المخرجات
• internal/hibp: عميل HIBP وتجزئة كلمات المرور
• internal/bitwarden: فك تشفير تصدير Bitwarden

الترخيص

رخصة GNU العامة الإصدار 3.0