ollama pull أم run؟ أين تُحفظ النماذج؟
تعرّف إلى الفرق بين ollama pull وollama run، ورسالة embedding models require input text، ومكان الملفات وسبب امتلاء قرص VPS الجذر وكيفية نقلها.
ollama pull مقابل ollama run
يُنزّل ollama pull نموذجاً ثم يتوقف. بالنسبة إلى نموذج محادثة محلي، يُنزّل ollama run النموذج فقط إذا كان مفقوداً، ثم يحمّله في الذاكرة ويفتح محادثة تفاعلية. عملية التنزيل متطابقة، وتُحفظ الملفات في المكان نفسه. وحده run يتابع التنفيذ بعد ذلك. نماذج التضمين هي الاستثناء في ما يتعلق بالمحادثة: توضّح الوثائق الرسمية أن ollama run embeddinggemma "Hello world" يطبع التضمين في صورة مصفوفة JSON بدلاً من إجابة. من دون نص إدخال، يرفض ollama run نموذج تضمين مع embedding models require input text.
هذا الاختلاف وحده يحدد الأمر الذي ينتمي إلى برنامج نصي والأمر الذي ينتمي إلى لوحة المفاتيح.
ollama pull gemma4
ollama run gemma4
ollama run gemma4 "Reply with one word: ready"يجلب السطر الأول النموذج ثم يخرج، لذلك فهو آمن في عمليات التجهيز وفي وحدة systemd. يفتح السطر الثاني جلسة محادثة؛ اكتب /bye أو اضغط Ctrl+D للخروج منها. يرسل الشكل الثالث مطالبة واحدة، ويطبع الإجابة ثم يخرج، وهذا هو الشكل المناسب للبرنامج النصي عندما يحتاج إلى إجابة بدلاً من جلسة. يترك هذا الشكل الثالث طول الإجابة بالكامل للنموذج، لذلك قد يعود سؤال من سطر واحد في صورة 3 فقرات، وتحديد حد للإجابة باستخدام num_predict هو ما يُبقي run البرمجي ضمن حجم يستطيع المستدعي استخدامه فعلياً. تتغير أسماء النماذج بسرعة، لذلك تعامل مع gemma4 هنا كعنصر نائب: فهو المثال الذي تستخدمه وثائق Ollama الرسمية اعتباراً من أكتوبر 2026؛ واستبدله بنموذج محادثة محلي آخر في سير العمل نفسه. تختلف الوسوم التي تنتهي بـ:cloud، مثل gemma4:cloud: إذ تشغّلها Ollama على خوادمها الخاصة من دون تنزيل أوزان النموذج، لذلك تخص مساحة القرص المذكورة أدناه النماذج المحلية. إذا كنت تفضّل استبدال ذلك بنموذج سبق أن حدّد شخص ما حجمه استناداً إلى خادم فعلي، فإن تشغيل Nemotron 3.5 Lightning على VPS يوفّر الوسم الدقيق المطلوب سحبه والذاكرة التي يتوقع توفرها.
لماذا يبدو تشغيل ollama الأول وكأنه تجمّد
قد يستمر أول run على VPS جديد عدة دقائق من دون أي مخرجات. لا يوجد عطل. لا يمكن أن يظهر موجه الدردشة قبل تنزيل النموذج إلى القرص وتحميله في الذاكرة، لذلك ينفّذ run عملية تنزيل بحجم عدة غيغابايت قبل أن يعرض لك أي شيء.
هناك عاملان يخفيان هذه العملية. يكتب Ollama شريط التقدم إلى standard error، لذلك لا يظهر أي مؤشر على تشغيل التنزيل عندما يُهمَل هذا المجرى أو لا تتم قراءته إلا لاحقاً، كما يحدث في script ينتهي بـ 2>/dev/null أو في cron job. وبعد وصول وحدات البايت، يجب أيضاً قراءة الملف من القرص إلى RAM قبل ظهور أول token، وتكون هذه القراءة بطيئة على VPS صغير. وإذا لم تتوفر في الخادم ذاكرة كافية للنموذج، تبدأ النواة باستخدام swap، وتطول مدة الانتظار كثيراً.
راقب العملية من جلسة ثانية بدلاً من التخمين:
df -h /
watch -n5 df -h /على خادم جديد، يعني انخفاض المساحة الحرة على مراحل أن التنزيل ما زال جارياً. لكن توقف انخفاض المساحة الحرة بينما يظل الأمر مشغولاً لا يثبت أن التحميل بدأ: بعد التنزيل، ينفّذ Ollama مرحلة verifying sha256 digest منفصلة تقرأ الملفات قبل كتابة manifest وإكمال pull. وقد يضللك خادم يحتوي على نماذج مسبقاً عند استخدام Ollama 0.40.2: إذ كان التشغيل الأول لنموذج نُزّل بإصدار أقدم يكتب نسخة مطوّرة في الخلفية ويحتفظ بالنسخة الأصلية كنسخة احتياطية، لذلك كان يمكن أن تنخفض المساحة الحرة من دون وجود أي تنزيل. أوقف Ollama 0.40.3، الذي صدر في 11 October 2026، عملية الترقية الخلفية هذه مؤقتاً.
هذا هو سبب إجراء pull مسبقاً. يجب ألا يكون الشخص الذي يكتب ollama run هو من يتحمل تكلفة التنزيل.
اسحب النموذج قبل أن يطلبه أي طرف
ينطبق الأمر نفسه على كل ما ليس شخصاً: وكيل برمجي موجّه إلى نقطة نهاية Ollama يحصل على خطأ يفيد بعدم العثور على النموذج إذا لم يُسحب النموذج المحلي المطلوب؛ ولا ينزّله طلب الاستدلال. على خادم جديد، اسحب النموذج ضمن السكربت نفسه الذي يثبّت الخادم:
curl -fsSL https://ollama.com/install.sh | sh
ollama pull gemma4إذا كنت تنشئ الخادم للمرة الأولى، يشرح دليل تثبيت Ollama بالكامل على VPS الخدمة نفسها والجهات المسموح لها بالوصول إليها. بعد ذلك، من المفيد إعداد عملية سحب تستمر بعد إغلاق الطرفية، لأن انقطاع التنزيل في منتصفه يؤدي إلى مخزن نماذج غير مكتمل.
شغّلها داخل tmux، أو سلّمها إلى systemd كوحدة تُنفَّذ مرة واحدة عند الإقلاع. اكتب /etc/systemd/system/ollama-pull.service:
[Unit]
Description=Pre-pull Ollama models
Wants=ollama.service network-online.target
After=ollama.service network-online.target
[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/bin/sh -c 'until ollama list >/dev/null 2>&1; do sleep 2; done'
ExecStart=/bin/sh -c 'ollama pull gemma4'
[Install]
WantedBy=multi-user.targetيعمل الأمران عبر /bin/sh -c عن قصد. يقبل ExecStart= العاري مساراً مطلقاً أو اسماً بسيطاً لملف تنفيذي يُحلّ عبر مسار البحث الثابت في systemd؛ ويعرض command -v ollama المسار الذي تعثر عليه الصدفة الحالية. استخدام الصدفة يطبّق PATH الخاص بالخدمة بدلاً من استخدام مسار منسوخ من دليل. كما أن ExecStart الأول مهم: يعني After=ollama.service أن وحدة الخادم بدأت، وهذا لا يعني أنها أصبحت جاهزة؛ لذلك تنتظر الحلقة إلى أن يستجيب ollama list قبل بدء السحب.
sudo systemctl daemon-reload
sudo systemctl enable --now ollama-pull.service
journalctl -u ollama-pull.serviceيجب أن يعرض السجل انتهاء السحب دون أخطاء، ويجب أن يعرض ollama list النموذج بعد ذلك. للحفاظ على تحديث وسم متحرك، أضف مؤقتاً في systemd أو إدخالاً أسبوعياً في cron يشغّل عملية السحب نفسها. يؤدي سحب وسم تغيّر إلى تنزيل الطبقات الجديدة، وإلى حذف الطبقات القديمة التي لا تستخدمها أي جهة، بالنسبة إلى معظم النماذج، في نهاية عملية السحب نفسها.
ما يحدث عند انقطاع عملية السحب
تُخزَّن كل طبقة من طبقات النموذج تحت تجزئة لمحتواها الخاص. لذلك لا يضيع العمل عند انقطاع عملية السحب: شغّل ollama pull نفسه مرة أخرى، وستتعرّف الأداة على الطبقات التي اكتمل تنزيلها وتتجاوزها، ثم تتابع التنزيل من الطبقة التي انقطع تنزيلها.
يمكن لإجراء واحد أن يدمّر هذا التقدم. عند بدء تشغيل خادم Ollama، يزيل التنزيلات الجزئية والطبقات المخزنة التي لا يشير إليها أي بيان نموذج، والأجزاء التي خلّفتها عملية سحب متوقفة هي من هذا النوع تماماً. تتجاوز الإصدارات الحالية (0.40.11، وفق التحقق في 26 October 2026) أي ملف كُتب خلال الساعة الأخيرة، لذلك لا يسبب إعادة التشغيل بعد وقت قصير من توقف عملية السحب مشكلة. أما إعادة التشغيل بعد مرور ساعات، فتتخلص من الجزء الذي سبق أن نزّلته. أعد محاولة السحب أولاً، ثم أعد التشغيل لاحقاً. إذا كان يجب أن يبقى التنزيل الجزئي بعد إعادة التشغيل فعلاً، فاضبط OLLAMA_NOPRUNE=1 في بيئة الخدمة، ثم أزله لاحقاً، لأن هذا المتغير يعطّل أيضاً التنظيف الذي يحدث في نهاية كل عملية سحب. وعمليتا التنظيف هاتان هما ما يمنع تراكم الطبقات اليتيمة على القرص.
إذا توقفت عملية السحب مع no space left on device، فحرّر مساحة قبل إعادة المحاولة. إذا أبلغ df عن امتلاء القرص، ولم تفسّر قيمة du في مجلد النموذج ذلك، فقد ذهبت المساحة إلى مكان آخر. في هذه الحالة، يجدر بك قراءة أسباب اختلاف نتائج df وdu قبل حذف أي شيء.
أين يخزن Ollama النماذج على خادم VPS؟
اسأل خادمك مباشرة بدلاً من الوثوق بمسار من أي دليل، بما في ذلك هذا الدليل. يختلف الموقع بين التثبيت عبر الحزم والتثبيت داخل حاوية، ويتغير مجدداً إذا قام أي شخص بضبط OLLAMA_MODELS.
systemctl cat ollama.service
getent passwd ollama
sudo find / -xdev -type d -name blobs 2>/dev/nullيعرض systemctl cat ملف الوحدة (unit file) مع كل إعدادات الإضافة (drop-ins)، لذا سيظهر أي سطر OLLAMA_MODELS قمت بضبطه أو كان مضمناً في صورتك هناك. في حال عدم وجود مثل هذا السطر، يقع المتجر تحت المجلد الرئيسي (home directory) للحساب الذي تعمل الخدمة بصلاحياته، ويطبع getent passwd ذلك المجلد في الحقل السادس المفصول بنقطتين. يبحث find في نظام الملفات عن المجلد blobs، وهو المكان الذي تُكتب فيه الطبقات فعلياً. استخدم -xdev إذا كانت النماذج موجودة بالفعل على وحدة تخزين (mount) منفصلة.
الآن قِس، واقرأ أرقامك الخاصة:
ollama list
df -h /
sudo du -sh /the/directory/you/found
sudo du -h -d1 /the/directory/you/foundيحتوي المتجر على نوعين من المحتوى. تحتفظ مجلدات البيان (manifests، التي ينضم إليها manifests-v2 في الإصدارات الحالية) بملفات صغيرة تسرد، لكل وسم نموذج، الطبقات التي بُني منها. يحتفظ blobs بالطبقات نفسها، حيث يُسمى كل منها بناءً على هاش (hash) محتوياتها، وهناك يتركز معظم الحجم. نظراً لأن الطبقات مشتركة بين الوسوم، فإن نموذجين مبنيين على نفس الأوزان يبلغان عن حجمهما الخاص في ollama list بينما يشغلان تلك المساحة مرة واحدة فقط على القرص، لذا قد تتجاوز الأحجام المدرجة ما يبلغه du للمجلد. تأتي المفاجأة المعاكسة من Ollama 0.40.2: النماذج التي تمت ترقيتها في الخلفية تحتفظ بنسختها الأصلية على القرص كنسخة احتياطية، وهو ما لا يظهره ollama list مرتين، لذا قد يبلغ du عن مساحة أكبر بكثير مما تشير إليه القائمة. تتضمن ملاحظات إصدار 0.40.2 نصاً برمجياً يحذف تلك النسخ الاحتياطية فقط.
تملأ ملفات النماذج نظام ملفات الجذر في خادم VPS صغير بشكل أسرع من أي شيء آخر من المحتمل أن تثبته، وأكبر عامل مؤثر في حجمها هو تنسيق الأوزان. الاختيار بين q4 و q8 و fp16 يوفر غيغابايتات لكل نموذج.
نقل النماذج إلى وحدة تخزين للبيانات باستخدام OLLAMA_MODELS
إذا كانت الخطة تتضمن قرصاً ثانياً أو وحدة تخزين أكبر للبيانات، فانقل مخزن النماذج قبل امتلاء نظام الملفات الجذر. أوقف الخادم أولاً حتى لا تنسخ ملفاً ما يزال قيد الكتابة.
sudo systemctl stop ollama
sudo mkdir -p /mnt/data/ollama-models
sudo rsync -a /the/directory/you/found/ /mnt/data/ollama-models/
sudo chown -R ollama:ollama /mnt/data/ollama-models
sudo systemctl edit ollama.serviceيفتح systemctl edit محرراً على ملف drop-in، لذلك تبقى الوحدة المثبتة كما هي، ولا يمكن لترقية الحزمة الكتابية أن تستبدل تغييراتك. أضف السطرين التاليين:
[Service]
Environment="OLLAMA_MODELS=/mnt/data/ollama-models"sudo systemctl daemon-reload
sudo systemctl restart ollama
systemctl show ollama --property=Environment
ollama listيجب أن يطبع systemctl show المسار الجديد، ويجب أن يعرض ollama list النماذج نفسها التي عرضها قبل النقل. إذا كانت القائمة فارغة، فتحقق من أن الدليل الجديد يحتوي على المخزن المنسوخ، وأن الخادم يستطيع قراءته. تعمل الخدمة بصفة المستخدم ollama، لذلك يجب أن يملك هذا المستخدم صلاحيات القراءة والكتابة على الوجهة. هذا ما يوفّره السطر chown أعلاه. افحص journalctl -e -u ollama بحثاً عن أخطاء صلاحيات تتضمن المسار الجديد. احذف النسخة القديمة فقط بعد التأكد من صحة القائمة، لأن فشل النقل ثم حذف المصدر يعني تنزيل كل شيء مرة أخرى.
يُبقي الخيار الآخر المسار الأصلي، ويركب وحدة تخزين البيانات عليه:
echo '/mnt/data/ollama-models /the/directory/you/found none bind 0 0' | sudo tee -a /etc/fstab
sudo mount -a
findmnt /the/directory/you/found
df -h /تعني طباعة نقطة التركيب بواسطة findmnt أن الربط نشط. يفيد الربط عندما يتوقع شيء آخر على الخادم وجود الموقع الافتراضي. لكن له مشكلة واحدة: تبقى الملفات التي نسختها تحت نقطة التركيب على القرص الجذر، وتحجبها نقطة التركيب، لذلك لا تُستعاد المساحة حتى تفصل التركيب وتحذف هذه الملفات. يسهل شرح متغير البيئة أكثر من الخيارين للشخص الذي سيسجّل الدخول بعد ذلك.
أين يحتفظ بها الحاوي بدلاً من ذلك
تخزّن الصورة الرسمية النماذج في المسار الذي تربطه، وليس في أي دليل على المضيف يملكه مستخدم ollama. أمر التشغيل الموثّق هو:
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollamaيمثّل ollama قبل النقطتين وحدة تخزين Docker مسماة، بينما يمثّل /root/.ollama المسار الذي يكتب فيه الخادم داخل الحاوي. لذلك لا يعثر du على شيء عند فحص المسارات من القسم السابق، لأن الملفات غير موجودة هناك. اطبع الموقع والحجم الفعليين:
docker volume inspect ollama
docker system df -v
docker exec -it ollama ollama listاقرأ الحقل Mountpoint من docker volume inspect، ثم نفّذ sudo du -sh عليه. لوضع النماذج في وحدة تخزين للبيانات، استبدل وحدة التخزين المسماة بدليل على المضيف (-v /mnt/data/ollama:/root/.ollama) وأعد إنشاء الحاوي. يكتب الحاوي بصفة root، ولذلك ينتهي الدليل على المضيف مملوكاً لـ root. في Podman دون root، يُطابَق root داخل الحاوي مع UID وGID الخاصين بمستخدمك على المضيف افتراضياً، بينما تستخدم معرّفات الحاوي الأخرى نطاقات فرعية؛ يشرح تشغيل Ollama باستخدام Podman دون root هذا الربط.
تنبيه بشأن التنظيف. يحذف docker volume prune العادي وحدات التخزين المجهولة فقط، ولذلك يترك وحدة التخزين المسماة ollama دون تغيير، لكن docker volume prune --all يحذف كل وحدة تخزين لا يشير إليها أي حاوي، بما في ذلك الوحدات المسماة. إذا حذفت حاوي ollama أو أعدت إنشاءها من دون وحدة التخزين، فسيحذف prune --all لاحقاً كل نموذج نزّلته، ولن تتمكن من استعادته إلا بإعادة تنزيله. اقرأ كيفية تقليص استخدام Docker للقرص على VPS قبل تشغيل prune على خادم يستضيف النماذج.
إزالة نموذج باستخدام ollama rm، وليس باستخدام rm
ollama list
ollama rm gemma4
ollama list
df -h /يحذف ollama rm ملف manifest الخاص بالوسم، ثم يحذف الطبقات التي لا يشير إليها أي manifest متبقٍّ. تعود المساحة فور إلغاء ربط هذه الملفات، لذلك يتحرك df مباشرة. وبما أن الطبقات مشتركة، فقد تؤدي إزالة أحد وسمين متقاربين إلى تحرير مساحة أقل بكثير من الحجم الذي طبعه ollama list بجانبه. هذا سلوك صحيح، وليس فشلًا في الحذف.
يؤدي حذف الملفات يدوياً إلى كسر هذا الترابط. أزل blob باستخدام rm، لكن manifest سيظل يسرده، لذلك سيواصل ollama list إظهار النموذج، وسيفشل أيّ استدعاء لاستخدامه عند قراءة الطبقة المفقودة. وإذا أزلت manifest يدوياً، فستبقى طبقاته على القرص من دون أي مرجع إليها، وستشغل مساحة لن يعرضها لك أي أمر من أوامر Ollama. إذا كنت قد حذفت blob بالفعل، فاستخدم ollama rm على الوسم لإزالة الإدخال المتبقي؛ أما إذا حذفت manifest، فلن يبقى إدخال للوسم يمكن إزالته. تؤدي إعادة تشغيل الخادم إلى إزالة الطبقات التي لا يشير إليها شيء، بعد مرور أكثر من ساعة على بقائها كذلك.
هناك تمييز أخير لأن الخلط بين الأمرين شائع جداً. يتعامل ollama rm مع القرص. أما ollama stop gemma4 فيزيل تحميل نموذج من الذاكرة، ولا يحرر أي مساحة على القرص. وتُعد المدة التي يبقى خلالها النموذج مقيماً في RAM بعد اكتمال التنزيل إعداداً منفصلاً، ويشرح إبقاء النموذج محمّلاً بدلاً من إعادة تحميله مع كل طلب هذا الإعداد.
FAQ
ما الفرق بين ollama pull وollama run؟
ينزّل ollama pull نموذجاً إلى القرص ثم ينتهي. يتحقق ollama run من وجود النموذج على القرص، وينزّله إذا لم يكن موجوداً، ويحمله في الذاكرة، ثم يفتح جلسة محادثة تفاعلية لنموذج المحادثة. يكتب الأمران الملفات نفسها في الدليل نفسه. استخدم pull في عمليات التجهيز وفي البرامج النصية، واستخدم run عندما تكون أمام لوحة المفاتيح. يرسل ollama run <model> "your prompt" مطالبة واحدة ثم ينتهي، وهو الشكل القابل للبرمجة من run.
لماذا يبدو أول تشغيل لـollama run وكأنه متوقف؟
قد يكون الأمر ينزّل النموذج أو يتحقق من التنزيل أو يحمله. لا تظهر مطالبة المحادثة حتى يصبح النموذج على القرص ويُحمّل في الذاكرة، وحجم النموذج عدة غيغابايت. يكتب Ollama شريط التقدم إلى standard error، لذلك لا يعرض لك run داخل برنامج نصي يتجاهل هذا التدفق، أو داخل مهمة cron، أي شيء أثناء عمله. افتح جلسة ثانية وشغّل watch -n5 df -h /؛ في خادم جديد، يعني انخفاض المساحة الحرة على مراحل أن التنزيل جارٍ. نزّل النموذج مسبقاً لتجنب انتظار التنزيل والتحقق؛ أما التحميل فما زال يستغرق وقتاً.
أين يخزّن Ollama نماذجه؟
يعتمد الموقع على طريقة التثبيت، لذلك اطبعه بدلاً من افتراضه. شغّل systemctl cat ollama.service لمعرفة ما إذا كان OLLAMA_MODELS مضبوطاً في الوحدة أو في drop-in. إذا لم يكن مضبوطاً، يوجد المخزن ضمن الدليل المنزلي للحساب الذي تعمل الخدمة باسمه، ويطبع getent passwd ollama هذا الحساب. يحدد sudo find / -xdev -type d -name blobs 2>/dev/null دليل الطبقات مباشرة. في صورة الحاوية، يوجد المخزن داخل volume المركّب، ويطبع docker volume inspect ollama مساره على المضيف Mountpoint.
كيف أنقل نماذج Ollama إلى قرص آخر؟
أوقف الخدمة، وانسخ المخزن إلى الموقع الجديد باستخدام rsync -a، وامنح الدليل إلى حساب الخدمة باستخدام sudo chown -R ollama:ollama <directory>، ثم شغّل sudo systemctl edit ollama.service وأضف Environment="OLLAMA_MODELS=<directory>" تحت سطر [Service]. أعد التحميل باستخدام sudo systemctl daemon-reload ثم أعد التشغيل. تحقّق باستخدام systemctl show ollama --property=Environment وollama list. إذا كانت القائمة فارغة، فتحقق من أن الدليل الجديد يحتوي على المخزن المنسوخ، وأن المستخدم ollama يستطيع قراءته؛ وافحص journalctl -e -u ollama بحثاً عن أخطاء الصلاحيات.
هل يؤدي حذف ملفات النموذج إلى تحرير المساحة؟
يحرر حذف الملفات يدوياً المساحة، لكنه يترك المخزن في حالة غير متسقة. إذا حذفت blob، فسيظل manifest يدرج ذلك النموذج، لذلك سيستمر ظهوره في ollama list ويفشل عند استخدامه. وإذا حذفت manifest، فستبقى طبقاته على القرص دون مرجع إليها. استخدم ollama rm <model>، إذ يحذف manifest ثم يحذف الطبقات التي لا يحتاج إليها أي نموذج آخر. إذا كان قد حُذف blob يدوياً، فشغّل ollama rm على الوسم لإزالة الإدخال. وإذا حُذف manifest، فلن يتبقى إدخال للوسم لإزالته. أعد تشغيل الخادم لإزالة الطبقات التي لا يشير إليها أي manifest بعد أن يصبح عمرها أكثر من ساعة.