🔐 تثبيت Password Pusher (pwpush) — مشاركة كلمات المرور المؤقتة ذاتية التدمير على Docker
نشر منصة Password Pusher على Ubuntu باستخدام Docker — الأداة مفتوحة المصدر الآمنة لمشاركة كلمات المرور ومفاتيح API والملفات الحساسة بروابط مشفرة تنتهي صلاحيتها وتُحذف تلقائياً بعد القراءة.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/pwpush/pwpush-ubuntu.sh
chmod +x pwpush-ubuntu.sh
sudo bash pwpush-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/pwpush/pwpush-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x pwpush-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم (`./storage`) وتشغيل حاوية Password Pusher الرسمية على المنفذ 8174 (المحول من 5100 الداخلي).
sudo bash pwpush-ubuntu.sh
4 إنشاء أول كلمة مرور مؤقتة
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8174. اكتب كلمة المرور أو النص السري، وحدد شروط انتهاء الصلاحية (عدد المشاهدات أو الأيام)، وولد رابط المشاركة الآمن.
http://<your-server-ip>:8174
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8174 | Web UI + API (host → container 5100) — plain HTTP |
| ./storage | Pushes and audit logs (maps to /opt/PasswordPusher/storage) |
نظرة عامة
تعد Password Pusher (pwpush) منصة أمنية عريقة ومفتوحة المصدر صُممت خصيصاً للتخلص من مخاطر مشاركة كلمات المرور والبيانات السرية بنصوص مكشوفة. تعمل المنصة على المنفذ 8174، وتتيح للأفراد وفرق الدعم الفني ومديري الأنظمة إرسال كلمات المرور الحساسة، ومفاتيح API، والملاحظات السرية، والملفات المشفرة عبر روابط ويب مؤقتة. وتعتمد المنصة سياسة انتهاء صلاحية مزدوجة (بعدد المشاهدات أو بمرور وقت محدد)، حيث تُحذف البيانات نهائياً من قاعدة البيانات فور استيفاء شروط الحذف.
لماذا تستخدمه
يؤدي إرسال كلمات المرور والبيانات الحساسة عبر برامج المحادثة العادية (مثل Slack أو Teams أو WhatsApp أو البريد الإلكتروني) إلى بقاء هذه الأسرار مسجلة في تاريخ المحادثات وسيرفرات الشركات للأبد، مما يعرضها للاختراق المستقبلي. تمنحك الاستضافة الذاتية لـ Password Pusher وسيلة آمنة لمشاركة الأسرار عبر روابط ذاتية التدمير تُفتح لمرة واحدة فقط وتُحذف للأبد مع سجلات تدقيق تفصيلية ودون أي وسيط خارجي.
متى تحتاجه
- ترسل كلمات مرور مؤقتة أو مفاتيح VPN أو أكواد سرية للموظفين الجدد أو العملاء بصفة مستمرة
- تبحث عن بديل مجاني ومفتوح المصدر لأدوات مشاركة الأسرار التجارية مثل 1Password links
- تريد أن تُحذف كلمة المرور وتتدمر تلقائياً فور مشاهدتها لمرة واحدة أو بعد مرور 24 ساعة
- تحتاج إلى سجل تدقيق أمني يوضح توقيت فتح الرابط، وعنوان IP للزائر، وتوقيت الحذف النهائي
- تريد بوابة مشاركة أسرار متكاملة عبر API لربطها بأنظمة تذاكر الدعم الفني تلقائياً
من يحتاجه
- فرق الدعم الفني (IT Helpdesk) لإرسال كلمات مرور تسجيل الدخول الأولى للموظفين بأمان
- مهندسو العمليات (DevOps) لمشاركة بيانات قواعد البيانات ومفاتيح الخوادم مع المطورين
- خدمة العملاء لإرسال تراخيص البرامج وملفات التهيئة السرية للعملاء
- المؤسسات الحريصة على الالتزام بمعايير الأمان وحماية البيانات وتجنب تسريب الأسرار
- أصحاب السيرفرات المنزلية لتوفير خدمة مشاركة أسرار سهلة وآمنة للأصدقاء والعائلة
حالات الاستخدام الشائعة
- إرسال كلمة مرور قاعدة بيانات لمستشار خارجي مضبوطة للتدمير بعد مشاهدة واحدة أو بعد ساعتين
- مشاركة ملف تهيئة سري (مثل مفاتيح SSH أو شهادات الأمان) بحجم عدة ميجابايت بأمان
- التكامل مع أنظمة التذاكر (osTicket وZendesk) عبر واجهة REST API لتوليد روابط أسرار مؤتمتة
- مراجعة سجلات التدقيق للتحقق من أن العميل قام بالفعل بفتح بيانات حسابه الجديد
- توفير بوابة أسرار مخصصة بنطاق شركتك وشعارك الداخلي (مثل `passwords.yourcompany.com`)
الميزات الرئيسية
- محرك انتهاء صلاحية مزدوج: حذف السر بعد عدد مشاهدات محدد (من 1 إلى 10) أو بعد فترة زمنية (من ساعة إلى 30 يوماً)
- حماية إضافية بعبارة مرور (Passphrase): اشتراط كلمة سر إضافية لفتح وفك تشفير الرابط
- دعم مشاركة الملفات: إمكانية رفع وتشفير الملفات والمستندات ذاتية التدمير بجانب النصوص
- لوحة تدقيق أمني شاملة: تتبع توقيت المشاهدة، والدولة، ونوع المتصفح، وحالة الحذف
- واجهة برمجية REST API كاملة: لإنشاء وجلب وحذف الأسرار برمجياً عبر curl أو سكريبتات بايثون
- دعم المشاركة المجهولة السريعة أو تسجيل حسابات مستخدمين لمتابعة الأسرار السابقة
- واجهة مستخدم عصرية ومتجاوبة مع الهواتف الذكية وتدعم الوضع الداكن وتعدد اللغات
- نشر منظم في حاوية موحدة عبر Docker مع ربط مجلد `./storage` لحفظ قاعدة بيانات SQLite
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8174 لعرض واجهة Password Pusher
- اكتب كلمة مرور تجريبية أو نصاً سرياً في مربع الإدخال
- اضبط خيارات الحذف: 'الحذف بعد مشاهدة واحدة' و'الحذف بعد يوم واحد'
- اضغط على 'Push It' لتوليد رابط المشاركة المشفر ونسخه للحافظة
- افتح الرابط في نافذة تصفح خاصة للتحقق من ظهوره لمرة واحدة ثم حذفه تماماً
- ضع Password Pusher خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- يمكنك تخصيص الهوية والخيارات الافتراضية عبر متغيرات البيئة في `docker-compose.yml`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: استخدم تشفير HTTPS دائماً عبر وكيل عكسي — فإرسال كلمات المرور عبر HTTP غير المشفر يعرضها للاعتراض
- حافظ على سرية الرابط المولّد واحرص على إرساله للشخص المعني مباشرة
- فعل خيار الحماية بكلمة مرور إضافية (Passphrase) عند إرسال بيانات بالغة الحساسية
- لا تفتح المنفذ 8174 للإنترنت العام مباشرة واقصر الاتصال عبر وكيل عكسي مشفر
- احمِ مجلد البيانات `./storage` الذي يحتوي على قاعدة بيانات SQLite بصلاحيات نظام مناسبة بالسيرفر
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم Password Pusher واجهته والواجهة البرمجية API عبر منفذ TCP 8174 (المحول من 5100 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8174، مع إبقاء المنفذ 8174 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 للزوار.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./storage` احتياطياً، والذي يحتوي على ملف قاعدة بيانات `production.sqlite3` ومفاتيح التشفير
- احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على إعداداتك ومتغيرات البيئة
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من بقاء الأسرار النشطة
الأخطاء الشائعة
- التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL
- قيام المرسل بفتح الرابط بنفسه بعد إنشائه (مما يستهلك المشاهدة الواحدة ويؤدي لحرق وحذف السر فوراً)
- عدم ربط مجلد التخزين الدائم `./storage`، مما يسبب مسح كافة الأسرار النشطة عند تحديث الحاوية
- تحديد مدد صلاحية طويلة جداً (مثل شهر) لكلمات المرور المؤقتة بدلاً من سياسة المشاهدة الواحدة
- إرسال عبارة المرور الإضافية في نفس رسالة الشات التي تحتوي على رابط السر
استكشاف الأخطاء وإصلاحها
- ظهور رسالة 'This push has expired or was already viewed' — تأكد من أن الرابط لم يتم فتحه مسبقاً أو فحصه بروبوتات البريد
- فشل رفع الملفات والمرفقات — تأكد من صلاحيات الكتابة على مجلد `./storage` وارفع `client_max_body_size` في Nginx
- النطاق يعيد التوجيه لعنوان IP الداخلي — اضبط متغير `PWP__HOST=https://your-domain.com` في متغيرات البيئة
- ظهور خطأ HTTP 500 في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs pwpush -f`
- خطأ قفل قاعدة البيانات أثناء الضغط العالي — فكر في استخدام قاعدة بيانات PostgreSQL للمؤسسات الضخمة
البدائل
منصة PrivateBin لمشاركة النصوص المشفرة بمعرفة صفرية. منصة Yopass لمشاركة الأسرار عبر الذاكرة السريعة. أداة Bitwarden Send المدمجة في Vaultwarden. أداة 1Password Secret Links السحابية التجارية.
متى لا تستخدمه
تجنب استخدام Password Pusher إذا كنت تبحث عن أرشيف دائم للأكواد أو مستودع للملاحظات البرمجية والتوثيق للجميع (حيث صُممت منصات مثل PrivateBin أو GitHub Gists أو BookStack للتوثيق الدائم). وإذا كنت تحتاج لنظام إدارة وتدوير أسرار مؤتمت للسيرفرات والتطبيقات، فإن HashiCorp Vault هو المخصص لذلك.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ماذا يحدث عندما تنتهي صلاحية رابط Password Pusher؟
عندما يستنفد الرابط عدد المشاهدات المسموح به (مثل مشاهدة واحدة) أو تنتهي مدته الزمنية، يتم حذف وتدمير السر نهائياً من قاعدة بيانات السيرفر، وتظهر رسالة تفيد بانتهاء صلاحية الرابط لأي زائر جديد.
هل يمكن مشاركة الملفات عبر Password Pusher؟
نعم! يدعم Password Pusher مشاركة الملفات، حيث يمكنك رفع ملفات الإعدادات والشهادات والمستندات الحساسة لتتدمر ذاتياً بعد تنزيلها.
هل يمتلك Password Pusher واجهة برمجية (API)؟
نعم! يحتوي Password Pusher على واجهة برمجية REST API كاملة تتيح للمطورين إنشاء وجلب وحذف الأسرار برمجياً عبر أوامر سطر الأوامر أو لغات البرمجة مثل بايثون.
هل يمكن لبرامج فحص البريد الإلكتروني استهلاك الرابط وحرقه بالخطأ؟
نعم، قد تقوم بعض برامج الحماية بفحص ومعاينة الروابط تلقائياً مما يحرق الرابط ذي المشاهدة الواحدة. لتفادي ذلك، يتضمن البرنامج خيار اشتراط 'النقر للعرض' أو إدخال كلمة سر إضافية.
كم يستهلك Password Pusher من الذاكرة العشوائية (RAM)؟
يعد Password Pusher خفيفاً جداً ويستهلك حوالي 80 إلى 150 ميجابايت فقط من الذاكرة العشوائية داخل Docker في وضع الاستعداد.