يمكن لـ Ollama تشغيل نموذج منزّل على حاسوبك وإتاحته عبر عنوان HTTP محلي. يتتبع الدليل نموذجًا واحدًا من التثبيت إلى دردشة الطرفية وإجابة API كاملة، مستخدمًا الاسم نفسه في كل خطوة. هذا إجراء يستند إلى الوثائق: لم تثبّت BIG CHANGE البرنامج ولم تراقب النتائج على جهازك.

التغيير الكبير

  • ما الذي تغيّر: يوفر Ollama طريقًا مباشرًا من نموذج منزّل إلى دردشة الطرفية وAPI محلي. يمكن للمبتدئ فحص اسم النموذج وإجابته في كل واجهة بدل افتراض أن نافذة الدردشة تثبت مكان تنفيذ الاستدلال.
  • لماذا يهم: الخادم المحلي وAPI السحابة في Ollama وجهتان مختلفتان. لمهمة عمل أو مهمة شخصية مسموحة، يمكنك إبقاء التمرين على حاسوبك باختيار نموذج منزّل والتوجه إلى localhost، مع فحص إعداد الخادم بصورة منفصلة.
  • ما الذي ينبغي مراقبته: عنوان URL محلي وحده لا يثبت أن كل ميزة أو تطبيق متصل يبقى محليًا. يستطيع Ollama استخدام نماذج سحابية عبر خادمه المحلي أيضًا. الفحوص الحاسمة هي وسم النموذج المثبّت، ووجهة الطلب، وعنوان ربط الخادم، وعند اشتراط العمل المحلي الصارم، سجل تعطيل السحابة بعد إعادة التشغيل.

قبل البدء

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

تحتاج إلى مساحة لـ Ollama والنموذج، وذاكرة كافية لتحميله، واتصال إنترنت للتثبيت والتنزيل. يستخدم دليل البدء السريع في Ollama النموذج gemma4:e2b مثالًا محليًا ويوصي بذاكرة VRAM متاحة قدرها 8 GB، أو ذاكرة موحدة على Mac. تقول Ollama إنها تستطيع الرجوع إلى RAM النظام مع ردود أبطأ. افحص صفحة النموذج الحالية للوسم الدقيق وحجم التنزيل والترخيص قبل المتابعة. حجم التنزيل لا يثبت قدرة حاسوبك على تشغيل النموذج. إذا لم يناسب الجهاز أو الاستخدام المسموح، فاختر نموذجًا أصغر محليًا قابلًا للتنزيل من المكتبة واستبدل gemma4:e2b في كل أمر أدناه بالوسم الدقيق للنموذج المختار. لا تختَر وسم :cloud لهذا التمرين.

1. ثبّت Ollama وافحص الخادم المحلي

احصل على Ollama من صفحة التنزيل الرسمية واتبع تعليمات نظام التشغيل: Windows، macOS أو Linux. على Windows وmacOS افتح التطبيق المثبّت. على Linux اتبع طريقة التثبيت التي اخترتها وشغّل خدمتها؛ إذا لم تكن خدمة قيد التشغيل، يوصي دليل البدء السريع بتشغيل ollama serve في طرفية منفصلة. لا تبدأ خادمًا ثانيًا فوق تطبيق أو خدمة تستمع بالفعل.

في طرفية جديدة، افحص الإصدار المثبّت واستجابة الخادم المحلي:

Terminal
ollama -v
ollama ls

سجّل الإصدار الفعلي ونظام التشغيل. قد تكون قائمة النماذج فارغة قبل أول تنزيل؛ خطأ أمر أو اتصال يعني حل التثبيت أو بدء الخادم أولًا. توضح الأسئلة الشائعة في Ollama أن عنوان الاستماع الافتراضي هو 127.0.0.1:11434. أبقه على واجهة الاسترجاع الداخلي في هذا التمرين؛ لا تضبط ربط شبكة أو وكيلًا أو نفقًا.

2. نزّل نموذجًا محليًا محددًا

بعد فحص صفحة النموذج، شغّل:

Terminal
ollama pull gemma4:e2b
ollama ls

يجب أن يظهر الوسم الدقيق في ollama ls بعد التنزيل. سجّل الوسم والحجم المعروض والترخيص على الصفحة. إذا فشل التنزيل أو غاب الوسم، افحص الكتابة وفق المكتبة الحالية ومساحة القرص والشبكة وأخطاء الوكيل أو الإذن قبل التكرار. التنزيل الجزئي ليس إعدادًا ناجحًا.

3. افحص الدردشة التفاعلية والمنفردة في الطرفية

ابدأ دردشة تفاعلية:

Terminal
ollama run gemma4:e2b

الصق سؤال التدريب المعتمد في الدردشة. افحص الإجابة مقابل الوثيقة التي استخدمتها لصياغته، ثم اكتب /bye للخروج. احفظ السؤال والإجابة الفعليين لفحصك؛ لا يقدم المقال نتيجة نموذجية.

لتشغيل منفرد منفصل، استخدم السؤال نفسه. في PowerShell على Windows:

PowerShell
$practicePrompt = Read-Host 'Paste your approved practice question'
ollama run gemma4:e2b $practicePrompt

في طرفية Bash على macOS أو Linux:

Terminal
read -r -p 'Paste your approved practice question: ' practice_prompt
ollama run gemma4:e2b "$practice_prompt"

افحص الإجابة المنفردة الفعلية مقابل المصدر نفسه. لا يلزم تطابق صياغة الإجابتين؛ المفيد هو تأكيد أن الأمرين شغّلا الوسم المقصود وأن كل ادعاء واقعي يصمد أمام مقارنة المصدر.

4. اسأل النموذج نفسه عبر localhost

تستقبل واجهة API الدردشة اسم النموذج والرسائل على POST /api/chat. تبث الإجابة افتراضيًا؛ ويطلب stream: false إجابة JSON كاملة واحدة. تميز مقدمة API عنوان الأساس المحلي http://localhost:11434/api عن عنوان السحابة المباشر https://ollama.com/api. الطلب المحلي لا يحتاج إلى مفتاح API.

على Windows يستطيع PowerShell بناء JSON بأمان من السؤال الملصق:

PowerShell
$practicePrompt = Read-Host 'Paste the same approved practice question'
$body = @{ model = 'gemma4:e2b'; messages = @(@{ role = 'user'; content = $practicePrompt }); stream = $false } | ConvertTo-Json -Depth 5
$response = Invoke-RestMethod -Uri 'http://localhost:11434/api/chat' -Method Post -ContentType 'application/json; charset=utf-8' -Body $body
$response | Select-Object model, done
$response.message.content

على macOS أو Linux يستخدم مثال Bash التالي Python 3 فقط لمعالجة محارف السؤال بشكل صحيح داخل JSON. تأكد من تثبيت python3 و curl قبل استخدامه:

Terminal
read -r -p 'Paste the same approved practice question: ' practice_prompt
export practice_prompt
python3 -c 'import json,os; print(json.dumps({"model":"gemma4:e2b","messages":[{"role":"user","content":os.environ["practice_prompt"]}],"stream":False}))' | curl -fsS 'http://localhost:11434/api/chat' -H 'Content-Type: application/json' --data-binary @-

ينبغي أن يعيد الطلب نجاح HTTP وكائن JSON واحدًا تكون قيمة model فيه مطابقة للوسم المنزّل، وقيمة done هي true، ومحتوى message.content غير فارغ. اقرأ الإجابة الفعلية وافحصها مقابل المصدر. الاستجابة الناجحة تثبت الوجهة المحلية والنموذج المختار لهذا الطلب؛ احفظ مخرجاتك بدل الاعتماد على محادثة نموذجية.

5. افحص موضع التنفيذ وحدود التشغيل المحلي

أثناء تحميل النموذج في الذاكرة، شغّل:

Terminal
ollama ps

يعرض عمود PROCESSOR ما إذا كان النموذج محملًا على CPU أو GPU أو كليهما، بحسب الأسئلة الشائعة في Ollama. سجّل ما يظهره جهازك فعلًا. إذا أُفرغ النموذج من الذاكرة، أرسل سؤالًا آخر وافحص مجددًا. يمكنك إفراغه عند الانتهاء باستخدام ollama stop gemma4:e2b؛ أما إزالته باستخدام ollama rm gemma4:e2b فهي تنظيف اختياري للقرص بعد حفظ الملاحظات.

لإعداد Ollama محلي صارم، اتبع تعليمات تعطيل السحابة الرسمية: ضع disable_ollama_cloud في ~/.ollama/server.json للحساب الذي يشغّل خادم Ollama (مجلد .ollama في ملف مستخدم ذلك الحساب على Windows)، مع الحفاظ على إعدادات JSON الأخرى الموجودة:

JSON
{
  "disable_ollama_cloud": true
}

على Linux تعمل خدمة systemd الموثقة بهوية User=ollama، ودليلها المنزلي هو /usr/share/ollama؛ تعديل ملف مجلدك المنزلي لا يهيئ هذه الخدمة. في تثبيت systemd يمكنك بدلًا من ذلك استخدام بديل Ollama الموثق OLLAMA_NO_CLOUD=1 في إعداد تجاوز الخدمة. افحص الخدمة الموجودة أولًا باستخدام systemctl cat ollama.service، ثم افتح تجاوزًا باستخدام sudo systemctl edit ollama.service. أضف ما يلي تحت [Service] مع الحفاظ على إعدادات التجاوز الأخرى:

Snippet
[Service]
Environment="OLLAMA_NO_CLOUD=1"

احفظ التجاوز، ثم أعد تحميل إعداد الخدمة وأعد تشغيلها:

Terminal
sudo systemctl daemon-reload
sudo systemctl restart ollama.service

أعد تشغيل تطبيق Ollama على Windows أو macOS بعد تغيير إعداداته. ابحث في سجل الخادم عن السطر الدقيق Ollama cloud disabled: true. على Windows السجل الموثق هو %LOCALAPPDATA%\Ollama\server.log؛ وعلى macOS هو ~/.ollama/logs/server.log؛ وفي Linux مع systemd استخدم journalctl -e -u ollama. متغير البيئة المعين في طرفية غير مرتبطة لا يصل بالضرورة إلى تطبيق أو خدمة قيد التشغيل. تعطيل ميزات السحابة يزيل نماذج Ollama السحابية والبحث على الويب. إذا لم يؤكد السجل الإعداد، فأصلح التهيئة وأعد التشغيل قبل وصفه بالمحلي فقط.

تأكد في سجل الخادم أو بأداة فحص الاستماع في نظامك أن الاستماع ما زال على 127.0.0.1:11434، وكرر طلب localhost بالوسم المنزّل. OLLAMA_HOST قد يغير عنوان الربط، لذا افحص الخادم الجاري بدل افتراض القيمة الافتراضية. مكتبة Python منفصلة أو واجهة متصفح أو وكيل برمجة أو تطبيق متصل يحتاج إلى فحص وجهته ومسار بياناته؛ إجابة Ollama المحلية لا تثبت سلوك الخصوصية لذلك التطبيق.

على Windows افحص عنوان الاستماع في PowerShell:

PowerShell
Get-NetTCPConnection -LocalPort 11434 -State Listen | Select-Object LocalAddress, LocalPort

على macOS استخدم lsof -nP -iTCP:11434 -sTCP:LISTEN؛ وعلى Linux استخدم ss -ltn '( sport = :11434 )'. إذا غابت أداة المنصة، افحص سجل الخادم. عنوان استماع شامل أو خارج الاسترجاع الداخلي يحتاج إلى تحقيق قبل اعتبار API محصورًا في هذا الحاسوب.

إذا فشل فحص

إذا فشل ollama -v أو ollama ls، فارجع إلى صفحة تثبيت نظام التشغيل وبدئه. رفض اتصال localhost يعني عادة توقف التطبيق أو الخدمة أو الاستماع في مكان آخر؛ افحص السجلات وعنوان الربط بدل كشف API للشبكة. إذا وصلت الاستجابة في أسطر JSON متعددة، فتأكد من احتواء الطلب على "stream": false. إذا نفدت الذاكرة أو كان النموذج بطيئًا بصورة غير عملية، افحص ollama ps واختر وسمًا محليًا أصغر فعلًا من المكتبة، ثم كرر التنزيل والطرفية وAPI بذلك الوسم وحده. اعتبر أي مرحلة لم تكملها غير متحقق منها.

يحتاج التمرين المحلي إلى عتاد وكهرباء ومساحة تنزيل، لكن لا مفتاح API من Ollama ولا حساب API مدفوع. قد يقيد ترخيص النموذج استخدامك المقصود. النماذج السحابية والعملاء الاختياريون من أطراف أخرى لهم شروط ومسارات بيانات منفصلة. لمقارنة شراء عتاد أعمق، راجع دليلنا للنماذج المحلية مع 128 GB؛ ولمهمة برمجية مختلفة تستخدم Ollama مع Claude Code، راجع دليل التغيير المفحوص.

المصادر وقراءات إضافية

  • البدء السريع في Ollama يشرح التثبيت والمثال المحلي gemma4:e2b وتوصية الذاكرة. مثاله توثيق، وليس اختبارًا لجهازك.
  • مرجع سطر الأوامر يسرد الأوامر الحالية pull، run، ls، ps، stop، rm و serve المستخدمة هنا.
  • مقدمة API ونقطة نهاية الدردشة يفصلان العناوين المحلية والسحابية ويحددان الطلب غير المتدفق وحقول الاستجابة.
  • الأسئلة الشائعة توثق ربط الاسترجاع الداخلي وموضع المعالج وتعطيل السحابة وفحص السجل.
  • صفحة Gemma 4 E2B تقدم الوسم الدقيق الحالي والحجم ومواد الترخيص لفحصها قبل التنزيل.