الميزات

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

التثبيت

إصدار جاهز

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

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

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

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

chmod +x pwnedcheck
./pwnedcheck -h

Windows: غير مُختبر، لكن الملاحظات مُقدّرة

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

.\pwnedcheck.exe -h

باستخدام Go

ثبّت CLI في دليل bin الخاص بـ Go:

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 لإنتاج ملفات تنفيذية للإصدار لأنظمة Linux أو macOS:

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] Checking...
BAD PASSWORD — BREACH DETECTED (item #1)
	Password: 123456

Total runtime: 1.5s
Total passwords checked: 2
Bad passwords found: 1
Good passwords: 1

تخطيط المستودع

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

التطوير

make test    # run unit tests
make cover   # run tests with coverage summary

الوثائق: pkg.go.dev · التغطية: Codecov

الترخيص

GNU General Public License v3.0