🔐 تثبيت LLDAP — خادم LDAP خفيف الوزن لتسجيل دخول موحد ذاتي الاستضافة

انشر LLDAP على Ubuntu بواسطة Docker — خادم LDAP صغير وسهل الاستخدام يمنح Authelia وAuthentik وKeycloak دليل مستخدمين حقيقياً، باستخدام نحو 10 ميغابايت من الذاكرة فقط، على منفذ LDAP 3890 وواجهة الويب 17170.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر LLDAP بسر JWT وكلمة مرور مشرف مُولَّدين، مع LDAP على المنفذ 3890 وواجهة الويب على 17170.
عرض على GitHub

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

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

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

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

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

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

chmod +x lldap-ubuntu.sh

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

./lldap-ubuntu.sh

4 تسجيل الدخول إلى واجهة الويب

http://your-server-ip:17170

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

المنفذالغرض
3890LDAP — SSO providers and applications authenticate here
17170Web administration UI for users and groups

نظرة عامة

LLDAP (Lightweight LDAP) هو خادم LDAP مبسّط مجاني ومفتوح المصدر مبني بلغة Rust، صُمِّم خصيصاً ليمنح أدوات تسجيل الدخول الموحد ذاتية الاستضافة مثل Authelia وAuthentik وKeycloak دليل مستخدمين حقيقياً دون عبء إعداد تنفيذ LDAP كامل مثل OpenLDAP. يستخدم نحو 10 ميغابايت من ذاكرة RAM فقط، ويخزّن المستخدمين والمجموعات في SQLite افتراضياً (مع دعم MySQL وPostgreSQL أيضاً)، ويعرض واجهة LDAP قياسية ترتبط بها التطبيقات إلى جانب واجهة ويب حديثة (مدعومة بواجهة GraphQL) لإدارة المستخدمين والمجموعات دون التعامل مع ملفات LDIF الخام أبداً.

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

إعداد LDAP التقليدي — عادةً OpenLDAP — يعني المصارعة مع ملفات المخطط (schema) وصياغة ACL وإعدادات تسبق معظم أدوات اليوم، فقط للحصول على دليل مستخدمين أساسي يستطيع مزوّد SSO الارتباط به. يختصر LLDAP كل ذلك التعقيد إلى ما يحتاجه تسجيل الدخول الموحد ذاتي الاستضافة فعلياً: مستخدمون ومجموعات وعضويات مجموعات، تُدار عبر واجهة ويب نظيفة بدلاً من استيراد LDIF عبر سطر الأوامر. وبما أنه مكتوب بلغة Rust الآمنة للذاكرة وله بصمة صغيرة جداً، يعمل بارتياح جنباً إلى جنب مع مزوّد SSO على نفس السيرفر المتواضع، وبما أنه لا يزال يتحدث بروتوكول LDAP القياسي، ترتبط به أدوات مثل Authelia وAuthentik وKeycloak وNextcloud تماماً كما ترتبط بأي دليل آخر.

متى تحتاجه

  • تُعِدّ تسجيل دخول موحداً بـ Authelia أو Authentik أو Keycloak وتحتاج دليل مستخدمين حقيقياً متوافقاً مع LDAP خلفه
  • تريد إدارة مستخدمين ومجموعات مركزية عبر عدة تطبيقات ذاتية الاستضافة بدلاً من حسابات منفصلة على كل واحد
  • نظرت في إعداد OpenLDAP وتريد شيئاً بنفس توافقية البروتوكول لكن بجزء بسيط من تعقيد الإعداد
  • تحتاج خلفية LDAP لتطبيق (Nextcloud، Gitea، إلخ) يدعم المصادقة عبر LDAP أصلياً
  • تريد خدمة دليل خفيفة تعمل بارتياح على سيرفر مختبر منزلي صغير بدون موارد مخصصة
  • توحّد إدارة الهوية لمختبر منزلي أو فريق صغير وتريد مكاناً واحداً لإضافة أو تعطيل أو إزالة وصول المستخدمين

من يحتاجه

  • المستضيفون الذاتيون الذين يبنون إعداد تسجيل دخول موحد بـ Authelia أو Authentik أو Keycloak ويحتاجون خلفية دليل
  • هواة المختبرات المنزلية الذين يريدون إدارة تسجيل دخول مركزية عبر خدمات ذاتية الاستضافة كثيرة بدون بنية تحتية ثقيلة
  • الفرق الصغيرة أو العائلات التي تشارك مجموعة من التطبيقات ذاتية الاستضافة وتريد مصدر هوية مشتركاً واحداً بدلاً من حسابات لكل تطبيق
  • مديرو الأنظمة الذين يحتاجون توافقية LDAP لتطبيقات قديمة أو تدعم LDAP فقط بدون نشر OpenLDAP كامل
  • المستخدمون المهتمون بالخصوصية الذين يريدون مزوّد هوية خاصاً بهم بدلاً من الاعتماد على تسجيل دخول Google أو Microsoft
  • المطورون الذين يختبرون تكاملات LDAP ويريدون خادم دليل بسيط الإعداد وسهل إعادة الضبط أثناء التطوير

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

  • دعم نشر تسجيل دخول موحد بـ Authelia أو Authentik بدليل مستخدمين حقيقي وقابل للإدارة
  • توفير مصادقة LDAP لـ Nextcloud أو Gitea أو Jellyfin أو تطبيقات ذاتية الاستضافة أخرى تدعم LDAP أصلياً
  • مركزة حسابات المستخدمين والتحكم بالوصول القائم على المجموعات عبر مجموعة خدمات المختبر المنزلي ذاتية الاستضافة
  • استبدال الحسابات المحلية المتناثرة لكل تطبيق بدليل واحد يستطيع تعطيل مستخدم في كل مكان دفعة واحدة
  • تشغيل دليل هوية لمؤسسة صغيرة بدون العبء التشغيلي لـ OpenLDAP أو نشر Active Directory كامل
  • اختبار أو تعلّم تدفقات مصادقة قائمة على LDAP في بيئة مختبر خفيفة وقابلة للتخلص منها

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

  • مكتوب بلغة Rust الآمنة للذاكرة ببصمة صغيرة جداً — نحو 10 ميغابايت من الذاكرة أثناء التشغيل
  • واجهة ويب حديثة مبنية بـ React لإدارة المستخدمين والمجموعات والعضويات دون كتابة LDIF خام
  • واجهة GraphQL تدعم واجهة الويب، قابلة للاستخدام مباشرة للأتمتة أو التكاملات المخصصة
  • دعم بروتوكول LDAP القياسي على المنفذ 3890 حتى ترتبط مزوّدات SSO والتطبيقات المدركة لـ LDAP تماماً كما ترتبط بأي دليل
  • قاعدة بيانات SQLite افتراضياً، مع دعم اختياري لـ MySQL وPostgreSQL لعمليات النشر الأكبر أو المشتركة
  • إعداد أولي تصريحي (bootstrap) — عرّف المستخدمين والمجموعات في ملف إعدادات لإعدادات قابلة لإعادة الإنتاج وخاضعة للتحكم بالإصدار
  • إعادة تعيين كلمة مرور ذاتية الخدمة عبر SMTP، فيستطيع المستخدمون استعادة الوصول دون تدخل المشرف
  • دعم TLS لتشفير حركة LDAP والويب أثناء النقل

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

  • احفظ كلمة مرور المشرف المُولَّدة المكوّنة من 20 حرفاً التي يطبعها المثبّت — لا توجد بيانات اعتماد افتراضية ثابتة تعود إليها
  • سجّل الدخول لواجهة الويب على http://your-server-ip:17170 بحساب admin وكلمة المرور المُولَّدة
  • غيّر الـ base DN من الافتراضي dc=example,dc=com ليعكس نطاقك الخاص قبل إنشاء أي مستخدمين أو مجموعات
  • أنشئ حسابات المستخدمين ونظّمها في مجموعات تُقابل مستويات الوصول التي تتوقعها تطبيقاتك
  • اربط مزوّد SSO الخاص بك (Authelia أو Authentik أو Keycloak) بنقطة نهاية LDAP في LLDAP على المنفذ 3890 باستخدام الـ base DN وحساب ارتباط
  • اختبر المصادقة من طرف لطرف بتسجيل الدخول لتطبيق مرتبط واحد عبر مزوّد SSO قبل التوسع أكثر
  • أعدّ إعدادات SMTP إذا أردت أن يستطيع المستخدمون إعادة تعيين كلمات مرورهم بأنفسهم عبر واجهة الويب
  • قيّد واجهة الويب (المنفذ 17170) على الشبكات الموثوقة أو ضعها خلف وكيل عكسي بمصادقة، لأنها تدير دليل مستخدميك بالكامل

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

  • غيّر الـ base DN عن الافتراضي dc=example,dc=com فوراً — تغييره لاحقاً يعني إعادة إعداد كل تطبيق مرتبط
  • خزّن كلمة مرور المشرف المُولَّدة في مدير كلمات مرور فوراً؛ تُعرَض مرة واحدة فقط أثناء التثبيت
  • لا تكشف أبداً منفذ LDAP 3890 أو منفذ واجهة الويب 17170 مباشرة للإنترنت العام — يجب أن يبقى LLDAP على شبكة داخلية يصل إليها فقط مزوّد SSO والمشرفون
  • فعّل TLS لاتصالات LDAP إذا كان مزوّد SSO وLLDAP يتواصلان عبر أي شيء غير شبكة داخلية موثوقة بالكامل
  • تعامل مع LLDAP كجذر الثقة لكامل إعداد SSO الخاص بك — أي شخص يخترقه قد يصل لكل تطبيق خلف تسجيل الدخول الموحد
  • استخدم حساب ارتباط مخصصاً بصلاحيات دنيا لكل تطبيق يتصل بـ LLDAP، بدلاً من الارتباط بحساب المشرف
  • حافظ على تحديث صورة Docker وراقب إصدارات المشروع، لأن LLDAP يقع في نقطة بالغة الحساسية من سلسلة المصادقة لديك

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

يعرض LLDAP المنفذ 3890 لبروتوكول LDAP، الذي ترتبط به Authelia وAuthentik وKeycloak وتطبيقات أخرى مدركة لـ LDAP لمصادقة المستخدمين، والمنفذ 17170 لواجهة الإدارة عبر الويب حيث تدير المستخدمين والمجموعات. لا ينبغي كشف أي من المنفذين للإنترنت العام: كل من حركة LDAP وواجهة الإدارة تحمل بيانات مصادقة حساسة، ويُقصد بـ LLDAP أن يبقى على شبكة داخلية يصل إليها فقط التطبيقات والمشرفون الذين يحتاجونها. إذا كان مزوّد SSO يعمل على مضيف مختلف، قيّد المنفذ 3890 على IP ذلك المضيف في الجدار الناري بدلاً من فتحه على نطاق واسع، ولا تصل لواجهة الويب إلا عبر VPN أو من شبكات داخلية موثوقة — لا تضعها أبداً خلف وكيل عكسي عام المواجهة بدون تحكم وصول إضافي أمامها.

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

  • انسخ قاعدة بيانات LLDAP احتياطياً — SQLite افتراضياً، مخزّنة كملف، أو قاعدة بيانات MySQL/PostgreSQL إن أعددتها — فهي تحتوي كل مستخدم ومجموعة وعضوية
  • انسخ سر JWT المُولَّد وبيانات اعتماد المشرف احتياطياً؛ فقدان سر JWT يُبطل الجلسات النشطة عبر النشر
  • انسخ docker-compose.yml ومتغيرات البيئة احتياطياً، بما فيها الـ base DN الذي اخترته، حتى يمكن إعادة إنشاء السيرفر بشكل مطابق
  • إذا كنت تستخدم إعداداً أولياً تصريحياً للمستخدمين والمجموعات، أبقِ ملف الإعدادات ذلك تحت التحكم بالإصدار كنسخة احتياطية حية لهيكل دليلك
  • اختبر الاستعادة دورياً بإنشاء نسخة جديدة من LLDAP من نسخة احتياطية والتأكد أن مزوّد SSO لا يزال يستطيع المصادقة ضدها
  • وثّق الـ base DN وتفاصيل حساب الارتباط بشكل منفصل عن النسخة الاحتياطية نفسها، لأنك ستحتاجها لإعادة ربط التطبيقات بعد الاستعادة

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

  • ترك الـ base DN بالقيمة الافتراضية dc=example,dc=com والانتباه لذلك فقط بعد ارتباط التطبيقات وإعدادها ضده بالفعل
  • كشف منفذ LDAP 3890 أو منفذ واجهة الويب 17170 مباشرة للإنترنت بدلاً من إبقاء LLDAP على شبكة داخلية
  • فقدان كلمة مرور المشرف المُولَّدة لأنها عُرضت مرة واحدة فقط أثناء التثبيت ولم تُحفظ في أي مكان
  • ربط كل تطبيق متصل بحساب المشرف بدلاً من إنشاء حسابات ارتباط محدودة النطاق وصلاحيات دنيا
  • التعامل مع LLDAP كمكوّن منخفض الأهمية بينما هو فعلياً جذر الثقة لكل تطبيق خلف SSO الخاص بك
  • نسيان نسخ قاعدة البيانات احتياطياً قبل اختبار تغييرات الإعداد، ثم فقدان بيانات المستخدمين والمجموعات عند حدوث خطأ
  • عدم تفعيل TLS لحركة LDAP عندما يتواصل مزوّد SSO وLLDAP عبر أي شيء يتجاوز localhost أو شبكة معزولة تماماً

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

  • مزوّد SSO لا يستطيع الارتباط بـ LLDAP — تحقق من الـ base DN وبيانات اعتماد حساب الارتباط واتصال المنفذ 3890 بين الحاويتين أو المضيفين
  • تسجيل الدخول لواجهة الويب يفشل — تأكد أنك تستخدم كلمة مرور المشرف بالضبط كما وُلِّدت أثناء التثبيت، فلا توجد طريقة لاستعادتها إذا فُقدت (يلزم إعادة تعيين كلمة مرور عبر سطر أوامر الحاوية)
  • المستخدمون يستطيعون المصادقة مع LLDAP مباشرة لكن ليس عبر مزوّد SSO — تحقق أن فلتر LDAP ومطابقة السمات لدى مزوّد SSO تطابق مخطط LLDAP
  • المجموعات لا تعكس الصلاحيات المتوقعة في تطبيق مرتبط — تأكد من عضوية المجموعة في واجهة ويب LLDAP وأن تعيين المجموعة إلى الدور في التطبيق مُعدّ بشكل صحيح
  • رسائل إعادة تعيين كلمة المرور لا تُرسَل — تحقق أن إعدادات SMTP مضبوطة بشكل صحيح في متغيرات بيئة LLDAP
  • الاتصالات بين الحاويات تفشل بعد الانتقال لشبكة Docker مختلفة — تأكد أن LLDAP ومزوّد SSO على نفس شبكة Docker أو أن اسم المضيف/IP الصحيح مستخدم
  • مشكلات أداء تحت الحمل — تأكد أنك لم تتجاوز قدرة SQLite لحجم نشرك وفكّر في الانتقال لـ PostgreSQL أو MySQL

البدائل

OpenLDAP هو تنفيذ LDAP التقليدي كامل الميزات بدعم النسخ المتماثل والمخططات المعقدة وضوابط وصول دقيقة — أكثر قدرة فعلياً من LLDAP، لكن بنفس تعقيد الإعداد (ملفات المخطط وصياغة ACL وإدارة LDIF) الذي بُني LLDAP خصيصاً لتجنبه. FreeIPA يجمع LDAP مع Kerberos وDNS وإدارة الشهادات في مجموعة إدارة هوية كاملة، لكن بعبء تشغيلي أكبر بكثير مما يحتاجه مختبر منزلي عادةً. يستطيع كل من Keycloak وAuthentik العمل كمصدر هوية خاص بهما بدون خلفية LDAP منفصلة، ما يُزيل LLDAP من المجموعة بالكامل إذا لم تحتج تحديداً توافقية بروتوكول LDAP. Active Directory (عبر Samba AD DC) هو خدمة الدليل المعيارية للمؤسسات لكنها أثقل بكثير في التشغيل والإدارة مما يتطلبه إعداد ذاتي الاستضافة عادةً. كخادم دليل يتحدث LDAP حقيقياً بأقل إعداد واستخدام موارد، يبقى LLDAP أحد أبسط الخيارات ذاتية الاستضافة المتاحة.

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

إذا كان مزوّد SSO الخاص بك (مثل Keycloak أو Authentik) يستطيع العمل كمصدر هويته الخاص بدون حاجة لـ LDAP خارجي، فإضافة LLDAP كمكوّن منفصل تعقيد غير ضروري — استخدم إدارة المستخدمين المدمجة في المزوّد بدلاً من ذلك. إذا كنت تحتاج مجموعة ميزات LDAP الكاملة — نسخاً متماثلاً عبر عدة سيرفرات، أو تسلسلات هرمية معقدة للوحدات التنظيمية، أو تخصيصاً دقيقاً للمخطط — فإن LLDAP لا يقدم عمداً ذلك العمق، وOpenLDAP أو FreeIPA هما الخيار الأنسب رغم التعقيد الإضافي. لإعداد بمستخدم واحد مع تطبيق أو تطبيقين ذاتيي الاستضافة فقط، قد يكون تشغيل خدمة دليل منفصلة أصلاً بنية تحتية أكبر من الفائدة التي تبررها — الحسابات المحلية في كل تطبيق قد تكون أبسط. ولأن LLDAP يصبح جذر الثقة لكل شيء خلف SSO الخاص بك، فإن نشره دون فهم حقيقي للآثار الأمنية أخطر من عدم مركزة المصادقة إطلاقاً.

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

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

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

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

ما هو LLDAP؟

LLDAP خادم LDAP خفيف الوزن صُمِّم ليمنح أدوات تسجيل الدخول الموحد مثل Authelia وAuthentik وKeycloak دليل مستخدمين حقيقياً دون معاناة إعداد OpenLDAP.

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

LDAP على المنفذ 3890 وواجهة الإدارة عبر الويب على المنفذ 17170. يولّد المثبّت كلمة مرور مشرف مكوّنة من 20 حرفاً ويطبعها، باسم مستخدم admin — لا توجد بيانات اعتماد افتراضية ثابتة، لذا احفظ ذلك الناتج.

هل أحتاج تغيير الـ base DN؟

نعم، عملياً. يضبطه المثبّت على dc=example,dc=com، وهو يعمل لكنه قيمة نائبة. غيّره ليعكس نطاقك الخاص قبل إنشاء المستخدمين وربط التطبيقات، لأن تغييره لاحقاً يعني إعادة إعداد كل عميل يرتبط بالدليل.

كيف يُقارن بـ OpenLDAP؟

OpenLDAP هو التنفيذ الكامل والمتوافق مع المعايير بدعم النسخ المتماثل والمخططات المعقدة وضوابط وصول دقيقة — أكثر قدرة بكثير، لكن بتعقيد الإعداد الذي أُنشئ LLDAP خصيصاً لتجنبه.

ما مدى حساسية هذه الخدمة؟

بالغة الحساسية. إذا كان LLDAP يدعم تسجيل الدخول الموحد لديك، فهو جذر الثقة لكل تطبيق خلف ذلك SSO — اختراقه يعني اختراقها جميعاً.