📍 المقالة الرئيسية: Immich 2026: الدليل الكامل.
ثلاثون دقيقة لتحويل VPS فارغ إلى خادم صور عائلي حديث، مع HTTPS و ML محلي وتطبيق هاتف جاهز للـ upload. هذا الإجراء موثق في عدة عائلات في الدار البيضاء وداكار وتونس.
المتطلبات
VPS Hetzner CX42 minimum (4 vCPU، 16 جيجابايت RAM، 80 جيجابايت NVMe). Coolify v4 مثبَّت. Hetzner Storage Box 1-5 تيرابايت. اسم نطاق. المستوى: متوسط. الوقت: 30-60 دقيقة.
الخطوة 1 — تحضير DNS
أنشئ سجل A: photos.votre-famille.com → IP الـ VPS. تحقق من الانتشار:
dig +short photos.votre-famille.comالخطوة 2 — تثبيت Storage Box في NFS
Hetzner Storage Box يتطلب تفعيل NFS. ثم نُثبِّت العميل ونُثبِّت بشكل دائم عبر fstab:
apt install -y nfs-common
mkdir -p /mnt/photos
mount -t nfs -o vers=4 u123456.your-storagebox.de:/home /mnt/photos
echo "u123456.your-storagebox.de:/home /mnt/photos nfs vers=4,_netdev,auto 0 0" >> /etc/fstabالخطوة 3 — إنشاء خدمة Immich في Coolify
Resources → + New → Service → ابحث عن «Immich». Coolify ينشر القالب الرسمي. الاسم: immich-prod.
الخطوة 4 — تكوين متغيرات البيئة
المتغير UPLOAD_LOCATION على NFS Storage Box أساسي: بدونه، صورك تملأ SSD الـ VPS:
UPLOAD_LOCATION=/mnt/photos/immich-upload
DB_PASSWORD=mot-de-passe-32-caractères
DB_USERNAME=immich
DB_DATABASE_NAME=immich
TZ=Africa/Casablanca
IMMICH_VERSION=releaseالخطوة 5 — تكوين النطاق HTTPS
تبويب Domains: https://photos.votre-famille.com. Force HTTPS.
الخطوة 6 — إطلاق النشر
اضغط Deploy. Coolify يسحب 5 صور Docker (immich-server، machine-learning، postgres، redis، typesense). احسب 3 إلى 5 دقائق.
الخطوة 7 — الحساب المسؤول الأول
افتح https://photos.votre-famille.com. أنشئ أول حساب admin. كلمة سر قوية 14+ حرفاً.
الخطوة 8 — تكوين Machine Learning
Settings → Machine Learning. لـ CX42، اختر نموذج CLIP الخفيف ViT-B-32__openai. فعِّل Smart Search و Face Recognition.
الخطوة 9 — اختبار upload
Upload 10 صور. تحقق: ميزات مُولَّدة، EXIF مستخرج، Smart Search يعمل.
الأخطاء الشائعة
| الخطأ | الحل |
|---|---|
| Container ML reboot loop | الانتقال إلى CCX23 |
| NFS بطيء | تفعيل NFS في لوحة Hetzner |
| Disk ممتلئ | UPLOAD_LOCATION على /mnt/photos |
التكيف مع السياق
اختيار Storage Box vs S3: Hetzner Storage Box (NFS) أكثر عملية لـ Immich. حصص لكل مستخدم: 100 جيجابايت/شخص. روابط عامة: لمشاركة ألبوم زفاف مع العائلة في السنغال ومالي.
للاستزادة
- 🔝 المرجع: الدليل الكامل Immich 2026