Immich

Immich بديل مفتوح المصدر لخدمة Google Photos. يرفع صور هاتفك وفيديوهاته تلقائياً إلى خادم تتحكم به أنت، ويوفر خطاً زمنياً للصور، وألبومات مشتركة، وبحثاً بمحتوى الصورة، والتعرف على الوجوه، وخريطة لأماكن التصوير. يستخدمه أفراد يريدون إخراج ذكرياتهم من السحابات الأمريكية، وكذلك العائلات والفرق الصغيرة والمصورون الذين يحتاجون إلى مكتبة مركزية واحدة.

عند تسليم الخادم يكون سكربت cloud-init قد ثبّت Docker Engine وإضافة Compose من المستودع الرسمي لـ Docker، ثم نزّل الملف docker-compose.yml ومثال .env الخاصين بآخر إصدار من Immich إلى المجلد /opt/immich. وتم توليد كلمة مرور عشوائية لقاعدة البيانات وتشغيل الحاويات. تستمع واجهة الويب على المنفذ 2283.

لا يُنشأ أي حساب مدير مسبقاً: أول مستخدم يسجّل في النظام يصبح هو المدير. أما المعلومات التي تحتاجها (العنوان والمسارات وكلمة مرور قاعدة البيانات) فتجدها في /tmp/credentials.txt، وهو ملف يقرؤه المستخدم root فقط.

ما الذي ثُبّت على الخادم

كل شيء داخل /opt/immich: الملف docker-compose.yml، والملف .env (صلاحياته 600 لأنه يحوي كلمة مرور القاعدة)، والمجلد library للصور، والمجلد postgres لبيانات القاعدة. أما سجل التثبيت ففي /var/log/immich-auto-install.log.

تُنفَّذ أوامر Compose من هذا المجلد:

Bash
1cd /opt/immich
2docker compose ps
3docker compose logs -f immich-server

تفعيل HTTPS عبر reverse proxy

تعمل الخدمة عبر HTTP عادي على المنفذ 2283. قبل ربط هواتفك بها من خارج الشبكة، ضعها خلف reverse proxy (مثل Caddy أو Nginx أو Traefik) يحصل على شهادة للنطاق YOUR_DOMAIN. ومع Caddy تكفي بضعة أسطر:

YOUR_DOMAIN {
    reverse_proxy 127.0.0.1:2283
}

إذا استخدمت Nginx فارفع قيمة client_max_body_size، وإلا فسيفشل رفع مقاطع الفيديو الكبيرة.

نقطة أخرى يجدر بك معرفتها: ينشر Docker المنافذ متجاوزاً قواعد UFW. ولكي لا يبقى المنفذ 2283 متاحاً مباشرة بعد تشغيل الـ proxy، عدّل سطر ports للخدمة immich-server في docker-compose.yml ليستمع على 127.0.0.1:2283، ثم أعد التشغيل بالأمر docker compose up -d.

النسخ الاحتياطي

عليك نسخ المكتبة وقاعدة البيانات معاً، لأن استعادة أحدهما دون الآخر لا تعطي نظاماً سليماً. أبسط طريقة أن توقف الحاويات، وتنسخ المجلدين إلى تخزين خارجي، ثم تعيد التشغيل.

Bash
1cd /opt/immich
2docker compose stop
3tar -czf /root/immich-backup.tar.gz library postgres .env
4docker compose start

إذا كانت مكتبتك كبيرة ففضّل rsync إلى جهاز آخر، وجرّب الاستعادة مرة واحدة على الأقل. النسخة المحفوظة على قرص الخادم نفسه لا تحميك إذا تعطل القرص.

التحديثات

الملفات المنزّلة تطابق الإصدار المنشور وقت التسليم. وللانتقال إلى إصدار أحدث اقرأ أولاً ملاحظات الإصدار الخاصة بالمشروع، فـ Immich يتطور بسرعة وبعض الإصدارات تتطلب خطوة يدوية. ثم نفّذ:

Bash
1cd /opt/immich
2docker compose pull
3docker compose up -d

خذ نسخة احتياطية قبل كل تحديث رئيسي. وللمزيد من الدروس حول إدارة خادم VPS راجع قسم Learn، وتجد تفاصيل العروض في صفحة VPS لينكس.