Skip to content

تثبيت بديل: Comfy Desktop والتثبيت اليدوي على macOS وLinux ​

الحزمة المحمولة لـ Windows في الدرس السابق ليست سوى أحد مسارات التثبيت الرسمية. إذا كنت تستخدم Mac أو Linux فهي لا تفيدك؛ وإذا أردت تجربة على غرار «برنامج عادي» — مثبّت رسومي، وتحديث تلقائي، وإدارة مثيلات متعددة — فما تحتاجه هو تطبيق سطح المكتب الرسمي Comfy Desktop، وهو ما يُشار إليه في الأوساط الصينية عادةً باسم ComfyUI نسخة سطح المكتب. النص الحرفي في README الرسمي: تطبيق سطح المكتب هو «أسهل وأفضل طريقة لاستخدام ComfyUI للمستخدمين الجدد».

يتناول هذا الدرس المسارين المحليين الآخرين: تنزيل Comfy Desktop وتثبيته وإعداده الأولي (ثلاث منصات: Windows / macOS / Linux)، والتثبيت اليدوي عبر git clone على macOS وLinux؛ وفي النهاية يوضح كيفية الترقية بعد التثبيت وإمكانية تغيير المسار. من شغّلوا الحزمة المحمولة بالفعل لا يحتاجون إلى إعادة التثبيت — فالخطوة 5 تشرح كيفية إدراجها ضمن إدارة نسخة سطح المكتب.

ماذا ستستطيع فعله بعد إتمام الدرس ​

  • تثبيت Comfy Desktop (ComfyUI نسخة سطح المكتب) على Windows أو macOS ‏(Apple Silicon) أو Linux، وإكمال معالج الإعداد الأولي
  • فهم كل خيار في الإعداد الأولي: سحابي أم محلي، ومربعات الاختيار الثلاثة، والتثبيت السريع، بالإضافة إلى مفتاح المرآة الصينية المخصص للمستخدمين داخل الصين
  • إتمام التثبيت اليدوي لـ ComfyUI باستخدام git clone + pip ‏(macOS وLinux)، وتثبيت إصدار PyTorch الصحيح حسب بطاقة الرسومات
  • ترقية كل مسار: التحديث التلقائي لنسخة سطح المكتب، وتبويب Update للمثيلات، وgit pull للتثبيت اليدوي
  • توضيح كيفية اختيار مسارات التثبيت الأربعة (الحزمة المحمولة / نسخة سطح المكتب / اليدوي / السحابي) وكيفية التبديل بينها بعد التثبيت

مأزقك الحالي ​

  • أنا مستخدم Mac أو Linux، والحزمة المحمولة لـ Windows في الدرس السابق لا تعنيني؛ وعند البحث عن «تثبيت ComfyUI على Mac» و«تثبيت ComfyUI على Linux» تأتي الدروس متضاربة، وكلها من سنوات عديدة مضت
  • أريد «برنامجًا عاديًا»: مثبّتًا بالنقر المزدوج، يتحدث تلقائيًا، دون الحاجة في كل مرة إلى البحث عن .bat في المجلد ثم فتح المتصفح يدويًا
  • في دروس التثبيت اليدوي كلمات كثيرة مثل conda وPyTorch وCUDA، ولا أعرف أيها ضروري؛ وفي المرة السابقة اتبعت الدرس فدخلت جميع التبعيات إلى Python النظام وتعارضت مع برامج أخرى

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • تثبيت ComfyUI على Mac ‏(Apple Silicon) أو Linux
  • نسخة سطح مكتب من ComfyUI بمثبّت رسومي وتحديث تلقائي وإدارة لقطات (Snapshots)
  • تحكم كامل في بيئة Python ومعاملات التشغيل؛ أو التشغيل على خادم Linux بلا واجهة رسومية (لا تدعم نسخة سطح المكتب الخوادم بلا واجهة صراحةً)
  • الاحتفاظ بعدة إصدارات من ComfyUI في الوقت نفسه والتبديل بينها حسب المشروع

ولا تريد:

  • أن تتوه في تسلسل «تثبيت Python ← إعداد CUDA ← تثبيت PyTorch»
  • أن تثبّت التبعيات في Python النظام فتتعارض مع برامج أخرى
  • أن تعيد في كل ترقية تنزيل الحزمة المضغوطة يدويًا وفك ضغطها من جديد

🎒 التحضير قبل البدء ​

  • قراءة الدرس السابق ComfyUI ما هو: معرفة ما هي العُقد والوصلات وسير العمل، حتى لا ترتبك عند فتح الواجهة بعد التثبيت
  • التأكد من إصدار النظام: تشترط نسخة سطح المكتب Windows 10 فأحدث / macOS 13 ‏(Ventura) فأحدث / ويُوصى على Linux بـ Ubuntu 22.04 فأحدث
  • التأكد من العتاد: يتطلب Mac معالج Apple Silicon ‏(M1 فما بعده)؛ الذاكرة من 8 GB كحد أدنى والتوصية الرسمية 16 GB؛ واترك للقرص مساحة لا تقل عن 4.85 GB لكل مثيل
  • إذا سلكت مسار التثبيت اليدوي: ثبّت Git، واستخدم لـ Python الإصدار الموصى به رسميًا 3.13
  • كوب من الماء ☕

⚠️ تنبيه للتنزيل داخل الصين

ComfyUI يُستضاف معظم الكود المصدري والنماذج على GitHub / Hugging Face، وتذكر الوثائق الرسمية أن مستخدمي البر الرئيسي للصين قد يحتاجون إلى إعداد وكيل (Proxy) للوصول المستقر إلى مستودعات GitHub. تتضمن نسخة سطح المكتب مفتاح مرآة صينية مدمجًا (الخطوة 2)، وفي التثبيت اليدوي يمكن تبديل pip إلى مرآة Tsinghua (الخطوة 4).

متطلبات النظام: مرجع سريع لنسخة سطح المكتب والتثبيت اليدوي ​

العنصرComfy Desktop ‏(نسخة سطح المكتب)التثبيت اليدوي (git clone)
WindowsWindows 10 فأحدث، x64 / ARM64مدعوم كذلك (وبالنسبة لمستخدمي Windows لا يزال بإمكانهم سلوك مسار الحزمة المحمولة من الدرس السابق)
macOS13 (Ventura) وما بعده، Apple Silicon (M1 وما بعده)Apple Silicon (M1–M4)، والصياغة الرسمية هي أن «إصدار macOS أحدث» يكفي
Linuxيُنصح بـ Ubuntu 22.04 وما بعده، x64 (.deb / AppImage)أي توزيعة تستطيع تشغيل Python 3.13
الذاكرة / القرص8 GB كحد أدنى، والتوصية الرسمية 16 GB؛ وكل تثبيت مستقل يحتاج 4.85 GB على الأقللم تُذكر أرقام منفصلة رسميًا (صفحة متطلبات النظام تذكر الأنظمة الأساسية وإصدار Python وأنواع كروت الرسوميات المدعومة فقط، دون أرقام للذاكرة/القرص)
كرت الرسومياتيُنصح بكرت منفصل (NVIDIA / AMD) لكنه غير ضروري؛ غير أن تطبيق سطح المكتب لنظام Windows يدعم كروت NVIDIA CUDA فقط (مستخدمو Windows ذوو كروت AMD/Intel عليهم استخدام الحزمة المحمولة أو التثبيت اليدوي)NVIDIA / AMD (ROCm) / Intel Arc / Apple Silicon كلها تصلح، وبدون كرت منفصل يمكن استخدام --cpu
صلاحيات المسؤولالتثبيت على Windows لا يحتاجها؛ التثبيت على macOS على مستوى النظام يحتاجها في المرة الأولى؛ على Linux يحتاج تثبيت .deb إلى sudo بينما AppImage لا يحتاجحسب المتطلبات المعتادة للنظام

إصدار Python لا يهم إلا في التثبيت اليدوي: التوصية الرسمية 3.13؛ 3.14 يعمل لكن بعض العقد المخصصة قد تواجه مشاكل؛ 3.12 هو الملاذ عند مواجهة مشاكل الاعتماديات. أما إصدار سطح المكتب فلا يلزمك الاهتمام بـ Python — فهو يتولى إدارته.

الفكرة الأساسية ​

**Comfy Desktop ليس إصدارًا آخر من ComfyUI، بل هو «مدير نسخ (Instances)». ** التعريف الرسمي: تطبيق سطح مكتب يتيح لك تثبيت وإدارة وتشغيل نسخ ComfyUI متعددة من مشغّل واحد. لا تحتاج إلى تثبيت ComfyUI بشكل منفصل — بيئة Python والاعتماديات كلها تُدار بواسطته؛ ولكل نسخة إصدار ComfyUI وعقد مخصصة وإعدادات مستقلة، ويمكن أن تتعايش معًا.

الأسئلة الشائعة الرسمية واضحة تمامًا: إصدار سطح المكتب لا يحل محل الحزمة المحمولة / التثبيت اليدوي، بل هو مجرد خيار «موصى به لمعظم المستخدمين» — لأنه يوفر العناء، ويأتي مع تحديث بنقرة واحدة وإدارة اللقطات (Snapshots).

انتبه إلى فرق بين القديم والجديد: «إصدار سطح المكتب» المذكور في الدروس القديمة على الإنترنت قد يكون الإصدار القديم Legacy Desktop (تطبيق بنسخة واحدة). أما Comfy Desktop الحالي فهو مدير نسخ متعددة أُعيدت كتابته بالكامل، وتوفر الجهة الرسمية قناة للانتقال من الإصدار القديم.

**التثبيت اليدوي هو «بناء البيئة بنفسك». ** تلخص الجهة الرسمية الخطوات في أربع: إنشاء بيئة افتراضية (لتجنب تلويث Python الخاص بالنظام) → استنساخ مستودع الكود → تثبيت PyTorch بإصدار GPU والاعتماديات → python main.py للتشغيل. إصدار سطح المكتب والحزمة المحمولة يخفيان الخطوات الثلاث الأولى؛ أما التثبيت اليدوي فهو تنفيذها بيديك، مقابل التحكم الكامل في كل خطوة.

المسارات الأربعة في جدول واحد:

المسارلمن يصلحبعبارة واحدة
الحزمة المحمولة لنظام Windows (الدرس السابق)مستخدمو Windows الذين يريدون أسرع تشغيلفك الضغط واستخدم؛ مع تذكير من README الرسمي في الوقت نفسه: يُنصح المستخدمون العاديون بتطبيق سطح المكتب أكثر
إصدار سطح المكتب Comfy Desktop (الخطوة 1–3 من هذا الدرس)لمن يريد مثبّتًا رسوميًا وتحديثًا تلقائيًا وإدارة نسخ متعددةالجهة الرسمية تصفه بأنه «الأبسط والأفضل» للمستخدمين الجدد
التثبيت اليدوي (الخطوة 4 من هذا الدرس)لمن يريد تحكمًا كاملًا في البيئة؛ خوادم Linux بدون واجهة رسوميةالخطوات الرسمية الأربع تنفَّذ بيديك
السحابة Comfy Cloudعندما لا يكون كرت GPU المحلي قويًا بما يكفيتشغيل في السحابة دون تثبيت أي شيء على الجهاز المحلي (لا يُفصَّل في هذا الدرس)

💡 أيًا كان المسار، فما يُثبَّت هو نفس ComfyUI

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

اتبعني خطوة بخطوة ​

الخطوة 1: تنزيل وتثبيت Comfy Desktop (إصدار سطح المكتب لـ ComfyUI) ​

لماذا: إصدار سطح المكتب هو المسار الذي توصي به الجهة الرسمية للمستخدمين الجدد، حيث يتولى مثبّت واحد إدارة ComfyUI وبيئة Python والاعتماديات كلها.

اتبع حسب منصتك:

الطريقة A: Windows (مثبّت .exe) ​

  1. افتح صفحة التنزيل الرسمية https://comfy.org/download، وستتعرف الصفحة على منصتك تلقائيًا وتنزّل مثبّت .exe
  2. انقر نقرًا مزدوجًا للتشغيل (مثبّت NSIS) وأكمل باتباع التعليمات
  3. شغّل Comfy Desktop من قائمة ابدأ أو اختصار سطح المكتب

ينبغي أن ترى: نافذة Comfy Desktop تُفتح وتدخل الإعداد الأولي بملء الشاشة (الخطوة 2). الأسئلة الشائعة الرسمية تؤكد: التثبيت على Windows لا يحتاج صلاحيات المسؤول.

الطريقة B: macOS (ملف .dmg، Apple Silicon) ​

  1. نزّل ملف .dmg من https://comfy.org/download
  2. افتح .dmg واسحب Comfy Desktop إلى مجلد Applications
  3. شغّله من Launchpad أو Spotlight

ينبغي أن ترى: عند أول تشغيل على macOS قد تظهر تحذير أمني — انتقل إلى الإعدادات ← الخصوصية والأمان وانقر افتح على أي حال (Open Anyway) للسماح به. هذا إجراء طبيعي موثّق في الوثائق الرسمية.

الطريقة C: Linux (حزمة .deb أو AppImage) ​

لا يستخدم Linux صفحة comfy.org/download، بل رابط التنزيل العام الموجود في صفحة المستودع الرسمية https://dl.todesktop.com/241130tqe9q3y (يتعرف على منصتك تلقائيًا ويوفر حزمتين: .deb و AppImage):

bash
# Debian / Ubuntu:在 .deb 文件所在目录执行
sudo apt install ./*.deb

# 或者 AppImage(不需要管理员权限)
chmod +x ./*.AppImage
./*.AppImage

ينبغي أن ترى: نافذة Comfy Desktop تُفتح وتدخل الإعداد الأولي بملء الشاشة.

  • أصبح Comfy Desktop قادرًا على العمل على نظامي

⚠️ إذا لم يعمل على Linux فتحقق من أمرين أولًا

تذكر الوثائق الرسمية سببين شائعين: ① AppImage يحتاج FUSE 2 — ثبّته: sudo apt install libfuse2؛ ② AppArmor في Ubuntu 24.04+ يقيّد صندوق Electron المعزول — عندها يمكن إضافة --no-sandbox وإعادة المحاولة، لكن الجهة الرسمية تحذر من أن هذا الخيار يعطّل صندوق Electron المعزول لكل عملية، فاستخدمه فقط عند فشل تشغيل الصندوق المعزول. لمزيد من استكشاف الأخطاء راجع ماذا أفعل إذا فشل التثبيت.

الخطوة 2: إكمال الإعداد الأولي: سحابي أم محلي، ومرآة صينية ​

لماذا: عند أول فتح لـ Comfy Desktop ستدخل إعدادًا بملء الشاشة، ولن يتجاوزه حتى تجيب على كل الأسئلة؛ وإذا أغلقت التطبيق في المنتصف، ستجد نفس الواجهة عند الفتح التالي.

لننظر إلى عناصر الإعداد واحدًا واحدًا:

عنصر الإعدادكيفية التعامل معهالشرح
Cloud أم Localللتشغيل المحلي اختر Localيُثبَّت Local على جهازك ComfyUI: الإصدار والعُقد المخصصة ومعاملات التشغيل كلها تحت إدارتك، ويمكنه العمل دون اتصال؛ أما Cloud فيعمل على وحدات GPU من Comfy Cloud ولا يُثبَّت أي شيء على جهازك
اتفاقية ترخيص المستخدم النهائي (EULA) وشروط الخدمةيجب تحديدهابدون التحديد لا يمكن المتابعة
بيانات الاستخدام المجهولةاختيارية، ومحددة افتراضيًاتصريح رسمي: لا يتم جمع محتوى سير العمل أو التعليمات (prompts) أو الوسائط المولَّدة أو المعلومات الشخصية؛ ويمكن التغيير لاحقًا من الإعدادات
ميزات الإصدار التجريبياختيارية، ومحددة افتراضيًامتاحة فقط عند تفعيل مشاركة البيانات
Express Install (تثبيت سريع)اختيارية، وغير محددة افتراضيًاعند تحديدها يتم تخطي معالج التثبيت وتثبيت نسخة Standalone مباشرة بالإعدادات الموصى بها؛ أما بدون التحديد فسترى أولًا ComfyUI الإصدار وموقع التثبيت وخيارات التشغيل قبل الكتابة على القرص. أسفل مربع التحديد سيظهر العتاد المكتشف، وإذا كان الكشف خاطئًا يمكنك الإلغاء

تفصيلان: عند عدم اختيار بطاقة يكون زر Continue باللون الرمادي، فالجهة الرسمية تريدك أن تفكر جيدًا قبل الاختيار؛ وعند اكتشاف أن وحدة GPU في جهازك غير قوية بما يكفي، تحمل بطاقة Cloud شارة "Recommended for your hardware". وإذا كنت قد ثبّت الإصدار القديم Legacy Desktop فسيظهر أيضًا مربع تحديد إضافي Migrate existing instance (محدد افتراضيًا)، ينقل سير العمل والنماذج والإعدادات معًا.

💡 مستخدمو الصين: تفعيل المرايا الصينية

عندما تكون لغة واجهة التطبيق هي الصينية، ستسأل الإعدادات الأولى بعد Continue سؤالًا إضافيًا Enable Chinese Mirrors? اختر Enable Mirrors، وسيتم استنساخ مستودعات Git من gitcode.com وستمر حزم PyPI عبر مرايا Alibaba Cloud وTencent (بدلًا من github.com وpypi.org) — والتوضيح الرسمي يقول إن هذا أسرع في البر الرئيسي. واختيار Not now للإبقاء على الافتراضي مقبول أيضًا، ويمكن التغيير في أي وقت لاحقًا من الإعدادات (اسم خيار الإعداد هو Use Chinese Mirrors (Git & PyPI)).

بعد النقر على Continue:

يجب أن ترى: رسالة قصيرة Preparing your install…، ثم يدخل مسار Local إلى تقدم التثبيت (وإذا لم يتم تحديد Express Install فسيمر أولًا عبر معالج التثبيت)، وتظهر النسخة المكتملة على لوحة التحكم (Dashboard).

  • ظهرت أول نسخة (instance) لي على لوحة التحكم

الخطوة 3: تشغيل النسخة والتعرّف على العمليات اليومية في Comfy Desktop ​

لماذا: العمل اليومي في النسخة المكتبية هو «إدارة النسخ من لوحة التحكم» — التشغيل والإيقاف والترقية كلها تتم من بطاقة النسخة.

انقر على البطاقة لتشغيل النسخة المثبتة، ويعمل ComfyUI في نافذة مستقلة (الأسئلة الشائعة الرسمية: يمكن تشغيل عدة نسخ في وقت واحد، ولكل منها بيئة Python مستقلة). ثلاث عمليات شائعة:

العمليةكيفية التنفيذ
إيقاف النسخة (مع الإبقاء على التطبيق)قائمة ⋮ على بطاقة النسخة → Stop → تأكيد. ما يتم إيقافه هو الواجهة الخلفية لـ ComfyUI Python، ويبقى تطبيق سطح المكتب مفتوحًا ويمكن إعادة التشغيل في أي وقت
إنهاء التطبيق بالكاملقائمة ☰ في الزاوية العلوية اليسرى → Quit Desktop (أو استخدم طريقة الخروج المعتادة في النظام)
إضافة نسخة جديدةعلى لوحة التحكم New Instance: Standalone (تثبيت جديد كليًا مع Python مدمج)، وAdd Existing Instance (لإدراج نسخة git clone أو الحزمة المحمولة من الدرس السابق تحت الإدارة)، وCloud (الاتصال بالسحابة)

احفظ أولًا قاعدة أدلة النماذج: تشترك النسخ المختلفة في النسخة المكتبية افتراضيًا في مكتبة نماذج مشتركة، ويتم إعداد المجلد المشترك في Desktop Settings → Storage. للاطلاع على شرح الأدلة التفصيلي ومشاركة النماذج بين تثبيتات متعددة راجع أين توضع النماذج.

يجب أن ترى: بعد النقر على البطاقة تدخل النسخة حالة التشغيل، وتفتح واجهة ComfyUI في نافذة مستقلة؛ وتحتوي قائمة ⋮ على بطاقة النسخة على Stop، وبعد النقر عليها يبقى التطبيق وتتوقف النسخة.

  • أستطيع تشغيل نسخة وإيقافها، وأعرف أين يوجد New Instance

الخطوة 4: التثبيت اليدوي لـ ComfyUI: باستخدام git clone وpip (على macOS وLinux) ​

لماذا: إذا أردت تحكمًا كاملًا في البيئة، أو التشغيل على خادم Linux بدون واجهة رسومية (توضح الأسئلة الشائعة للنسخة المكتبية صراحةً عدم دعم وضع headless / الخوادم)، فاتبع الخطوات الرسمية الأربع: إنشاء بيئة افتراضية → استنساخ المستودع → تثبيت التبعيات → التشغيل.

يدعم المسؤول أيضًا التثبيت اليدوي على Windows، لكن بشرط مسبق: تثبيت Microsoft Visual C++ Redistributable أولًا. ومع ذلك، يتوفر لمستخدمي Windows الحزمة المحمولة والنسخة المكتبية، فلا حاجة عمومًا لهذا المسار.

💡 هناك أيضًا أداة سطر أوامر رسمية comfy-cli

توفر الوثائق الرسمية في الوقت نفسه comfy-cli: pip install comfy-cli ثم comfy install — لتثبيت ComfyUI عبر سطر الأوامر وإدارة التبعيات نيابةً عنك. يعتمد هذا الدرس على سير عمل conda + git الذي توصي به الوثائق الرسمية أساسًا، ونترك comfy-cli لك لاستكشافه بنفسك إذا كنت من محبي سطر الأوامر.

الطريقة A: التثبيت اليدوي على macOS (Apple Silicon) ​

المتطلبات المسبقة: تثبيت Git وMiniconda (تستخدمه الجهة الرسمية لإنشاء بيئة Python مستقلة).

bash
# 1. 创建并进入虚拟环境(避免污染系统 Python)
conda create -n comfyenv
conda activate comfyenv

# 2. 克隆 ComfyUI 官方仓库
git clone https://github.com/Comfy-Org/ComfyUI.git

# 3. 装 PyTorch nightly(官方指定 Mac 走 nightly 版)
conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly

# 4. 装 ComfyUI 依赖并启动
cd ComfyUI
pip install -r requirements.txt
python main.py

يجب أن ترى: في النهاية يُخرج الطرفية To see the GUI go to: http://127.0.0.1:8188، وفتح هذا العنوان في المتصفح يعرض واجهة العُقد. وللتأكد من أن تسريع GPU في Apple Silicon (MPS) يعمل، شغّل سطر التحقق الرسمي التالي:

bash
python -c "import torch; print(torch.backends.mps.is_available())"

إخراج True يعني أن تسريع Metal متاح. التوضيح الرسمي: على أجهزة Mac يستخدم ComfyUI الواجهة الخلفية MPS (Metal Performance Shaders) من PyTorch، وليس MLX من Apple.

الطريقة B: التثبيت اليدوي على Linux (اختيار PyTorch حسب بطاقة الرسوميات) ​

الخطوات 1 و2 و4 متطابقة تمامًا مع macOS (إنشاء البيئة بـ conda، واستنساخ المستودع، وتثبيت التبعيات والتشغيل)، فقط الخطوة 3 يجب استبدالها بإصدار PyTorch المطابق لبطاقة الرسوميات لديك:

bash
# NVIDIA(CUDA 13.0 稳定版)
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# AMD(ROCm 7.2 稳定版)
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

# Intel Arc(XPU 后端;官方提醒:不要装 CUDA 版 wheel)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

توفر الجهة الرسمية أيضًا إصدار nightly من PyTorch (قد يحمل تحسينات في الأداء، لكن الجهة الرسمية نفسها تصفه بأنه «أعلى خطورة»)، ويكفي المبتدئَ الإصدار المستقر أعلاه. ثم:

bash
cd ComfyUI
pip install -r requirements.txt
python main.py

يجب أن ترى: ينتهي الأمر بالمثل بـ To see the GUI go to: http://127.0.0.1:8188، وفتحه في المتصفح يعرض واجهة العُقد. ولإيقاف ComfyUI الذي شُغّل يدويًا اضغط Ctrl+C أو أغلق نافذة الطرفية مباشرة (نص الأسئلة الشائعة الرسمية).

💡 مستخدمو الصين: تبديل pip إلى مرآة Tsinghua

الحل الوارد في الوثائق الرسمية: pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple. وعندما يكون git clone بطيئًا أو يفشل، تذكر الوثائق الرسمية أن مستخدمي البر الرئيسي قد يحتاجون إلى إعداد وكيل (proxy) للوصول المستقر إلى مستودعات GitHub.

  • تظهر في الطرفية To see the GUI go to: http://127.0.0.1:8188، ويفتح المتصفح واجهة العُقد

الخطوة 5: الترقية وتغيير المسار ​

لماذا: يتطور ComfyUI بسرعة، فالتثبيت عملية لمرة واحدة، أما الترقية فهي على المدى الطويل.

مقارنة طرق الترقية لكل مسار (كلها من الوثائق الرسمية):

المسارطريقة الترقية
تطبيق Comfy Desktopيتحقق من التحديثات تلقائيًا، ولا يمكن إيقافه (يُجرى فحص واحد بعد فترة قصيرة من التشغيل، ثم كل 10 دقيقة). عندما يظهر زر Desktop Update Ready في شريط العنوان، انقر عليه لإعادة التشغيل والتثبيت؛ يمكنك أيضًا التحقق يدويًا من التحديثات عبر Check for updates في Desktop Settings → Updates
نسخة ComfyUI داخل الإصدار المكتبيشيء منفصل عن تحديث التطبيق: استخدم علامة تبويب Update الخاصة بالنسخة واختر قناة Stable أو Latest on GitHub
الإصدار المكتبي المثبّت عبر .deb على Linuxلا تنطبق عليه التحديثات داخل التطبيق — أعد التنزيل عبر رابط التنزيل العام، ثم نفّذ sudo apt install ./*.deb
التثبيت اليدويبعد cd <安装路径>/ComfyUI ثم git pull، نفّذ pip install -r requirements.txt. ⚠️ تأكد أولًا من تنشيط البيئة الافتراضية، وإلا ستُثبَّت التبعيات في Python الخاصة بالنظام

تغيير المسار: لا يحتاج مستخدمو الحزمة المحمولة إلى البدء من الصفر — يدعم الإصدار المكتبي رسميًا عبر New Instance → Add Existing Instance إدراج حزمة محمولة موجودة أو نسخة git clone ضمن الإدارة؛ ويمكن أيضًا مشاركة النماذج بين عمليات تثبيت متعددة عبر extra_model_paths.yaml، والطريقة موضحة في أين تضع النماذج.

يجب أن ترى (بأخذ التحديث التلقائي للإصدار المكتبي كمثال): يعرض شريط العنوان أولًا Downloading update…، ثم يتحول عند الجاهزية إلى Desktop Update Ready، وانقر عليه ليُعاد التشغيل ويكتمل التثبيت — وهذا بالضبط هو مسار التحديث التلقائي الافتراضي كما تصفه الوثائق الرسمية.

  • أعرف الآن كيف أرقّي مساري

نقاط التحقق ✅ ​

  • Comfy Desktop يعمل، وقد ظهرت نسختي الأولى على لوحة التحكم
  • فهمت كل خيار في الإعداد الأولي؛ إما أن المرآة الصينية مفعّلة أو أعرف أين أغيّرها
  • (المسار اليدوي) ظهرت To see the GUI go to: http://127.0.0.1:8188 في الطرفية، والمتصفح يفتح واجهة العُقد
  • أعرف كيف أرقّي مساري: تحديث تلقائي للإصدار المكتبي، علامة تبويب Update للنسخة، أو git pull يدويًا
  • أستطيع تحديد المسار المناسب لي من بين المسارات الأربعة، وكيف أبدّل بعد التثبيت

تنبيهات للمزالق ​

❌ macOS: عند أول تشغيل لـ Comfy Desktop تظهر تحذيرات أمنية ولا يفتح التطبيق ​

ظهور تحذير أمني عند التشغيل الأول أمر طبيعي تنص عليه الوثائق الرسمية، ولا يعني أن التثبيت فشل. الحل: إعدادات النظام → الخصوصية والأمان → افتح مع ذلك (Open Anyway). إذا لم يعمل التطبيق رغم ذلك، تقترح الأسئلة الشائعة الرسمية زيارة صفحة التنزيل للتأكد من حصولك على أحدث إصدار.

❌ Linux: بعد تثبيت AppImage أو .deb لا يفتح التطبيق ​

سببان مذكوران رسميًا: غياب FUSE 2 (يحتاجه AppImage، sudo apt install libfuse2)؛ أو أن التوزيعة تعترض صندوق حماية Electron (تقييد AppArmor في Ubuntu 24.04+ لمساحات أسماء المستخدمين غير المميزين)، وفي هذه الحالة أضف --no-sandbox وأعد المحاولة — مع الانتباه إلى التحذير الرسمي: هذا الوسيط يعطّل صندوق حماية Electron لكل عملية، فلا تستخدمه إلا عند فشل تشغيل صندوق الحماية.

❌ التثبيت اليدوي: تنفيذ pip install دون تنشيط البيئة الافتراضية ​

الأعراض: تُثبَّت التبعيات في Python الخاصة بالنظام وتتعارض مع برامج أخرى؛ وعند الترقية التالية سيُثبَّت pip install -r requirements.txt في المكان الخطأ مرة أخرى. خلاصة التحذير الرسمي: قبل تثبيت التبعيات يجب التأكد من أن بيئة Python الحالية هي بيئة ComfyUI الافتراضية. الترتيب الصحيح:

bash
conda activate comfyenv   # 先激活
pip install -r requirements.txt   # 再装依赖

❌ التثبيت اليدوي: عند التشغيل تظهر رسالة "Torch not compiled with CUDA enabled" ​

من عناصر استكشاف الأخطاء في README الرسمي: أزل torch تمامًا أولًا، ثم أعد تثبيته بالأمر الخاص ببطاقة الرسومات لديك.

bash
pip uninstall torch
# NVIDIA 示例:重装 cu130 稳定版
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

نصائح متقدمة (اختيارية) ​

🔧 الإصدار المكتبي ينشئ لقطات (Snapshots) تلقائيًا: توضح الوثائق الرسمية أن اللقطات تُنشأ تلقائيًا عند الأحداث المهمة — عند كل تشغيل / إعادة تشغيل، قبل التحديث وبعده، وبعد الاستعادة؛ ومحتواها هو إصدار ComfyUI وإصدارات العُقد المخصصة وجميع حزم pip (دون النماذج وملفات الإدخال والإخراج). من علامة تبويب Snapshots الخاصة بالنسخة يمكنك التصفح والاستعادة والتصدير والمشاركة. عند فشل التحديث، أنشئ لقطة يدويًا أولًا ثم أعد المحاولة — هذا ما توصي به الوثائق الرسمية.

🔧 Windows: الإصدار المكتبي يخرج تلقائيًا بشكل متكرر بعد التحديث: أكّدت الجهة الرسمية وجود خطأ برمجي في 1.0.46 والإصدارات الأقدم — عندما لا يكتمل تنزيل التحديث، يومض التطبيق بواجهة التحديث ثم يغلق من تلقاء نفسه، وهكذا عند كل تشغيل دون أن يلحق بالإصلاح الذاتي. الحل: نزّل أحدث مثبّت Windows يدويًا (https://dl.todesktop.com/241130tqe9q3y/windows أو من صفحة التنزيل) وثبّته مباشرة دون الحاجة إلى إزالة الإصدار القديم أولًا؛ ستبقى النسخ والنماذج والإعدادات محفوظة. أُصلح الخطأ اعتبارًا من 1.0.47.

🔧 لإزالة الإصدار المكتبي نهائيًا: إزالة التطبيق تحذف المشغّل فقط، أما النسخ والنماذج المشتركة والإعدادات والسجلات فتبقى على القرص. تسرد الوثائق الرسمية مجلدات البقايا لكل منصة: على Windows في %LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Installs و%APPDATA%\Comfy Desktop وغيرها؛ على macOS في ~/ComfyUI-Installs و~/Library/Application Support/Comfy Desktop وغيرها؛ على Linux في ~/.config/comfyui-desktop-2 وغيرها. للتنظيف الكامل، احذفها واحدًا واحدًا وفقًا لصفحة منصتك في الوثائق الرسمية.

🔧 لا وجود لشيء اسمه «صورة ComfyUI Docker الرسمية»: الأسئلة الشائعة الرسمية تنص صراحةً على عدم توفير صورة Docker رسمية؛ الصور المجتمعية على Docker Hub ليست رسمية ولا مدعومة رسميًا، واستخدامها على مسؤوليتك. لنشر الخوادم اتبع مسار التثبيت اليدوي.

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

ComfyUI كيفية التنزيل والتثبيت؟ من أين يتم تنزيل نسخة سطح المكتب؟ ​

لتنزيل نسخة سطح المكتب (Comfy Desktop)، انتقل إلى صفحة التنزيل الرسمية https://comfy.org/download، وسيكتشف الموقع نظامك تلقائيًا: على Windows ستجد المثبّت بصيغة .exe، وعلى macOS بصيغة .dmg، أما Linux فلا يمر عبر هذه الصفحة، بل استخدم رابط التنزيل العام المتوفر في صفحة المستودع الرسمية https://dl.todesktop.com/241130tqe9q3y (يوفر حزمتين: .deb و AppImage). بعد التنزيل، انقر نقرًا مزدوجًا على المثبّت أو اسحب التطبيق إلى مجلد Applications، والخطوات التفصيلية موجودة في «الخطوة 1» في هذه الصفحة.

ComfyUI كيف يتم التنزيل والتثبيت؟ ما هي خطوات التثبيت اليدوي؟ ​

يلخّص المسؤولون التثبيت اليدوي في أربع خطوات: إنشاء بيئة افتراضية (لتجنّب تلويث بايثون النظام) → استنساخ مستودع الكود → تثبيت PyTorch لإصدار GPU والتبعيات → python main.py للتشغيل. الأوامر الكاملة لـ macOS و Linux موجودة في «الخطوة 4» من هذه الصفحة، وعلامة نجاح التشغيل هي أن يُخرج الطرفية To see the GUI go to: http://127.0.0.1:8188.

ComfyUI ما هي المتطلبات؟ ​

يتطلب إصدار سطح المكتب Windows 10 أو أحدث / macOS 13 (Ventura) أو أحدث (و يجب أن يكون Apple Silicon، أي M1 وما بعده) / و يُنصح بـ Linux على Ubuntu 22.04 أو أحدث؛ الذاكرة تبدأ من 8 GB مع توصية رسمية بـ 16 GB، والقرص يجب تخصيص ما لا يقل عن 4.85 GB لكل مثيل. أما بطاقة الرسوميات فبطاقة منفصلة موصى بها لكنها ليست ضرورية، غير أن تطبيق سطح المكتب لنظام Windows يدعم فقط بطاقات NVIDIA CUDA؛ أما التثبيت اليدوي فيقبل NVIDIA / AMD / Intel Arc / Apple Silicon، وبدون بطاقة منفصلة يمكن استخدام --cpu.

ComfyUI هل يمكن تثبيته على Mac M4؟ ​

نعم. يتطلب إصدار سطح المكتب Apple Silicon بنظام macOS 13 (Ventura) أو أحدث (أي M1 وما بعده)، و M4 ضمن نطاق الدعم؛ ومسار التثبيت اليدوي يدعم أيضًا Apple Silicon (M1–M4). على الـ Mac يعمل ComfyUI باستخدام الواجهة الخلفية MPS (Metal Performance Shaders) في PyTorch، وفي التثبيت اليدوي يحدد المسؤولون تثبيت إصدار nightly من PyTorch، وبعد التثبيت يمكن التحقق باستخدام python -c "import torch; print(torch.backends.mps.is_available())"، وإذا كان الناتج True فهذا يعني أن تسريع Metal متاح.

كيف تجربة استخدام ComfyUI؟ وما الفرق عن الحزمة المحمولة؟ ​

Comfy Desktop ليس إصدارًا آخر من ComfyUI، بل هو «مدير مثيلات»: لا تحتاج إلى تثبيت ComfyUI بشكل منفصل، فبيئة بايثون والتبعيات تُدار كلها بواسطته، ويأتي أيضًا مع مثبّت رسومي وتحديث تلقائي وإدارة لقطات (snapshots)، ويصفه المسؤولون بأنه الطريقة «الأسهل والأفضل» للمستخدمين الجدد لاستخدام ComfyUI. وبغض النظر عن المسار المختار، فإن ما يُثبَّت هو نفس ComfyUI، وواجهة العُقد وسير العمل وقواعد مجلد النماذج متطابقة تمامًا.

خلاصة هذا الدرس ​

✅ ComfyUI الإصدار المكتبي (Comfy Desktop) تعرفت على تثبيته واستخدامه: نزّل المثبّت ← إعداد أولي بملء الشاشة (Cloud / Local، ثلاثة مربعات اختيار، مرآة اللغة الصينية) ← شغّل النسخة من لوحة التحكم.

✅ لمستخدمي macOS (Apple Silicon) وLinux أمامك طريقان: الإصدار المكتبي (.dmg اسحب إلى Applications / .deb / AppImage)، أو التثبيت اليدوي عبر git clone + pip — الخطوات الرسمية الأربع: إنشاء بيئة conda، واستنساخ المستودع، وتثبيت PyTorch حسب بطاقة الرسومات، ثم python main.py.

✅ ميّزت مسارات الترقية: الإصدار المكتبي يتحقق من التحديثات تلقائيًا (لا يمكن إيقافه)، والنسخة عبر علامة تبويب Update، والتثبيت اليدوي عبر git pull؛ ويمكن لاحقًا إدراج الحزمة المحمولة ضمن إدارة الإصدار المكتبي عبر Add Existing Instance دون البدء من الصفر.

الأمر / العنوانالوظيفة
https://comfy.org/downloadصفحة التنزيل الرسمية لـ Comfy Desktop (تتعرف على المنصة تلقائيًا)
https://dl.todesktop.com/241130tqe9q3yرابط التنزيل العام لـ Linux (.deb / AppImage)
git clone https://github.com/Comfy-Org/ComfyUI.gitالتثبيت اليدوي: استنساخ شيفرة ComfyUI المصدرية
conda create -n comfyenv / conda activate comfyenvإنشاء / تنشيط البيئة الافتراضية
pip install -r requirements.txtتثبيت تبعيات ComfyUI
python main.pyتشغيل ComfyUI (المسار اليدوي)
git pullترقية ComfyUI من الكود المصدري (المسار اليدوي)

إعلان الدرس التالي ​

إتمام التثبيت لا يعني أن كل شيء سيسير بسلاسة: ماذا تفعل إذا فشل التثبيت: استكشاف أخطاء التثبيت والتشغيل وإصلاحها.

ستتعلم:

  • ComfyUI ترتيب الخطوات لاستكشاف فشل بدء التشغيل ونافذة سوداء تظهر وتختفي بسرعة
  • 127.0.0.1:8188 ماذا تفعل إذا لم يفتح أو ظهرت شاشة سوداء في الواجهة
  • كيفية التعامل مع أخطاء بدء التشغيل المتعلقة بتعريفات بطاقة الرسومات
  • أين تجد ملفات السجلات عندما يتعذر تشغيل نسخة سطح المكتب

أما الطلاب الذين تمكنوا من تشغيله بنجاح بالفعل، فيمكنهم التوجه مباشرة إلى أين توضع النماذج لوضع أول نموذج والحصول على الصور مبكرًا؛ وللاطلاع على العملية الكاملة لتوليد الصور راجع توليد الصورة الأولى.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.