🎁 تثبيت حزمة الذكاء الاصطناعي — ChatGPT خاص مع بحث ويب
انشر حزمة ذكاء اصطناعي ذاتية الاستضافة على Ubuntu بـ Docker — Ollama وOpen WebUI وSearXNG وLiteLLM، مُوصَّلة مسبقاً في ChatGPT خاص ببحث ويب وواجهة برمجة متوافقة مع OpenAI، مع نموذج بداية يُسحب تلقائياً.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/stacks/ai-stack/ai-stack-ubuntu.sh
chmod +x ai-stack-ubuntu.sh
./ai-stack-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/stacks/ai-stack/ai-stack-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x ai-stack-ubuntu.sh
3 تشغيل المثبّت
./ai-stack-ubuntu.sh
4 فتح Open WebUI وإنشاء حسابك
http://your-server-ip:3210
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3210 | Open WebUI — the ChatGPT-style chat interface (from container 8080) |
| 11434 | Ollama — local model API (no auth; keep internal) |
| 8081 | SearXNG — private web search (from container 8080) |
| 4001 | LiteLLM — OpenAI-compatible API at /v1 (from container 4000) |
نظرة عامة
حزمة الذكاء الاصطناعي مثبّت آلي واحد ينشر أربعة مشاريع مفتوحة المصدر معاً، مُوصَّلة مسبقاً في إعداد ذكاء اصطناعي خاص واحد جاهز للعمل: Ollama لتشغيل نماذج لغوية مفتوحة الأوزان محلياً، وOpen WebUI كواجهة محادثة بأسلوب ChatGPT، وSearXNG كمحرك بحث تجميعي خاص لإجابات مدعومة بالويب، وLiteLLM كوكيل واجهة برمجة متوافق مع OpenAI أمام النماذج المحلية. بدلاً من ربط هذه الخدمات الأربع يدوياً بنفسك — إعداد مخرجات SearXNG بصيغة JSON، وتوصيل إعدادات بحث الويب في Open WebUI، وإعداد بوابة متوافقة مع API — يقوم المثبّت بكل ذلك في تمريرة واحدة ويسحب نموذجاً صغيراً للبداية تلقائياً بحيث يجيب المساعد فوراً بعد الإعداد.
لماذا تستخدمه
تشغيل مساعد خاص شبيه بـ ChatGPT يعني عادة تجميع بيئة تشغيل نموذج وواجهة محادثة وخلفية بحث وطبقة API بنفسك، مع تصحيح مشاكل التكامل بين كل قطعة على طول الطريق. تختصر حزمة الذكاء الاصطناعي كل هذا في سكريبت واحد، وتمنحك استدلال نموذج محلي، وواجهة محادثة مصقولة متعددة المستخدمين، وإجابات مدعومة ببحث ويب حقيقي، ونقطة نهاية متوافقة مع OpenAI جاهزة لتطبيقاتك الخاصة — كل ذلك يعمل على جهازك الخاص دون تكاليف لكل رمز API، ودون خروج بيانات من شبكتك، ودون اعتماد على استمرار توفر OpenAI أو Anthropic أو Google أو بقاء أسعارها معقولة.
متى تحتاجه
- تريد مساعداً خاصاً ذاتي الاستضافة بأسلوب ChatGPT دون إرسال كل محادثة لواجهة برمجة طرف ثالث
- تريد أن يجيب روبوت المحادثة باستخدام نتائج ويب حالية بدلاً من الاقتصار على تاريخ تدريب النموذج
- تريد بناء تطبيقاتك الخاصة على واجهة برمجة متوافقة مع OpenAI لكن توجيه الطلبات لنماذج محلية بدلاً من الدفع لكل رمز
- تشغّل بالفعل سيرفر مختبر منزلي مزوداً بـ GPU وتريد استغلاله لاستدلال LLM محلي
- تريد تثبيتاً واحداً يتجنب الربط اليدوي بين بيئة تشغيل نموذج وواجهة محادثة ومحرك بحث ووكيل API
- تريد أن يشارك فريق صغير مساعد ذكاء اصطناعي خاص واحد بحسابات فردية بدلاً من اشتراك كل شخص باشتراك ChatGPT شخصي منفصل
من يحتاجه
- عشاق المختبر المنزلي والاستضافة الذاتية الذين يريدون إعداد ذكاء اصطناعي خاص يعمل دون أيام من العمل اليدوي للتكامل
- الأفراد والشركات الصغيرة المهتمة بالخصوصية الذين لا يريدون إرسال المحادثات أو المستندات لمزود ذكاء اصطناعي طرف ثالث
- المطورون الذين يريدون نقطة نهاية متوافقة مع OpenAI لبناء واختبار تطبيقات دون تحمّل تكاليف API
- الفرق الصغيرة التي تريد مساعد ذكاء اصطناعي داخلي مشترك بحسابات لكل مستخدم بدلاً من دفع الجميع لاشتراكات ChatGPT Plus منفصلة
- المستخدمون الذين يجرّبون نماذج مفتوحة الأوزان محلية ويريدون واجهة محادثة حقيقية وتأصيل بحث بدلاً من واجهة سطر أوامر عارية
- أي شخص يريد إبقاء بيانات حساسة أو خاصة بعيدة تماماً عن مزودي الذكاء الاصطناعي السحابيين
حالات الاستخدام الشائعة
- تشغيل مساعد محادثة خاص ذاتي الاستضافة للاستخدام الشخصي أو الجماعي دون تكاليف API لكل رسالة
- تأصيل إجابات روبوت المحادثة في نتائج بحث ويب حالية عبر خلفية بحث SearXNG المدمجة
- توجيه سكريبتاتك وتطبيقاتك الخاصة إلى نقطة نهاية LiteLLM المتوافقة مع OpenAI بدلاً من الدفع لاستخدام API الخاص بـ OpenAI
- تجريب نماذج مفتوحة الأوزان مختلفة بسحب نماذج Ollama إضافية أبعد من نموذج البداية المثبَّت تلقائياً
- إعطاء أعضاء الفريق حسابات Open WebUI فردية لمساعد داخلي مشترك دون كشف بنية النموذج التحتية مباشرة
- استخدام SearXNG بشكل مستقل كمحرك بحث خاص وخالٍ من الإعلانات ولا يتتبعك للتصفح العام، وليس فقط لاستعلامات روبوت المحادثة
الميزات الرئيسية
- أربع خدمات مُوصَّلة مسبقاً في تثبيت واحد: Ollama وOpen WebUI وSearXNG وLiteLLM
- نموذج بداية يُسحب تلقائياً (qwen2.5:0.5b، حوالي 400 ميغابايت) بحيث يعمل المساعد فوراً بعد التثبيت
- تأصيل بحث الويب مدمج في محادثة Open WebUI عبر نسخة SearXNG المرفقة مع تفعيل مخرجات JSON
- نقطة نهاية API متوافقة مع OpenAI عبر LiteLLM على /v1، قابلة للاستخدام كرابط أساسي جاهز لكود عميل OpenAI الموجود
- دعم متعدد المستخدمين في Open WebUI مع تحوّل الحساب الأول المُسجَّل إلى المشرف
- استدلال نموذج محلي بالكامل عبر Ollama — لا تخرج بيانات المحادثة من سيرفرك لأجل ردود المحادثة
- إمكانية إضافة أو تبديل نماذج Ollama بشكل مستقل عن نموذج البداية المثبَّت مسبقاً
- كل من الخدمات الأربع قابلة للاستخدام والوصول بشكل مستقل على منفذها الخاص للوصول المباشر لـ API أو البحث
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:3210 فوراً وسجّل حساب Open WebUI الأول — يصبح المشرف تلقائياً
- اسحب نماذج Ollama إضافية أو أكبر إذا كان جهازك يدعمها؛ نموذج البداية المثبَّت تلقائياً صغير عن قصد
- فعّل واختبر مفتاح بحث الويب في محادثة للتأكد أن تأصيل SearXNG يُعيد نتائج بشكل صحيح
- ولّد أو استرجع مفتاح API الخاص بـ LiteLLM واختبر نقطة النهاية المتوافقة مع OpenAI على http://your-server-ip:4001/v1 من كودك الخاص
- أنشئ حسابات Open WebUI إضافية لزملائك إذا كانت هذه نسخة مشتركة، وراجع صلاحيات المستخدم الافتراضية
- إذا كان لديك GPU، تأكد أن Ollama يستخدمه فعلياً — الاستدلال بالمعالج فقط أبطأ بشكل كبير لأي شيء أبعد من نموذج البداية الصغير
- أعدّ وكيلاً عكسياً بـ HTTPS إذا كنت تحتاج الوصول لـ Open WebUI أو واجهة LiteLLM من خارج شبكتك المحلية
- حدّث صور الخدمات الأربع دورياً للحصول على تحسينات بيئة تشغيل النموذج وإصلاحات الأمان
أفضل ممارسات الأمان
- أبقِ منفذ Ollama 11434 بعيداً تماماً عن الإنترنت العام — فليس له مصادقة مدمجة ويمنح وصولاً مباشراً للنموذج
- لا تكشف Open WebUI أو SearXNG أو LiteLLM مباشرة للإنترنت دون وكيل عكسي يوفر HTTPS، ويُفضّل تحكماً إضافياً بالوصول
- دوّر واحمِ مفتاح API الخاص بـ LiteLLM، فأي شخص يملكه يستطيع استهلاك موارد حوسبتك عبر نقطة النهاية المتوافقة مع OpenAI
- عطّل التسجيل الذاتي المفتوح في Open WebUI بمجرد إنشاء حسابات فريقك، حتى لا يستطيع زوار عشوائيون إنشاء حسابات على نسختك
- قيّد كشف SearXNG للعامة إذا كنت لا تريد تشغيل وكيل بحث مفتوح قد يكتشفه آخرون ويستخدمونه لحركة مرورهم الخاصة
- حافظ على تحديث صور Docker الأربع، فأدوات الذكاء الاصطناعي المحلي في هذا المجال تتطور بسرعة وتتضمن إصلاحات أمان متكررة
- إذا كشفت أي جزء من الحزمة خارجياً، ضعه خلف VPN مثل WireGuard بدلاً من الاعتماد على مصادقة مستوى التطبيق وحدها
- راجع قائمة مستخدمي Open WebUI دورياً إذا تُرك التسجيل الذاتي مفعّلاً، لرصد أي حسابات غير متوقعة
المنافذ وإعدادات جدار الحماية
تنشر حزمة الذكاء الاصطناعي أربعة منافذ: 3210 لـ Open WebUI (واجهة المحادثة، مُعيَّنة من منفذ الحاوية 8080)، و11434 لواجهة نموذج Ollama، و8081 لـ SearXNG (مُعيَّن أيضاً من منفذ الحاوية 8080)، و4001 لواجهة LiteLLM المتوافقة مع OpenAI (مُعيَّنة من منفذ الحاوية 4000). من بين هذه، منفذ Ollama 11434 هو الأكثر حساسية — ليس له طبقة مصادقة ويجب ألا يكون قابلاً للوصول من خارج سيرفرك أبداً. ضع Open WebUI وواجهة LiteLLM خلف وكيل عكسي بـ HTTPS إذا احتجت وصولاً عن بُعد، وأبقِ Ollama وSearXNG مقيَّدين على شبكتك المحلية أو قابلَين للوصول فقط عبر الخدمات الأخرى، وليس مباشرة.
النسخ الاحتياطي والصيانة
- انسخ حجم تخزين نماذج Ollama احتياطياً إذا سحبت نماذج أبعد من نموذج البداية الصغير المثبَّت تلقائياً — إعادة تنزيل نماذج كبيرة بعد فقدانها بطيئة
- انسخ حجم بيانات Open WebUI احتياطياً، الذي يحمل حسابات المستخدمين وسجل المحادثات والإعدادات
- انسخ إعداد LiteLLM وأي مفاتيح API مُولَّدة احتياطياً حتى لا تحتاج تطبيقات العميل لإعادة إعداد بعد الاستعادة
- انسخ docker-compose.yml وأي ملف .env احتياطياً حتى يمكن إعادة إنشاء توصيل الخدمات الأربع الدقيق على مضيف جديد
- احفظ النسخ الاحتياطية خارج سيرفر الذكاء الاصطناعي نفسه، خاصة إذا كان يحمل أيضاً GPU يجعله جهازاً باهظ الخسارة
- اختبر استعادة أحياناً: شغّل الحزمة من جديد، وتأكد أن سجل المحادثات والنماذج ومفاتيح API لا تزال تعمل كما هو متوقع
الأخطاء الشائعة
- كشف منفذ Ollama 11434 مباشرة للإنترنت، ما يمنح أي شخص يجده استخداماً مجانياً غير مصادَق عليه لحوسبتك
- ترك التسجيل الذاتي في Open WebUI مفعّلاً إلى أجل غير مسمى على نسخة قابلة للوصول من الإنترنت، ما يسمح لغرباء بإنشاء حسابات
- افتراض أن الاستدلال بالمعالج فقط سيكون سريعاً بما يكفي لنماذج أكبر — دون GPU، فقط النماذج الصغيرة مثل نموذج البداية المثبَّت تلقائياً تعمل بشكل معقول
- نسيان اختبار مفتاح بحث الويب بعد التثبيت، دون إدراك أن تأصيل SearXNG يحتاج تفعيلاً صريحاً لكل محادثة
- فقدان مفتاح API الخاص بـ LiteLLM دون تدويره، ما يترك كوداً قديماً للعميل موجَّهاً لمفتاح كان يجب إلغاؤه
- عدم مراقبة مساحة القرص مع سحب المزيد من نماذج Ollama — ملفات النماذج كبيرة وتتراكم بسرعة
استكشاف الأخطاء وإصلاحها
- Open WebUI لا يُحمَّل ← تأكد أن الحاوية تعمل وأنك تتصفح المنفذ 3210 على المضيف، وليس المنفذ الداخلي 8080 للحاوية
- ردود المحادثة بطيئة جداً ← تحقق ما إذا كان Ollama يستخدم الاستدلال بالمعالج فقط؛ تحقق من تمرير GPU إذا كان لديك، وفكّر في نموذج أصغر
- نتائج بحث الويب لا تظهر في المحادثة ← تأكد أن SearXNG يعمل على المنفذ 8081 وأن مفتاح بحث الويب مفعّل في إعدادات المحادثة
- استدعاءات API الخاصة بـ LiteLLM تفشل بخطأ مصادقة ← تحقق أنك تستخدم مفتاح API المُولَّد الصحيح والرابط الأساسي الصحيح (http://your-server:4001/v1)
- نموذج Ollama جديد لا يُسحب ← تحقق من مساحة القرص المتاحة، فالنماذج قد تكون عدة غيغابايتات لكل واحد
- Open WebUI لا يُظهر أي نماذج متاحة ← تأكد أن Ollama أنهى سحب نموذج البداية وأن رابط اتصال Open WebUI بـ Ollama مُعدّ بشكل صحيح
- SearXNG لا يُعيد أي نتائج ← تحقق أن صيغة مخرجات JSON مفعّلة في إعداداته، فتكامل Open WebUI يعتمد عليها
البدائل
يمكنك تشغيل كل مكوّن من هذه الحزمة بشكل منفصل وربطها بنفسك — Ollama وحده للنماذج المحلية، Open WebUI وحده كواجهة محادثة أمامية، LibreChat كواجهة محادثة بديلة بدعم مدمج لمزودين متعددين، أو Perplexica كمساعد بحث ذكاء اصطناعي مصمم خصيصاً بدلاً من واجهة محادثة عامة مع بحث اختياري. يقدّم LM Studio تجربة تطبيق واحد أبسط لتشغيل نماذج محلية بواجهة محادثة، لكنه تطبيق سطح مكتب وليس سيرفراً ذاتي الاستضافة متعدد المستخدمين. للفرق التي تريد بنية تحتية مُدارة بدلاً من الاستضافة الذاتية، توجد منصات ذكاء اصطناعي خاص تجارية لكنها تفرض رسوماً مستمرة وقد ترسل البيانات لبنية تحتية طرف ثالث. قيمة حزمة الذكاء الاصطناعي تحديداً هي وجود القطع الأربع مُتكاملة مسبقاً في تثبيت واحد بدلاً من تجميعها فردياً.
متى لا تستخدمه
إذا كنت تحتاج مساعدة ذكاء اصطناعي عرضية فقط ولا تمانع أن يرى مزودو السحابة محادثاتك، فاشتراك ChatGPT أو Claude المُستضاف أبسط بكثير من صيانة بنية تحتية لنموذج محلي، والنماذج التجارية الحالية عموماً تتفوق على ما تستطيع معظم الأجهزة ذاتية الاستضافة تشغيله. تجنّب هذه الحزمة إذا كان سيرفرك بلا GPU وتحتاج استجابات سريعة من نماذج أكبر وأكثر قدرة — الاستدلال بالمعالج فقط يجعل أي شيء أبعد من النماذج الصغيرة بطيئاً بشكل غير عملي. إذا كنت تريد قطعة واحدة فقط (واجهة محادثة فقط، أو استدلال نموذج محلي فقط، أو بحث خاص فقط)، فتثبيت ذلك المكوّن الواحد أبسط من تشغيل الخدمات الأربع التي تجمعها هذه الحزمة. للأحمال التي تحتاج ضمان وقت تشغيل وعقود دعم مؤسسي، منصة ذكاء اصطناعي مُدارة خيار أنسب من حزمة مختبر منزلي ذاتية الصيانة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي حزمة الذكاء الاصطناعي؟
إنها مثبّت واحد ينشر أربع خدمات — Ollama (يشغّل نماذج محلية) وOpen WebUI (واجهة بأسلوب ChatGPT) وSearXNG (بحث ويب خاص) وLiteLLM (وكيل API متوافق مع OpenAI) — موصولة معاً في مساعد خاص.
ما المنافذ التي تستخدمها وكيف أسجّل الدخول؟
Open WebUI (واجهة المحادثة) على المنفذ 3210 على المضيف، Ollama على 11434، SearXNG على 8081، وواجهة LiteLLM المتوافقة مع OpenAI على 4001. لا يوجد حساب افتراضي — أول شخص يسجّل في Open WebUI يصبح المشرف، لذا افعل ذلك فوراً.
كيف يعمل بحث الويب؟
SearXNG محرك بحث تجميعي خاص مُضمَّن في الحزمة ومُوصَّل مسبقاً بميزة بحث الويب في Open WebUI عبر متغيرات بيئة (مع تفعيل مخرجات JSON). فعّل مفتاح بحث الويب في محادثة وسيستعلم عن SearXNG للحصول على نتائج حالية بدلاً من الاعتماد فقط على بيانات تدريب النموذج.
لماذا يوجد نموذج بداية مسبقاً؟
يسحب المثبّت تلقائياً qwen2.5:0.5b (حوالي 400 ميغابايت) أثناء الإعداد بحيث يعمل المساعد فور انتهاء التثبيت، بدلاً من تركك مع قائمة نماذج فارغة عليك حلّها بنفسك. يمكنك سحب نماذج أكبر لاحقاً إذا كان جهازك يدعمها.
هل يمكن لتطبيقاتي الخاصة استخدامها مثل واجهة OpenAI؟
نعم — هذا ما يوفره LiteLLM. يكشف نقطة نهاية متوافقة مع OpenAI على http://your-server:4001/v1 بمفتاح API مُولَّد، بحيث يستطيع أي تطبيق أو مكتبة أو سكريبت مبني لواجهة OpenAI التوجه لسيرفرك بتغيير الرابط الأساسي والمفتاح فقط.