Technical Anshu
Tutorials Blog
📸 تثبيت إيميتش دوكر

قم بتثبيت Immich مع Docker لسحابة الصور الخاصة بك

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

✍️ Technical Anshu🐳 Docker / Linux Server⏱️ 15 minute install
🎥 شاهد أسرع طريقة في الفيديو — التثبيت الكامل لـ Immich Docker، خطوة بخطوة

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

Terminal — the whole install is four commands
$ mkdir ./immich-app && cd ./immich-app $ wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml $ wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env $ docker compose up -d

👆 مسار التثبيت الرسمي من وثائق Immich — ملفان تم تنزيلهما، وأمر واحد، والخادم نشط.

1

ما تحتاجه قبل البدء

Immich عبارة عن منصة نسخ احتياطي للصور والفيديو ذاتية الاستضافة - فكر في صور Google، ولكن الخادم عبارة عن جهاز في منزلك ولا يحتفظ أي شخص آخر بصورك. إنه مجاني ومفتوح المصدر، والطريقة الرسمية لتشغيله هي Docker Compose على خادم Linux أو جهاز كمبيوتر قديم أو جهاز كمبيوتر صغير أو NAS يدعم Docker.

  1. جهاز يظل قيد التشغيل: جهاز كمبيوتر صغير، أو سطح مكتب قديم، أو خادم منزلي، أو NAS. الكمبيوتر المحمول الذي ينام كل مساء هو خادم صور سيء
  2. تم تثبيت Docker وDocker Compose ويعملان - اختبرهما باستخدام docker compose version
  3. ذاكرة الوصول العشوائي: حوالي 4 جيجابايت هي الأرضية العملية؛ حاوية التعلم الآلي هي الجزء المتعطش، لذا فإن 6-8 جيجابايت أكثر سعادة بشكل ملحوظ
  4. سعة التخزين: مكتبة الصور الكاملة لديك، بالإضافة إلى ما يقرب من 10-20 بالمائة إضافية للصور المصغرة ومقاطع الفيديو المحولة ترميزها. التخزين - وليس وحدة المعالجة المركزية - هو ما ستنفد منه أولاً
  5. توقعات صادقة: إن Immich هو مشروع شاب قيد التطوير النشط. إنه ممتاز، لكن المطورين أنفسهم نصحوا دائمًا بالاحتفاظ بنسخة احتياطية أخرى من الصور التي لا يمكن تعويضها. يتبع هذا الدليل هذه النصيحة في كل مكان
2

قم بتنزيل الملفين الرسميين

لا تقم مطلقًا بنسخ ملف إنشاء عامل إرساء عشوائي من مدونة أو منشور في المنتدى - فالإصدارات تنجرف ويمكن لملف غريب أن يعلقك على بنية قديمة. الملفات الرسمية موجودة دائمًا على صفحة إصدار GitHub الخاصة بالمشروع:

  1. قم بإنشاء المجلد: mkdir ./immich-app وانتقل إليه باستخدام cd ./immich-app
  2. قم بتنزيل ملف الإنشاء: wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
  3. تنزيل قالب البيئة: wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
  4. لاحظ إعادة التسمية في هذا الأمر الثاني - يُسمى القالب example.env، لكن Docker يقرأه فقط إذا تم تسمية الملف بالضبط .env
3

قم بتحرير ملف .env - التكوين الوحيد المهم

يحتوي الملف .env على القيم القليلة التي لا يستطيع Immich تخمينها. افتحه باستخدام nano .env وقم بتعيين ما يلي:

  1. UPLOAD_LOCATION=./library — حيث ستظل صورك ومقاطع الفيديو الأصلية موجودة. قم بتوجيه هذا إلى القرص الأكبر والأكثر موثوقية لديك. يجب أن يكون مجلدًا به مساحة خالية كافية للمكتبة بأكملها
  2. DB_DATA_LOCATION=./postgres — حيث توجد قاعدة البيانات. احتفظ بهذا على محرك أقراص SSD محلي. وثائق Immich صريحة: مشاركات الشبكة غير مدعومة لقاعدة البيانات، وتشغيلها يمكن أن يؤدي إلى إتلافها
  3. DB_PASSWORD= — قم بتغيير هذا إلى كلمة مرور عشوائية طويلة. استخدم الأحرف والأرقام فقط (A-Z، a-z، 0-9) — يمكن للأحرف الخاصة تعطيل تحليل Docker للملف
  4. TZ=Asia/Kolkata — قم بإلغاء التعليق وضبط منطقتك الزمنية بحيث تتوافق تواريخ الصور والمهام المجدولة
  5. اترك IMMICH_VERSION وكل شيء أسفل الخط المحدد وحده للتثبيت الأول
4

ابدأ المكدس وأنشئ حساب المسؤول

  1. تشغيل docker compose up -d — يقوم Docker بتنزيل أربع صور للحاويات وتشغيلها معًا. يستغرق التشغيل الأول بضع دقائق حسب سرعة الإنترنت لديك
  2. تحقق من كل ما تم التوصل إليه مع docker compose ps — يجب أن ترى الخادم والتعلم الآلي وقاعدة البيانات وحاويات Redis قيد التشغيل
  3. افتح http://YOUR-SERVER-IP:2283 في متصفح على نفس الشبكة. إجابات Imich على المنفذ 2283
  4. انقر من خلال شاشة الترحيب وقم بالتسجيل. أول حساب يتم إنشاؤه يصبح هو المسؤول — لذا قم بهذه الخطوة بنفسك، على الفور، قبل أن يعثر أي شخص آخر على شبكتك على الصفحة
  5. في الداخل، افتح الإدارة وقم بإجراء عمليات فحص التخزين والمكتبة. ثم قم بتثبيت تطبيق Immich المجاني على هاتفك، وقم بتسجيل الدخول بنفس عنوان الخادم، وقم بتشغيل النسخ الاحتياطي التلقائي
5

ما بدأ للتو - أربع حاويات، أربع وظائف

يشغل ملف الإنشاء الذي قمت بتنزيله فريقًا صغيرًا، وليس برنامجًا واحدًا:

  1. خادم immich — الدماغ. واجهة الويب وواجهة برمجة التطبيقات (API) التي يتصل بها هاتفك والتحميلات والألبومات والمشاركة والبحث
  2. التعلم الآلي المتكامل — العيون. يتم تشغيل اكتشاف الوجه والتعرف على الوجه والبحث الذكي هنا في الخلفية
  3. قاعدة البيانات (PostgreSQL) — الذاكرة. اسم كل صورة وتاريخها وألبومها ووجهها وبيانات البحث موجودة هنا. النسخ الأصلية هي ملفات؛ المعنى موجود في قاعدة البيانات هذه
  4. redis — الرسول. يقوم بتمرير المهام بين الخادم والعاملين في الخلفية

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

6

القواعد الثلاث التي يجب اتباعها من اليوم الأول

  1. اقرأ قبل التحديث. إصدارات Immich كثيرًا وتحتوي بعض الإصدارات على تغييرات عاجلة تحتاج إلى خطوة ترقية محددة. دقيقتان مع ملاحظات الإصدار تتفوق على عطلة نهاية الأسبوع للتعافي
  2. قم بعمل نسخة احتياطية من الزوج، وليس الصور فقط. تفقد ملفات مكتبتك بدون قاعدة البيانات ألبوماتها ووجوهها وتنظيمها. نسخة احتياطية حقيقية تغطي كليهما
  3. لا تعرض أبدًا المنفذ الأولي للإنترنت. يعد المنفذ 2283 الموجود على شبكتك المنزلية أمرًا جيدًا. على الإنترنت المفتوح، استخدم VPN أو نفقًا - يشرح دليل الوصول عن بعد الموجود في هذه الصفحة السبب والكيفية

اتبع هؤلاء الثلاثة وستجد أن Immich عبارة عن سحابة خاصة يمكن الاعتماد عليها حقًا. تجاهلهم وسيصبح نفس البرنامج حكاية تحذيرية - الفرق هو العادات، وليس الأداة.

🔴 مذكرة الصدق التي قدمها إيميتش نفسه: المشروع قيد التطوير النشط ويتغير بسرعة. تعامل مع Immich باعتباره منصة للصور الخاصة بك، وليس نسختك الوحيدة. احتفظ بنسخة احتياطية منفصلة للمكتبة وقاعدة البيانات - يعرض دليل النسخ الاحتياطي المرتبط بهذه الصفحة الروتين الكامل.

🎥 شاهد العملية كاملة في الفيديو

يتم عرض التثبيت الكامل - إعداد الخادم واتصال تطبيق الهاتف والنسخ الاحتياطي الأول - مباشرةً في الفيديو.

▶️ Watch Full Video
❓ الأسئلة المتداولة

هل Immich مجاني حقًا، أم أن هناك طبقة مدفوعة؟

Immich هو برنامج مجاني ومفتوح المصدر بموجب ترخيص AGPL، وقد التزم المشروع بالحفاظ على جميع الميزات مجانية - لا توجد طبقة محمية بنظام حظر الاشتراك غير المدفوع. توجد عملية شراء اختيارية فقط لدعم المطورين ولا تفتح أي شيء. تكاليفك الحقيقية هي الأجهزة والكهرباء الخاصة بك.

ما مقدار ذاكرة الوصول العشوائي (RAM) وسعة التخزين التي يحتاجها Imich فعليًا؟

خطط لحوالي 4 غيغابايت من ذاكرة الوصول العشوائي (RAM) كحد أدنى - حاوية التعلم الآلي هي الجزء المتعطش - ومساحة تخزين تعادل مكتبة الصور بأكملها بالإضافة إلى ما يقرب من 10-20 بالمائة إضافية للصور المصغرة ومقاطع الفيديو المحولة ترميزها. ينفد التخزين قبل وقت طويل من نفاذ وحدة المعالجة المركزية.

هل يمكنني تشغيل Immich على Windows أو Raspberry Pi؟

المسار الرسمي المدعوم هو Docker على Linux - والذي يتضمن معظم أنظمة NAS وأجهزة الكمبيوتر الصغيرة. على نظام التشغيل Windows، المسار العملي هو Docker داخل WSL2 أو جهاز Linux ظاهري صغير. يمكن لـ Raspberry Pi تشغيله، لكن وظائف التعرف على الوجوه والفيديو ستكون بطيئة؛ يعد جهاز الكمبيوتر الصغير المستعمل الرخيص بمثابة منزل أكثر سعادة له.

يعتمد هذا الدليل على فيديو Anshu الفني المرتبط أعلاه. هل أنت عالق في إحدى الخطوات؟ اسأل في تعليقات الفيديو — حيث تأتي الإجابات بشكل أسرع 🙏