🛠️ تثبيت Lychee — مدير ألبومات صور ذاتي الاستضافة

انشر Lychee على Ubuntu بـ Docker — معرض صور ذاتي الاستضافة سريع ونظيف لتنظيم الألبومات ومشاركة الصور، باستخدام SQLite دون قاعدة بيانات منفصلة، على المنفذ 8184.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Lychee على المنفذ 8184 بقاعدة بيانات SQLite مدمجة؛ أنشئ حساب المشرف عند أول زيارة.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/lychee/lychee-ubuntu.sh
chmod +x lychee-ubuntu.sh
sudo bash lychee-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/lychee/lychee-ubuntu.sh

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

chmod +x lychee-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم الأمر ويشغّل lycheeorg/lychee على المنفذ 8184 مع ضبط DB_CONNECTION على sqlite، فلا حاجة لقاعدة بيانات منفصلة، مع أحجام تخزين للرفع والإعدادات والسجلات.

sudo bash lychee-ubuntu.sh

4 إنشاء حساب المشرف

افتح Lychee وأنشئ حساب المشرف عند أول زيارة، ثم ابدأ برفع الصور إلى الألبومات:

http://<your-server-ip>:8184

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

المنفذالغرض
8184Web UI (host → container 80) — admin created on first visit
DB_CONNECTIONsqlite — no separate MySQL/MariaDB container
./uploadsYour photos (also ./conf, ./sym, ./logs)

نظرة عامة

Lychee تطبيق إدارة صور مجاني ومفتوح المصدر برخصة MIT، مبني بلغة PHP (إطار Laravel)، تُشغّله على سيرفرك الخاص لتنظيم الصور وعرضها ومشاركتها في ألبومات. يركّز على إتقان مهمة واحدة: معرض نظيف وسريع وجميل المظهر، بدلاً من محاولة أن يكون بديلاً كاملاً لـ Google Photos بنسخ احتياطي تلقائي من الهاتف وميزات ذكاء اصطناعي. في هذا النشر، يُضبط DB_CONNECTION على sqlite، فيعمل Lychee بالكامل من حاوية خفيفة واحدة دون خدمة MySQL أو MariaDB منفصلة يجب إدارتها، مما يبقي البنية بسيطة وسهلة النسخ الاحتياطي.

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

يمنحك Lychee ملكية كاملة لمكتبة صورك بدلاً من الوثوق بها لخدمة صور سحابية، مع بقائه خفيفاً وبسيط التشغيل — لا حدود للتخزين، ولا إعادة ضغط لصورك الأصلية، ودعم كامل لبيانات EXIF/IPTC الوصفية. إنه مثالي عندما يكون ما تحتاجه فعلياً نظام ألبومات منسّق مع روابط مشاركة نظيفة عامة أو محمية بكلمة مرور، وليس البنية الأثقل للنسخ الاحتياطي التلقائي من الهاتف والتعرف على الوجوه التي تقدمها أدوات مثل Immich أو PhotoPrism. ولأن هذا النشر يستخدم SQLite بدلاً من حاوية قاعدة بيانات منفصلة، يصبح المعرض بأكمله — التطبيق والبيانات — سهل الفهم والنقل والنسخ الاحتياطي كمجموعة صغيرة من الملفات والأحجام.

متى تحتاجه

  • تريد استضافة ألبومات صورك بنفسك والتوقف عن الاعتماد على Google Photos أو iCloud أو معرض طرف ثالث آخر
  • تحتاج طريقة بسيطة لمشاركة ألبومات منسّقة مع العائلة أو الأصدقاء عبر رابط، مع إمكانية حمايته بكلمة مرور
  • تريد معرضاً خفيفاً يعمل بسلاسة على أجهزة متواضعة دون بنية ثقيلة متعددة الحاويات
  • تفضّل حاوية واحدة مدعومة بـ SQLite بدلاً من إدارة قاعدة بيانات MySQL/MariaDB منفصلة
  • تحتاج الحفاظ على جودة الصور الأصلية وبياناتها الوصفية (EXIF، IPTC) دون أي إعادة ضغط تلقائية
  • تريد استيراد صور موجودة من جهازك أو مجلد على السيرفر أو رابط أو Dropbox إلى ألبومات منظمة

من يحتاجه

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

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

  • تنظيم الصور في ألبومات وألبومات فرعية متداخلة للرحلات أو المناسبات أو المشاريع
  • مشاركة ألبوم علناً أو برابط محمي بكلمة مرور مع العائلة والأصدقاء
  • استيراد مجموعات صور موجودة من مجلد محلي أو رابط أو Dropbox
  • وسم الصور والبحث فيها حسب البيانات الوصفية أو الموقع أو وسوم مخصصة
  • عرض معرض محفظة أعمال علني للتصوير الفوتوغرافي أو الأعمال الإبداعية
  • الحفاظ على ملفات الصور الأصلية مع بيانات EXIF وIPTC الوصفية كاملة، دون إعادة ضغط

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

  • واجهة معرض نظيفة وسريعة وحديثة مع تنظيم بألبومات وألبومات فرعية متداخلة
  • روابط مشاركة عامة بنقرة واحدة لكل ألبوم، مع إمكانية حمايتها بكلمة مرور
  • لا حدود للتخزين ولا إعادة ضغط تلقائية — تُحفظ الصور الأصلية تماماً كما رُفعت
  • دعم كامل لبيانات EXIF وIPTC الوصفية، بما فيها تفاصيل الكاميرا والموقع الجغرافي عند توفره
  • استيراد الصور من جهاز محلي أو مسار على السيرفر أو رابط مباشر أو Dropbox
  • الوسم والبحث عبر مكتبتك للعثور بسرعة على صور محددة
  • دعم SQLite لنشر خفيف بحاوية واحدة دون خدمة قاعدة بيانات منفصلة
  • نواة مفتوحة المصدر برخصة MIT، مع نسخة Supporter Edition (SE) اختيارية مدفوعة تضيف ميزات إضافية

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

  • افتح واجهة الويب على http://your-server-ip:8184 وأنشئ حساب المشرف عند أول زيارة
  • اضبط متغير البيئة APP_URL ليطابق العنوان الحقيقي الذي ستصل من خلاله إلى Lychee، حتى تُحل روابط المشاركة المُولّدة بشكل صحيح
  • أنشئ أول ألبوم من لوحة التحكم، ثم اسحب وأفلت الصور أو استخدم زر الرفع لإضافتها
  • نظّم الألبومات المترابطة في ألبومات فرعية متداخلة لبناء هيكل منطقي للرحلات أو المناسبات أو المواضيع
  • ولّد رابط مشاركة لألبوم من إعداداته، وأضف كلمة مرور إذا أردت تقييد من يستطيع عرضه
  • استخدم خيارات الاستيراد لجلب صور موجودة من مجلد محلي أو رابط أو حساب Dropbox متصل
  • أضف وسوماً للصور لتسريع البحث والتصفية في المكتبات الكبيرة
  • راجع الإعدادات لخيارات العرض وترتيب الألبومات الافتراضي وتفضيلات حساب المستخدم

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

  • لا تكشف المنفذ 8184 مباشرة للإنترنت بدون HTTPS — ضع Lychee خلف وكيل عكسي مثل Nginx Proxy Manager مع شهادة TLS صالحة
  • عيّن كلمة مرور قوية للمشرف عند إنشاء الحساب في أول زيارة، لأنه يملك تحكماً كاملاً في المكتبة والإعدادات
  • اضبط APP_URL دائماً على عنوان HTTPS الحقيقي قبل مشاركة الروابط علناً، حتى تُولَّد الروابط بشكل صحيح ولا تكشف عنواناً داخلياً
  • استخدم حماية كلمة المرور على أي ألبوم لا تريده عاماً بالكامل، وتجنب كلمات المرور السهلة التخمين
  • قيّد الوصول المباشر للمنفذ 8184 في جدار الحماية على المضيف المحلي أو VPN إذا كنت تحتاج الوصول فقط عبر وكيل عكسي
  • حدّث صورة Lychee Docker باستمرار للحصول على إصلاحات أمنية للتطبيق واعتمادياته من PHP
  • انسخ ملف قاعدة بيانات SQLite احتياطياً بانتظام لأنه يحتوي على جميع الألبومات وحسابات المستخدمين وإعدادات المشاركة

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

يستمع Lychee داخلياً على المنفذ 80؛ يقوم المثبّت المستخدم في هذا الدليل بنشره على المنفذ 8184 على المضيف، لذا تصفّح http://your-server-ip:8184. ولأن DB_CONNECTION مضبوط على sqlite، لا يوجد منفذ أو حاوية قاعدة بيانات منفصلة يجب كشفها — كل شيء يمر عبر منفذ الويب الواحد. يجب ألا يُفتح المنفذ 8184 مباشرة للإنترنت العام بدون وكيل عكسي يوفر HTTPS، وإلا ستنتقل بيانات تسجيل الدخول وأي روابط ألبومات محمية بكلمة مرور دون تشفير. ضع Lychee خلف Nginx Proxy Manager على المنفذ 443 مع شهادة صالحة، واضبط APP_URL ليطابق ذلك العنوان العام عبر HTTPS، وقيّد الوصول المباشر للمنفذ 8184 في جدار الحماية على المضيف المحلي أو VPN فقط.

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

  • انسخ حجم uploads احتياطياً أولاً وقبل كل شيء — فهو يحتوي على ملفات صورك الفعلية ولا يمكن إعادة توليدها إذا فُقدت
  • انسخ حجم conf احتياطياً، فهو يحتوي على إعدادات التطبيق وقاعدة بيانات SQLite بألبوماتك ومستخدميك وإعدادات المشاركة
  • انسخ حجمي sym وlogs احتياطياً للاكتمال، رغم أنهما أقل أولوية من uploads وconf
  • انسخ docker-compose.yml أو أمر docker run الخاص بك مع أي متغيرات بيئة (APP_URL، DB_CONNECTION) لإعادة إنشاء نفس الإعداد بالضبط
  • خزّن النسخ الاحتياطية على تخزين منفصل عن المضيف، لأن مكتبات الصور قد تكبر كثيراً ويجب ألا يعني عطل قرص واحد فقدان كل البيانات
  • اختبر الاستعادة دورياً على سيرفر احتياطي للتأكد من عودة الألبومات والصور وروابط المشاركة بشكل صحيح

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

  • كشف المنفذ 8184 للإنترنت بدون HTTPS، مما يرسل بيانات تسجيل الدخول وروابط المشاركة دون تشفير
  • نسيان ضبط APP_URL على العنوان العام الحقيقي، مما يكسر روابط المشاركة المُولّدة عند الوصول عبر وكيل عكسي أو نطاق
  • الاكتفاء بنسخ قاعدة البيانات احتياطياً ونسيان حجم uploads، وهو بيانات الصور الفعلية غير القابلة للاستبدال
  • افتراض أن Lychee ينسخ الهواتف احتياطياً تلقائياً مثل Immich أو PhotoPrism — إنه معرض استيراد يدوي وليس أداة نسخ احتياطي تلقائي من الهاتف
  • مشاركة ألبوم علناً دون كلمة مرور بينما كان يُقصد أن يبقى خاصاً
  • تشغيل Lychee بدون restart: unless-stopped، مما يترك المعرض غير متصل بعد إعادة تشغيل السيرفر حتى إعادة التشغيل اليدوية
  • توقّع ميزات خاصة بـ MySQL فقط أثناء تشغيل إعداد SQLite — بعض المكتبات الكبيرة جداً قد تعمل بأداء أفضل على قاعدة بيانات MySQL/MariaDB مخصصة

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

  • لا يمكن الوصول لواجهة الويب — تأكد من تشغيل الحاوية بـ docker ps، وتحقق من فتح المنفذ 8184، وتأكد من عدم حظره بجدار الحماية
  • روابط المشاركة تشير إلى عنوان خاطئ — تحقق من أن متغير البيئة APP_URL يطابق النطاق أو IP الفعلي الذي تصل منه إلى Lychee
  • فشل الرفع أو ظهور الصور كأنها مفقودة — تحقق من صلاحيات حجم uploads ومساحة القرص الحرة الكافية على المضيف
  • الصور تفقد بياناتها الوصفية بعد الرفع — تأكد من أن الملفات الأصلية تحتوي على بيانات EXIF/IPTC قبل الرفع، لأن Lychee يحافظ عليها ولا يضيف بيانات مفقودة
  • أداء بطيء مع مكتبة كبيرة جداً — فكّر في تحويل DB_CONNECTION من sqlite إلى MySQL/MariaDB للمكتبات التي تضم عشرات آلاف الصور
  • شاشة إعداد حساب المشرف تظهر مجدداً بعد إعادة التشغيل — تأكد من أن حجم conf (الذي يحتوي قاعدة بيانات SQLite) مربوط بشكل صحيح ودائم
  • فشل مطالبات الألبوم المحمي بكلمة مرور — امسح ذاكرة التخزين المؤقت وملفات تعريف الارتباط للمتصفح وتأكد من ضبط كلمة المرور بشكل صحيح في إعدادات مشاركة الألبوم

البدائل

Immich وPhotoPrism هما المقارنة الأكثر شيوعاً — كلاهما يقدم نسخاً احتياطياً تلقائياً من الهاتف وتعرفاً على الوجوه وبحثاً مدعوماً بالذكاء الاصطناعي، لكنهما يعملان كبنية أثقل متعددة الحاويات (غالباً تتضمن خدمات تعلم آلي) وتحتاجان موارد أكثر. Lychee أضيق نطاقاً عمداً: مدير ألبومات منسّق يركّز على تنظيم الصور وعرضها بشكل نظيف، وليس استبدال تطبيق النسخ الاحتياطي لهاتفك. Piwigo خيار معرض ذاتي الاستضافة عريق آخر بنظام إضافات كبير، رغم أن واجهته تبدو أقدم من واجهة Lychee. تطبيق Photos الخاص بـ Nextcloud خيار معقول إذا كنت تشغّل Nextcloud بالفعل لتخزين الملفات وتريد تصفح صور أساسياً مدمجاً بدلاً من معرض مخصص. لمعرض ألبومات سريع وجميل المظهر منخفض العبء يعمل بسلاسة على أجهزة متواضعة، يبقى Lychee خياراً قوياً ومركّزاً.

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

Lychee ليس حل نسخ احتياطي للهاتف — لا يملك تطبيق جوال يرفع الصور الجديدة تلقائياً من ألبوم الكاميرا كما يفعل Immich أو PhotoPrism، فأنت ترفع الصور يدوياً أو عبر الاستيراد. إذا كنت تحتاج التعرف على الوجوه أو البحث المدعوم بالذكاء الاصطناعي أو التنظيم التلقائي حسب الأشخاص والأشياء، فإن Immich أو PhotoPrism مصممان لذلك خصيصاً ولن يضاهيهما Lychee. بالنسبة للمكتبات الضخمة جداً (عشرات آلاف الصور وأكثر)، قد يصبح إعداد SQLite المستخدم في هذا الدليل عنق زجاجة — يُنصح بالتحول إلى MySQL/MariaDB عند هذا الحجم. وإذا كانت أسرتك مستثمرة بالفعل في Google Photos أو iCloud للنسخ الاحتياطي التلقائي، فإن الانتقال الكامل بعيداً عنها يتطلب عمل تصدير واستيراد يدوي لا يؤتمته Lychee نيابة عنك.

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

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

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

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

هل يحتاج Lychee إلى MySQL أو MariaDB؟

ليس في هذا النشر — DB_CONNECTION مضبوط على sqlite، فيستخدم Lychee قاعدة بيانات SQLite مدمجة ولا حاجة لحاوية MySQL أو MariaDB منفصلة. هذا يبقيه خفيفاً وسهل النسخ الاحتياطي، لأن قاعدة البيانات تعيش بجانب التطبيق بدلاً من خدمة منفصلة.

كيف يختلف عن Immich أو PhotoPrism؟

Lychee معرض منسّق، وليس بديلاً لـ Google Photos. يقدم Immich وPhotoPrism نسخاً احتياطياً من الهاتف وتعرفاً على الوجوه وبحثاً بالذكاء الاصطناعي، لكنهما بنية ثقيلة متعددة الحاويات. يركّز Lychee على تنظيم الألبومات وعرضها بشكل نظيف، ويعمل بسلاسة على أجهزة متواضعة.

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

المنفذ 8184 على المضيف، المرتبط بالمنفذ الداخلي 80 في الحاوية. تصفّح 8184؛ أما 80 فهو المنفذ داخل الحاوية. تُبنى روابط المشاركة من APP_URL، لذا احرص على أن يطابق عنوانك الحقيقي.

ما الذي أحتاج نسخه احتياطياً؟

حجم uploads أولاً وقبل كل شيء — فهو يحتوي صورك الفعلية ولا يمكن استبداله — إضافة إلى حجم conf الذي يحتوي الإعدادات وقاعدة بيانات SQLite. ولأن قاعدة البيانات SQLite، فهي جزء من ملفات التطبيق وليست حاوية منفصلة.

هل يمكنني مشاركة الألبومات مع أشخاص آخرين؟

نعم — يمكنك توليد رابط مشاركة لأي ألبوم وحمايته اختيارياً بكلمة مرور. إذا كنت تشارك عبر الإنترنت، ضع Lychee خلف وكيل عكسي بـ TLS حتى تُحمّل تلك الروابط عبر HTTPS، وتأكد من مطابقة APP_URL لعنوانك العام حتى تُحل الروابط بشكل صحيح.