🔐 تثبيت 2FAuth — مدير رموز التحقق الثنائي ذاتي الاستضافة

انشر 2FAuth على Ubuntu بـ Docker — تطبيق ويب ذاتي الاستضافة لإدارة رموز TOTP وHOTP الخاصة بالتحقق الثنائي، بحيث لا تبقى حبيسة هاتف واحد، على المنفذ 8248.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر 2FAuth على المنفذ 8248 مع APP_KEY مُولَّد تلقائياً. سجّل حسابك عند أول زيارة.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/2fauth/2fauth-ubuntu.sh
chmod +x 2fauth-ubuntu.sh
./2fauth-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/2fauth/2fauth-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x 2fauth-ubuntu.sh

3 تشغيل المثبّت

./2fauth-ubuntu.sh

4 تسجيل حسابك

http://your-server-ip:8248

المنافذ المستخدمة

المنفذالغرض
82482FAuth web interface (mapped from container port 8000)

نظرة عامة

2FAuth تطبيق ويب ذاتي الاستضافة لتوليد وإدارة رموز التحقق الثنائي — رموز TOTP الدوارة المكوّنة من ستة أرقام ورموز HOTP القائمة على العدّاد التي تحتفظ بها عادة في Google Authenticator أو Authy. مبني على Laravel ومرخّص بموجب MIT، يخزّن أسرار التحقق الثنائي الخاصة بك مشفّرة في قاعدة بياناته الخاصة ويعرضها عبر واجهة ويب نظيفة وقابلة للبحث يمكن الوصول إليها من أي متصفح. ولأنه يعمل على سيرفرك الخاص بدلاً من هاتف واحد، تبقى رموزك سالمة حتى لو فقدت الجهاز أو تعطّل، ويمكن تنظيمها في مجموعات والبحث فيها ونسخها احتياطياً مثل أي بيانات أخرى تتحكم بها.

لماذا تستخدمه

تطبيقات المصادقة على الهاتف فقط تربط كل رموز التحقق الثنائي بجهاز واحد — تفقد الهاتف أو تحصل على لابتوب جديد أو تُعيد ضبط النظام، وتجد نفسك مقفلاً خارج كل حساباتك حتى تبحث عن رموز الاسترداد واحداً تلو الآخر. يزيل 2FAuth نقطة الفشل هذه بإبقاء أسرار TOTP وHOTP على بنية تحتية تتحكم بها، يمكن الوصول إليها من متصفح على أي جهاز، وقابلة للاستعادة من نسخة احتياطية مثل بقية مختبرك المنزلي. يدعم مفاتيح أمان WebAuthn لتأمين الخزنة نفسها، ويستورد مباشرة من Google Authenticator وAegis و2FAS بحيث يصبح الترحيل مهمة خمس دقائق، بل ويولّد رموز Steam Guard، ما يجعله بديلاً حقيقياً شاملاً لتطبيقات الهاتف التي يعتمد عليها معظم الناس بالفعل.

متى تحتاجه

  • تريد أن تنجو رموز التحقق الثنائي من فقدان الهاتف أو سرقته أو إعادة ضبطه دون البحث المحموم عن رموز الاسترداد
  • تدير رموز التحقق الثنائي لأسرة أو فريق أو مجموعة حسابات مشتركة وتحتاج مصدراً واحداً موثوقاً يمكن الوصول إليه
  • تنتقل من Google Authenticator أو Authy أو تطبيق آخر مرتبط بالهاتف فقط وتريد تصديراً تتحكم به فعلياً
  • تحتاج توليد رموز التحقق الثنائي من متصفح سطح المكتب في حالات يكون فيها الوصول للهاتف غير مريح
  • تريد أن تكون أسرار TOTP الخاصة بك محفوظة احتياطياً ومُراقَبة النسخ مع بقية بنيتك التحتية ذاتية الاستضافة
  • لديك الاستعداد لتحمّل المسؤولية التشغيلية لتأمين سيرفر يحمل بذور مصادقة حساسة

من يحتاجه

  • عشاق المختبر المنزلي والاستضافة الذاتية الذين يشغّلون بنيتهم التحتية بالفعل ويريدون رموز التحقق الثنائي تحت نفس السقف
  • مسؤولو الأنظمة الذين يديرون رموز تحقق ثنائي مشتركة أو لحسابات خدمية عبر فريق صغير
  • المستخدمون المهتمون بالخصوصية الذين يريدون تجنب ربط رموز التحقق الثنائي بحساب Google أو Twilio (Authy)
  • المطورون الذين يتعاملون مع عشرات الحسابات المحمية بالتحقق الثنائي للاختبار والتجريب والإنتاج
  • أي شخص تعرّض من قبل لقفل خارج حساباته بعد فقدان هاتف يحمل تطبيق المصادقة الوحيد لديه
  • المستخدمون الذين يفضّلون إبقاء خزنة التحقق الثنائي منفصلة عن مدير كلمات المرور، حتى لا يكشف اختراق واحد كلا العاملين معاً

حالات الاستخدام الشائعة

  • تخزين رموز TOTP لعشرات الحسابات الشخصية والعملية في واجهة واحدة قابلة للبحث والتجميع
  • توليد رموز HOTP للعدد القليل من الخدمات التي لا تزال تعتمد على عدّاد بدلاً من الوقت
  • إنتاج رموز Steam Guard لحسابات الألعاب دون تثبيت تطبيق Steam المنفصل على الهاتف
  • مشاركة وصول محدود للقراءة فقط لرموز تحقق ثنائي معينة مع زميل يحتاج تسجيل الدخول لحساب خدمة مشترك
  • ترحيل كل حسابات تطبيق مصادقة كامل في دقائق باستخدام استيراد Google Authenticator أو Aegis
  • قفل الخزنة بالكامل خلف مفتاح أمان فعلي باستخدام WebAuthn بدلاً من الاعتماد على كلمة مرور وحدها

الميزات الرئيسية

  • دعم كامل لـ TOTP وHOTP إضافة إلى توليد رموز Steam Guard من نفس الواجهة
  • دعم WebAuthn لتسجيل الدخول باستخدام YubiKey أو Titan أو أي مفتاح متوافق مع FIDO2
  • استيراد بنقرة واحدة من Google Authenticator وAegis و2FAS وتطبيقات مصادقة شائعة أخرى
  • مجموعات لتنظيم الحسابات حسب العميل أو المشروع أو الغرض، مع بحث وتصفية عبر كل الإدخالات
  • مسح رمز QR لإضافة حسابات جديدة، إضافة إلى إدخال السر يدوياً للخدمات التي لا توفر رمز QR
  • تشفير اختياري للأسرار المخزَّنة مرتبط بـ APP_KEY الخاص بالتثبيت
  • تسجيل خروج تلقائي عند عدم النشاط وحماية اختيارية بكلمة مرور أو WebAuthn لفتح الخزنة
  • تصميم متجاوب مع وضع داكن، يعمل بنفس الكفاءة على متصفحات سطح المكتب والهاتف

كيفية الاستخدام بعد التثبيت

  • افتح http://your-server-ip:8248 فور الانتهاء من التثبيت وسجّل الحساب الأول قبل أن يستولي عليه أي شخص آخر
  • احفظ APP_KEY المُولَّد أثناء التثبيت في مكان آمن — فهو ما يشفّر كل سر تحقق ثنائي مخزَّن
  • استورد حساباتك الحالية دفعة واحدة من تصدير Google Authenticator أو Aegis أو 2FAS بدلاً من إعادة مسح كل رمز QR
  • أنشئ مجموعات لتنظيم الحسابات حسب العميل أو المشروع أو شخصي مقابل عملي قبل أن تكبر قائمة حساباتك
  • فعّل WebAuthn وسجّل مفتاح أمان فعلياً حتى تكون الخزنة نفسها محمية بأكثر من كلمة مرور
  • فعّل تسجيل الخروج التلقائي عند عدم النشاط إذا كان الوصول للتطبيق ممكناً من شبكة مشتركة أو شبه موثوقة
  • ضع 2FAuth خلف وكيل عكسي مع HTTPS قبل الاعتماد عليه يومياً — يجب ألا تنتقل أسرار التحقق الثنائي عبر HTTP عادي أبداً
  • جدوِل نسخاً احتياطياً دورياً لحجم قاعدة البيانات واحفظ APP_KEY بجانبها، بعيداً عن السيرفر نفسه

أفضل ممارسات الأمان

  • لا تكشف المنفذ 8248 مباشرة للإنترنت — ضع 2FAuth خلف وكيل عكسي بشهادة TLS صالحة
  • احفظ APP_KEY في مكان منفصل عن السيرفر نفسه؛ فبدونه تصبح أي نسخة احتياطية مستعادة من قاعدة البيانات غير قابلة لفك التشفير
  • فعّل WebAuthn بمفتاح فعلي حتى لا تكفي كلمة مرور مسروقة وحدها لفتح خزنة التحقق الثنائي بالكامل
  • قيّد الوصول الشبكي لـ 2FAuth بقاعدة جدار حماية أو VPN، فهو يحمل بذور كل حساب تحميه به
  • اضبط مهلة تسجيل خروج قصيرة إذا كان التطبيق قابلاً للوصول من متصفح على جهاز مشترك أو عام
  • حافظ على تحديث صورة Docker — يُصان 2FAuth بنشاط وتصل إصلاحات الأمان في إصدارات جديدة
  • تجنّب تخزين أسرار التحقق الثنائي على نفس السيرفر أو وجهة النسخ الاحتياطي التي يستخدمها مدير كلمات المرور، حتى لا يكشف اختراق واحد كلا العاملين
  • راجع قائمة الحسابات دورياً واحذف الإدخالات للخدمات التي لم تعد تستخدمها لتقليص ما قد يكسبه المهاجم

المنافذ وإعدادات جدار الحماية

يستمع 2FAuth على المنفذ 8248 على المضيف، المُعيَّن من المنفذ الداخلي 8000 في الحاوية — منفذ واحد فقط يجب إدارته. يجب ألا يكون قابلاً للوصول مباشرة من الإنترنت العام عبر HTTP عادي، لأن أي طلب قد يحمل أسرار التحقق الثنائي أو كوكيز الجلسة بنص واضح. ضعه خلف وكيل عكسي مثل Nginx Proxy Manager بشهادة TLS صالحة، أو الأفضل إبقاءه بعيداً عن الإنترنت العام تماماً والوصول إليه عبر VPN مثل WireGuard. على مستوى الجدار الناري، احجب الوصول الوارد إلى المنفذ 8248 من أي جهة عدا الوكيل العكسي أو واجهة VPN.

النسخ الاحتياطي والصيانة

  • انسخ حجم قاعدة البيانات احتياطياً بانتظام — يحتوي على كل سر TOTP/HOTP مخزَّن، مشفَّراً بـ APP_KEY
  • احفظ APP_KEY في مدير كلمات مرور أو ملاحظة آمنة منفصلة عن السيرفر؛ فهو مطلوب لفك تشفير أي نسخة احتياطية مستعادة
  • انسخ docker-compose.yml احتياطياً مع البيانات حتى يمكن إعادة إنشاء الإعداد الدقيق على مضيف جديد
  • استخدم ميزة التصدير المدمجة في 2FAuth دورياً كنسخة احتياطية ثانوية قابلة للقراءة البشرية لقائمة حساباتك
  • احفظ النسخ الاحتياطية خارج السيرفر — يجب ألا يعني تعطّل قرص محلي فقدان النسخة الحية ونسختها الاحتياطية الوحيدة معاً
  • اختبر استعادة كاملة أحياناً: شغّل حاوية جديدة، استعد قاعدة البيانات وAPP_KEY، وتأكد أن الرموز لا تزال تُولَّد بشكل صحيح

الأخطاء الشائعة

  • فقدان APP_KEY المُولَّد — بدونه تصبح النسخة الاحتياطية المستعادة لقاعدة البيانات مجرد ضجيج مشفّر لا يمكن فك تشفيره أبداً
  • كشف المنفذ 8248 للإنترنت دون وكيل عكسي أو TLS، ما يرسل أسرار التحقق الثنائي عبر HTTP عادي
  • تخطي إعداد WebAuthn والاعتماد على كلمة مرور واحدة لحماية خزنة تحمل كل بذرة تحقق ثنائي تملكها
  • معاملة ميزة التصدير كبديل عن نسخ احتياطية حقيقية بدلاً من كونها شبكة أمان ثانوية وعرضية
  • تخزين النسخة الاحتياطية لـ 2FAuth في نفس مكان نسخ مدير كلمات المرور، ما يُبطل الغرض من فصل العاملين
  • نسيان تسجيل الحساب الأول فور التثبيت، ما يترك فترة قصيرة يمكن فيها لأي شخص يصل للرابط الاستيلاء على صلاحية المشرف

استكشاف الأخطاء وإصلاحها

  • لا يمكن تسجيل حساب ← تأكد أنك أول زائر؛ إذا سجّل شخص آخر بالفعل، يجب أن ينشئ مشرف موجود حسابك
  • الرموز لا تطابق القيمة المتوقعة من الخدمة ← تحقق من دقة ساعة نظام السيرفر، فـ TOTP يعتمد على توقيت متزامن
  • استيراد Google Authenticator يفشل ← تأكد من استخدام تنسيق التصدير الرسمي (رابط أو QR)، وليس لقطة شاشة لرموز فردية
  • نسيان كلمة مرور الخزنة ولا يوجد مفتاح WebAuthn مسجَّل ← يتطلب الاسترداد وصولاً مباشراً لقاعدة البيانات؛ لا توجد إعادة تعيين كلمة مرور عبر البريد افتراضياً
  • الحاوية لا تبدأ بعد تحديث ← راجع سجلات docker بحثاً عن أخطاء ترحيل وتأكد أن حجم قاعدة البيانات لم يتلف أثناء التحديث
  • مفتاح WebAuthn غير معروف ← تحقق أن المتصفح ونظام التشغيل يدعمان واجهة FIDO2/WebAuthn وأن النطاق يطابق ما سُجِّل به المفتاح
  • واجهة الويب غير متاحة بعد إعداد الوكيل العكسي ← تأكد أن الوكيل يوجّه إلى منفذ الحاوية 8000 وليس منفذ المضيف 8248 عند التوجيه الداخلي

البدائل

يمكن لـ Vaultwarden (سيرفر متوافق مع Bitwarden ذاتي الاستضافة) تخزين أسرار TOTP بجانب كلمات مرورك، وهذا مريح لكنه يُضعف الفائدة الأمنية من وجود عاملين منفصلين — فأي اختراق للخزنة يكسب كليهما معاً. تطبيقا Aegis وandOTP رائعان لكنهما يعملان فقط على هاتف أندرويد واحد دون مزامنة سيرفر مدمجة. أما Authelia وKeycloak فهما منصتا مصادقة/تسجيل دخول موحد كاملتان وليستا مديري رموز تحقق ثنائي شخصيين — يُصدران ويتحققان من التحقق الثنائي كجزء من تسجيل الدخول لخدمات أخرى، لا كبديل لدور 2FAuth. لمدير TOTP/HOTP ذاتي الاستضافة مخصص يمكن الوصول إليه من المتصفح ويُبقي العامل الثاني منفصلاً عن خزنة كلمات المرور، يبقى 2FAuth الخيار الأكثر تركيزاً.

متى لا تستخدمه

إذا لم تكن مستعداً لتأمين وصيانة سيرفر يحمل بذور كل حساب محمي بالتحقق الثنائي تملكه، فتطبيق يعتمد على الهاتف مثل Aegis (مع نسخ احتياطية محلية مشفّرة) خيار أقل خطورة لمعظم الأفراد. تخزين رموز التحقق الثنائي بجانب كلمات المرور في نفس الخزنة (كما تسمح بعض مديرات كلمات المرور) يُبطل الغرض من التحقق الثنائي إذا كنت تريد فصلاً حقيقياً للعاملين — تجنّب 2FAuth لهذه الحالة وأبقهما منفصلين عمداً، أو تقبّل هذه المفاضلة بوعي. الفرق التي تحتاج تسجيل دخول موحد مركزي مع فرض تحقق ثنائي مدمج عبر تطبيقات عديدة يجب أن تنظر إلى Authelia أو Keycloak بدلاً من ذلك، فـ 2FAuth خزنة رموز شخصية وليس موفر هوية.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو 2FAuth؟

2FAuth تطبيق ويب ذاتي الاستضافة لإدارة رموز التحقق الثنائي — رموز TOTP الدوارة المكوّنة من ستة أرقام التي تحصل عليها عادة من Google Authenticator أو Authy. يدعم أيضاً HOTP ورموز Steam Guard، ويمكن الوصول إليه من أي متصفح بدلاً من ارتباطه بهاتف واحد.

ما المنفذ الذي يستخدمه وما بيانات الدخول؟

يعمل 2FAuth على المنفذ 8248 على المضيف، المُعيَّن من منفذ 8000 في الحاوية. لا يوجد تسجيل دخول افتراضي — تسجّل حسابك الخاص عند أول زيارة، لذا افعل ذلك فور التثبيت مباشرة.

لماذا يهم APP_KEY كثيراً؟

يُولّد المثبّت مفتاح APP_KEY بترميز base64 يستخدمه 2FAuth لتشفير أسرار التحقق الثنائي المخزَّنة. إذا فُقد هذا المفتاح أو تغيّر، لن يمكن فك تشفير الأسرار المخزَّنة بعد الآن — تصبح نسخك الاحتياطية لحجم البيانات عديمة الفائدة بدونه، لذا احفظه في مكان منفصل وآمن.

هل من الآمن الاحتفاظ برموز التحقق الثنائي على سيرفر؟

إنها مفاضلة حقيقية تستحق التفكير فيها. وضع البذور على سيرفر ويب يخلق هدفاً لم يكن موجوداً عندما كانت على هاتفك — الاختراق يكشف كل حساب دفعة واحدة. خفّف هذا بـ WebAuthn ووكيل عكسي بـ TLS وجدار حماية أو VPN، وإبقاء التطبيق منفصلاً عن خزنة كلمات المرور.

هل أستخدم هذا أم TOTP المدمج في Vaultwarden؟

تخزين Vaultwarden لـ TOTP بجانب كلمات مرورك مريح ويعني خدمة أقل، لكن إبقاء العاملين في مكان واحد يُضعف فائدة وجود اثنين. يبقي 2FAuth العاملين منفصلين مع كونه ذاتي الاستضافة وقابلاً للوصول من المتصفح، وهو الخيار الأكثر أماناً افتراضياً لمن يريد فصلاً حقيقياً للعاملين.