ماذا يفعل LLDAP
LLDAP خادم دليل حر مكتوب بلغة Rust. يخزّن المستخدمين والمجموعات في قاعدة SQLite، ويعرضها على التطبيقات عبر بروتوكول LDAP، ويمنح المسؤولين واجهة ويب لإدارتها. لا يحاول فعل كل شيء: لا مخططات لكتابتها، ولا نسخ متماثل، ولا قوائم تحكم دقيقة. يفعل ما يحتاجه Authelia وGitea وNextcloud وKeycloak وJellyfin — التحقق من كلمة مرور وسرد أعضاء مجموعة — ولا شيء أكثر.
ما يقدمه لك LLDAP
- حساب واحد لكل شخص — اسم المستخدم وكلمة المرور نفسهما في جميع تطبيقاتك.
- مغادرة تُدار بنقرة — عطّل الحساب في LLDAP فيُغلق الوصول في كل مكان.
- مجموعات تفتح الوصول — مجموعة لكل تطبيق، ولا يدخل كل تطبيق إلا أعضاءها.
- واجهة ويب — أنشئ الحسابات وعدّلها ورتّبها دون كتابة ملف LDIF.
- إعادة تعيين ذاتية — يغيّر كل مستخدم كلمة مروره عبر البريد.
- بصمة صغيرة جدًا — بضعة ميغابايتات من الذاكرة بجانب التطبيقات التي يخدمها.
حسابات محلية أم OpenLDAP أم LLDAP
مرّر الجدول أفقيًا
| حسابات محلية لكل تطبيق | OpenLDAP | LLDAP | |
|---|---|---|---|
| الحسابات المطلوب إدارتها | حساب لكل تطبيق | حساب لكل شخص | حساب لكل شخص |
| الإدارة | داخل كل تطبيق | ملفات LDIF وسطر الأوامر | واجهة ويب |
| البدء | لا شيء | مخططات وقوائم تحكم لكتابتها | حاوية واحدة وأربعة متغيرات |
| الذاكرة في الخمول | — | بضع عشرات من الميغابايتات | بضعة ميغابايتات |
| عند مغادرة موظف | حساب يجب إغلاقه في كل مكان | حساب واحد | حساب واحد |
تحضير الخادم
يكفي خادم VPS بنظام Ubuntu 24.04 وذاكرة 1 غيغابايت: يستهلك LLDAP بضعة ميغابايتات، وغالبًا ما يتقاسم الخادم مع التطبيقات التي يخدمها. ثبّت Docker وإضافة Compose، وجهّز نطاقًا فرعيًا مثل ldap.example.com يشير إلى الخادم: يجب أن تُخدم واجهة الإدارة عبر HTTPS لأن كلمات المرور تمر بها. أما منفذ LDAP فلن يُنشر على الإنترنت أبدًا.
تثبيت LLDAP باستخدام Docker Compose
تحضير المجلد وملف .env
ثلاثة أسرار: كلمة مرور حساب
admin، والمفتاح الذي يوقّع جلسات الواجهة، وبذرة المفتاح الخاص بالخادم.mkdir -p /opt/lldap && cd /opt/lldap cat > .env <<EOF ADMIN_PASSWORD=$(openssl rand -hex 16) JWT_SECRET=$(openssl rand -hex 32) KEY_SEED=$(openssl rand -hex 32) EOF chmod 600 .envكتابة ملف docker-compose.yml
خدمة واحدة. لا يُنشر المنفذان إلا على الواجهة المحلية: تمر واجهة الويب (17170) عبر nginx، ويبقى منفذ LDAP (3890) محجوزًا للخادم. استبدل
dc=example,dc=comبالقاعدة التي تختارها، مثلdc=yourcompany,dc=ma.services: lldap: image: lldap/lldap:v0.6.3-alpine restart: unless-stopped ports: - "127.0.0.1:17170:17170" - "127.0.0.1:3890:3890" environment: TZ: UTC LLDAP_LDAP_BASE_DN: "dc=example,dc=com" LLDAP_LDAP_USER_PASS: ${ADMIN_PASSWORD} LLDAP_JWT_SECRET: ${JWT_SECRET} LLDAP_KEY_SEED: ${KEY_SEED} LLDAP_HTTP_URL: "https://ldap.example.com" volumes: - lldap-data:/data networks: - lldap networks: lldap: name: lldap volumes: lldap-data: {}التشغيل والتحقق
عند التشغيل الأول، ينشئ LLDAP مجموعات النظام وحساب
adminبكلمة المرور الموجودة في ملف.env. يستجيب في بضع ثوانٍ.docker compose up -d docker compose logs lldap | grep -i admin curl -sI http://127.0.0.1:17170/ | head -n 1اختبار الدليل عبر LDAP
تتيح شبكة Docker المسماة
lldapلأي حاوية الوصول إلى الدليل باسمه. يجب أن يجيبldapwhoamiبالاسم المميز (DN) لحساب admin.docker run --rm --network lldap alpine:3.20 sh -c \ "apk add -q openldap-clients && ldapwhoami -x -H ldap://lldap:3890 \ -D uid=admin,ou=people,dc=example,dc=com -W"
غيّر كلمة مرور admin وأبقِ منفذ LDAP خاصًا
لا تُستخدم كلمة مرور LLDAP_LDAP_USER_PASS إلا عند التشغيل الأول: غيّرها بعد ذلك في الواجهة ولن تُستبدل. ولا تنشر المنفذ 3890 على 0.0.0.0 أبدًا: ينقل LDAP بدون TLS كلمات المرور كنص واضح، ولا تحتاج تطبيقاتك إلى الوصول إليه من الإنترنت.
نشر الواجهة عبر HTTPS خلف nginx
احصل على شهادة باستخدام certbot (certbot certonly --nginx -d ldap.example.com)، ثم عرّف كتلة server تمرّر الطلبات إلى المنفذ المحلي 17170. ضع العنوان نفسه في LLDAP_HTTP_URL: تستخدمه روابط إعادة تعيين كلمة المرور.
server {
listen 443 ssl;
server_name ldap.example.com;
ssl_certificate /etc/letsencrypt/live/ldap.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/ldap.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:17170;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}ربط تطبيقاتك بالدليل
أنشئ أولًا لكل تطبيق حساب خدمة (مثل svc-gitea) وضعه في مجموعة lldap_strict_readonly: يقرأ الدليل دون أن يغيّر شيئًا. ثم اربط حاوية التطبيق بشبكة lldap، وأدخل بيانات الدليل في إعدادات المصادقة الخاصة به:
docker network connect lldap gitea
# Server URL : ldap://lldap:3890
# Bind DN : uid=svc-gitea,ou=people,dc=example,dc=com
# User base : ou=people,dc=example,dc=com
# Filter : (&(objectClass=person)(uid=%s))ينطبق النمط نفسه على Nextcloud (تطبيق LDAP user and group backend) وAuthelia (authentication_backend.ldap مع التنفيذ lldap) وKeycloak (اتحاد مستخدمي LDAP). ولقصر الدخول على بعض المستخدمين، أضف إلى المرشّح شرط memberOf على مجموعة التطبيق.
تفعيل إعادة تعيين كلمات المرور بالبريد
بدون خادم SMTP، لا يستطيع تغيير كلمة مرور منسية إلا المسؤول. أضف المتغيرات التالية إلى خدمة lldap باستخدام حساب إرسال من بريدك، ثم شغّل docker compose up -d من جديد: يظهر رابط «نسيت كلمة المرور» في شاشة الدخول، ويشير البريد المرسل إلى العنوان المحدد في LLDAP_HTTP_URL.
environment:
LLDAP_SMTP_OPTIONS__ENABLE_PASSWORD_RESET: "true"
LLDAP_SMTP_OPTIONS__SERVER: smtp.example.com
LLDAP_SMTP_OPTIONS__PORT: "587"
LLDAP_SMTP_OPTIONS__SMTP_ENCRYPTION: STARTTLS
LLDAP_SMTP_OPTIONS__USER: [email protected]
LLDAP_SMTP_OPTIONS__PASSWORD: ${SMTP_PASSWORD}
LLDAP_SMTP_OPTIONS__FROM: "LLDAP <[email protected]>"جرّب بحساب عادي قبل إعلان الميزة للفريق: الرابط الذي يشير إلى localhost يعني أن العنوان العام لم يُعرَّف بشكل صحيح.
مثال: Authelia مستندًا إلى LLDAP
يعرف Authelia خادم LLDAP ويقدّم تنفيذًا مخصصًا يضبط المرشحات والسمات تلقائيًا. يجب أن ينتمي حساب الخدمة svc-authelia إلى مجموعة lldap_password_manager إذا أردت أن يغيّر المستخدمون كلمات مرورهم من Authelia؛ وإلا فتكفي مجموعة lldap_strict_readonly.
authentication_backend:
ldap:
implementation: lldap
address: ldap://lldap:3890
base_dn: dc=example,dc=com
user: uid=svc-authelia,ou=people,dc=example,dc=com
password: '<service-account-password>'اربط أخيرًا حاوية Authelia بشبكة lldap، وأعد تشغيلها، وسجّل الدخول بحساب أنشأته في LLDAP: الهوية نفسها تفتح الآن جميع التطبيقات التي يحميها Authelia.
النسخ الاحتياطي والتحديث
كل حالة LLDAP في المجلد lldap-data: قاعدة SQLite والإعدادات والمفتاح الخاص بالخادم. يكفي أرشيف لهذا المجلد، مع إيقاف LLDAP لبضع ثوانٍ، لاستعادة كل شيء.
cd /opt/lldap
docker compose stop lldap
docker run --rm -v lldap_lldap-data:/data -v "$PWD":/backup alpine:3.20 \
tar czf /backup/lldap-$(date +%F).tar.gz -C /data .
docker compose start lldapللتحديث، غيّر وسم الصورة في docker-compose.yml، واقرأ ملاحظات الإصدار، ثم شغّل docker compose pull && docker compose up -d: يرحّل LLDAP قاعدته عند التشغيل.
LLDAP بنقرة واحدة على ServOrbit
يثبّت متجر ServOrbit هذه الحزمة بالضبط: الصورة الرسمية lldap/lldap، وأسرار تُولَّد عند التثبيت، وحساب admin بكلمة مرور مولّدة، وواجهة ويب منشورة عبر HTTPS على نطاق فرعي من نطاقك أو على النطاق الفرعي المجاني للخادم، ومنفذ LDAP يبقى على الواجهة المحلية. تظهر كلمة المرور في مساحة العميل؛ ولا يبقى عليك إلا إنشاء مستخدميك وربط تطبيقاتك.
servorbit.com/ma-ar/المدونة/استضافة-lldap-على-vps
