نسخة Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# شغّل نموذج Ollama محليًا وافحص API الدردشة

> ثبّت Ollama، واختر نموذجًا منزّلًا، وافحص إجاباته في الطرفية، ثم أرسل السؤال نفسه إلى API الدردشة على localhost. تحقق من النموذج وحدود السحابة قبل وصف الإعداد بأنه محلي فقط.

By BIG CHANGE Editorial

Published: 2026-10-20T14:31:39.416Z
Updated: 2026-10-20T14:31:39.416Z
Canonical: https://bigchange.ai/blog/run-local-ollama-model-chat-api-guide

![Conceptual charcoal illustration of a closed desktop computer tower beside a keyboard and an angled monitor showing indistinct terminal marks.](https://bigchange.ai/api/media/file/ollama-local-chat-api-desktop-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

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

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

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

## قبل البدء

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

تحتاج إلى مساحة لـ Ollama والنموذج، وذاكرة كافية لتحميله، واتصال إنترنت للتثبيت والتنزيل. يستخدم [دليل البدء السريع في Ollama](https://docs.ollama.com/quickstart) النموذج `gemma4:e2b` مثالًا محليًا ويوصي بذاكرة VRAM متاحة قدرها 8 GB، أو ذاكرة موحدة على Mac. تقول Ollama إنها تستطيع الرجوع إلى RAM النظام مع ردود أبطأ. افحص [صفحة النموذج الحالية](https://ollama.com/library/gemma4:e2b) للوسم الدقيق وحجم التنزيل والترخيص قبل المتابعة. حجم التنزيل لا يثبت قدرة حاسوبك على تشغيل النموذج. إذا لم يناسب الجهاز أو الاستخدام المسموح، فاختر نموذجًا أصغر *محليًا قابلًا للتنزيل* من [المكتبة](https://ollama.com/library) واستبدل `gemma4:e2b` في **كل** أمر أدناه بالوسم الدقيق للنموذج المختار. لا تختَر وسم `:cloud` لهذا التمرين.

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

احصل على Ollama من [صفحة التنزيل الرسمية](https://ollama.com/download) واتبع تعليمات نظام التشغيل: [Windows](https://docs.ollama.com/windows)، [macOS](https://docs.ollama.com/macos) أو [Linux](https://docs.ollama.com/linux). على Windows وmacOS افتح التطبيق المثبّت. على Linux اتبع طريقة التثبيت التي اخترتها وشغّل خدمتها؛ إذا لم تكن خدمة قيد التشغيل، يوصي [دليل البدء السريع](https://docs.ollama.com/quickstart) بتشغيل `ollama serve` في طرفية منفصلة. لا تبدأ خادمًا ثانيًا فوق تطبيق أو خدمة تستمع بالفعل.

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

```shell
ollama -v
ollama ls
```

سجّل الإصدار الفعلي ونظام التشغيل. قد تكون قائمة النماذج فارغة قبل أول تنزيل؛ خطأ أمر أو اتصال يعني حل التثبيت أو بدء الخادم أولًا. توضح [الأسئلة الشائعة](https://docs.ollama.com/faq) في Ollama أن عنوان الاستماع الافتراضي هو `127.0.0.1:11434`. أبقه على واجهة الاسترجاع الداخلي في هذا التمرين؛ لا تضبط ربط شبكة أو وكيلًا أو نفقًا.

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

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

```shell
ollama pull gemma4:e2b
ollama ls
```

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

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

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

```shell
ollama run gemma4:e2b
```

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

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

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

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

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

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

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

تستقبل [واجهة API الدردشة](https://docs.ollama.com/api/chat) اسم النموذج والرسائل على `POST /api/chat`. تبث الإجابة افتراضيًا؛ ويطلب `stream: false` إجابة JSON كاملة واحدة. تميز [مقدمة API](https://docs.ollama.com/api/introduction) عنوان الأساس المحلي `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` قبل استخدامه:

```bash
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. افحص موضع التنفيذ وحدود التشغيل المحلي

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

```shell
ollama ps
```

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

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

```json
{
  "disable_ollama_cloud": true
}
```

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

```plaintext
[Service]
Environment="OLLAMA_NO_CLOUD=1"
```

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

```bash
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](https://bigchange.ai/blog/run-local-models-128gb-memory-cost)؛ ولمهمة برمجية مختلفة تستخدم Ollama مع Claude Code، راجع [دليل التغيير المفحوص](https://bigchange.ai/blog/claude-code-local-ollama-checked-change-guide).

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

- [البدء السريع في Ollama](https://docs.ollama.com/quickstart) يشرح التثبيت والمثال المحلي `gemma4:e2b` وتوصية الذاكرة. مثاله توثيق، وليس اختبارًا لجهازك.
- [مرجع سطر الأوامر](https://docs.ollama.com/cli) يسرد الأوامر الحالية `pull`، `run`، `ls`، `ps`، `stop`، `rm` و `serve` المستخدمة هنا.
- [مقدمة API](https://docs.ollama.com/api/introduction) و[نقطة نهاية الدردشة](https://docs.ollama.com/api/chat) يفصلان العناوين المحلية والسحابية ويحددان الطلب غير المتدفق وحقول الاستجابة.
- [الأسئلة الشائعة](https://docs.ollama.com/faq) توثق ربط الاسترجاع الداخلي وموضع المعالج وتعطيل السحابة وفحص السجل.
- [صفحة Gemma 4 E2B](https://ollama.com/library/gemma4:e2b) تقدم الوسم الدقيق الحالي والحجم ومواد الترخيص لفحصها قبل التنزيل.

## Sources

- [البدء السريع في Ollama](https://docs.ollama.com/quickstart) — مدخل التثبيت الرسمي ومثال gemma4:e2b المحلي، بما فيه pull وrun و/bye وطلب API وتوصية الذاكرة. لا يثبت ملاءمة عتاد القارئ أو نتيجته الفعلية.
- [مرجع CLI في Ollama](https://docs.ollama.com/cli) — أوامر pull وrun وls وps وstop وrm وserve الحالية. لم تُنفذ أوامر طرفية لهذا المقال.
- [مقدمة API في Ollama](https://docs.ollama.com/api/introduction) — تميز عناوين الأساس localhost والسحابة المباشرة والوصول المحلي بلا مفتاح. الخوادم المحلية تستطيع الوصول إلى نماذج السحابة حين تكون مفعلة.
- [نقطة نهاية دردشة Ollama](https://docs.ollama.com/api/chat) — تحدد طلب model/messages والتدفق الافتراضي وstream:false وحقول model وdone وmessage.content الكاملة. لا تثبت استجابة القارئ.
- [الأسئلة الشائعة في Ollama](https://docs.ollama.com/faq) — توثق ربط الاسترجاع الداخلي الافتراضي وموضع المعالج وتعطيل السحابة وإعادة التشغيل ومؤشر السجل. لتطبيقات العملاء الأخرى مسارات بيانات منفصلة.
- [صفحة Ollama Gemma 4 E2B](https://ollama.com/library/gemma4:e2b) — تقدم وسم المثال الدقيق والملفات ومواد الترخيص الحالية. يجب فحص الحجم الفعلي والحقوق وسعة الجهاز قبل التنزيل.
- [تثبيت Ollama على Windows](https://docs.ollama.com/windows) — تثبيت المنصة وسلوك CLI والخادم الخلفي وموقع سجل الخادم؛ لا يثبت الإصدار المثبت لدى القارئ.
- [تثبيت Ollama على macOS](https://docs.ollama.com/macos) — تثبيت المنصة وسلوك التطبيق وCLI وموقع سجل الخادم؛ لا يثبت الإصدار المثبت لدى القارئ.
- [تثبيت Ollama على Linux](https://docs.ollama.com/linux) — تثبيت المنصة والتشغيل اليدوي أو كخدمة وتعليمات اليومية؛ يجب اتباع التهيئة الفعلية لدى القارئ.