الاستضافة الذاتية

LLDAP على خادم VPS: دليل LDAP خفيف لتطبيقاتك

يأتي كل تطبيق مستضاف ذاتيًا بقائمة مستخدمين خاصة به: حساب في Gitea وآخر في Nextcloud وثالث في Grafana، وكلمات مرور بالعدد نفسه يجب إلغاؤها يوم يغادر أحدهم الفريق. يحل دليل LDAP هذه المشكلة منذ عشرين عامًا، لكن OpenLDAP ينفّر معظم الفرق الصغيرة. يحتفظ LLDAP بالأساسيات في حاوية خفيفة واحدة. يثبّته هذا الدليل على خادم VPS باستخدام Docker Compose، وينشر واجهته عبر HTTPS خلف nginx، ويُبقي منفذ LDAP خاصًا، ثم يربط به تطبيقاتك.

انشر على VPS Cloud ←
7 دقائق للقراءةعدد الخطوات: 4

Orbi وكيل ذكاء اصطناعيالفهرس يتبع المقال، والمقالات ذات الصلة في أسفل الصفحة.

المحتويات· ماذا يفعل LLDAP1/12
  1. 01ماذا يفعل LLDAP
  2. 02ما يقدمه لك LLDAP
  3. 03حسابات محلية أم OpenLDAP أم LLDAP
  4. 04تحضير الخادم
  5. 05تثبيت LLDAP باستخدام Docker Compose
  6. 06غيّر كلمة مرور admin وأبقِ منفذ LDAP خاصًا
  7. 07نشر الواجهة عبر HTTPS خلف nginx
  8. 08ربط تطبيقاتك بالدليل
  9. 09تفعيل إعادة تعيين كلمات المرور بالبريد
  10. 10مثال: Authelia مستندًا إلى LLDAP
  11. 11النسخ الاحتياطي والتحديث
  12. 12LLDAP بنقرة واحدة على ServOrbit

ماذا يفعل LLDAP

LLDAP خادم دليل حر مكتوب بلغة Rust. يخزّن المستخدمين والمجموعات في قاعدة SQLite، ويعرضها على التطبيقات عبر بروتوكول LDAP، ويمنح المسؤولين واجهة ويب لإدارتها. لا يحاول فعل كل شيء: لا مخططات لكتابتها، ولا نسخ متماثل، ولا قوائم تحكم دقيقة. يفعل ما يحتاجه Authelia وGitea وNextcloud وKeycloak وJellyfin — التحقق من كلمة مرور وسرد أعضاء مجموعة — ولا شيء أكثر.

ما يقدمه لك LLDAP

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

حسابات محلية أم OpenLDAP أم LLDAP

مرّر الجدول أفقيًا

حسابات محلية لكل تطبيقOpenLDAPLLDAP
الحسابات المطلوب إدارتهاحساب لكل تطبيقحساب لكل شخصحساب لكل شخص
الإدارةداخل كل تطبيقملفات LDIF وسطر الأوامرواجهة ويب
البدءلا شيءمخططات وقوائم تحكم لكتابتهاحاوية واحدة وأربعة متغيرات
الذاكرة في الخمول—بضع عشرات من الميغابايتاتبضعة ميغابايتات
عند مغادرة موظفحساب يجب إغلاقه في كل مكانحساب واحدحساب واحد

تحضير الخادم

يكفي خادم VPS بنظام Ubuntu 24.04 وذاكرة 1 غيغابايت: يستهلك LLDAP بضعة ميغابايتات، وغالبًا ما يتقاسم الخادم مع التطبيقات التي يخدمها. ثبّت Docker وإضافة Compose، وجهّز نطاقًا فرعيًا مثل ldap.example.com يشير إلى الخادم: يجب أن تُخدم واجهة الإدارة عبر HTTPS لأن كلمات المرور تمر بها. أما منفذ LDAP فلن يُنشر على الإنترنت أبدًا.

تثبيت LLDAP باستخدام Docker Compose

  1. تحضير المجلد وملف ‎.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
  2. كتابة ملف 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: {}
  3. التشغيل والتحقق

    عند التشغيل الأول، ينشئ 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
  4. اختبار الدليل عبر 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

دليل واحد لجميع تطبيقاتك

الأسعار المعروضة قبل الضريبة، مع سعر التجديد.