لماذا تستضيف LocalAI ذاتيًا على خادم VPS
حيث يركّز Ollama على النص، يستهدف LocalAI توافقًا واسعًا مع واجهة OpenAI API: فهو يكشف /v1/chat/completions و/v1/embeddings و/v1/images/generations وحتى نسخ الصوت، على واجهة واحدة. بالنسبة إلى فريق لديه بالفعل شيفرة مكتوبة مقابل OpenAI SDK، يُعدّ LocalAI بديلاً شبه شفّاف: تغيّر عنوان URL الأساسي والمفتاح، والباقي يعمل. على خادم VPS، تحصل على هذا التنوّع دون اعتماد خارجي أو تكلفة لكل استدعاء. وهذا وثيق الصلة بشكل خاص عندما تحتاج في آنٍ واحد إلى توليد النصوص، والمتجهات لأغراض RAG، وأحيانًا الصور، دون تكثير المزوّدين والمفاتيح.
الفوائد الملموسة لاستضافة LocalAI ذاتيًا
- بديل مباشر لواجهة OpenAI API: لا إعادة كتابة لشيفرة العميل.
- واجهة واحدة للمحادثة والتضمينات والصور والصوت.
- دعم واجهات خلفية متعدّدة (llama.cpp وdiffusers وwhisper) ضمن واجهة موحّدة.
- صيغ نماذج مفتوحة (GGUF) قابلة للتنزيل والتبادل.
- لا فوترة حسب الاستخدام: تكلفة VPS ثابتة لجميع أنواع التوليد.
- بيانات ومخرجات محفوظة بالكامل على خادمك.
المتطلبات العتادية والبرمجية
بما أن LocalAI متعدّد الاستخدامات، فإن احتياجاته تعتمد على الوظائف المُفعَّلة. لمحادثة 7B وتضمينات على المعالج، استهدف 8 GB من RAM و4 vCPU. إذا فعّلت توليد الصور (Stable Diffusion) أو الصوت، يرتفع الحمل بشكل ملحوظ ويصبح خادم VPS مزوّد بوحدة معالجة رسومات موصى به بشدة. القرص نقطة أساسية: نماذج GGUF ونماذج الانتشار ثقيلة، خصّص 30 إلى 50 GB. Docker وDocker Compose مطلوبان، إضافةً إلى نطاق فرعي (مثل ia.your-domain.com) والمنفذ 443. جهّز قائمة النماذج المراد تحميلها حسب استخداماتك.
نشر LocalAI باستخدام Docker وHTTPS
تحضير مجلد النماذج
عبر SSH: mkdir -p /opt/localai/models && cd /opt/localai. سيُركَّب مجلد models هذا في الحاوية وسيحتوي على ملفات GGUF وتهيئات YAML الخاصة بك.
تشغيل حاوية LocalAI
استخدم الصورة الرسمية، على سبيل المثال docker run -d -p 127.0.0.1:8080:8080 -v $PWD/models:/models --name localai localai/localai. اختر الوسم المطابق لعتادك (CPU أو GPU).
تثبيت نموذج عبر المعرض
يوفّر LocalAI معرضًا: curl http://127.0.0.1:8080/models/apply -d '{"id":"..."}'، أو ضع يدويًا ملف GGUF في models/ مع ملف YAML الخاص بتهيئته. ثم اعرض القائمة عبر curl http://127.0.0.1:8080/v1/models.
اختبار التوافق مع OpenAI
تحقّق باستدعاء محادثة: curl http://127.0.0.1:8080/v1/chat/completions -d '{"model":"...","messages":[{"role":"user","content":"test"}]}'. اختبر أيضًا /v1/embeddings إذا كنت تخطّط لاستخدام RAG.
تهيئة الوكيل العكسي وشهادة SSL
وجّه ia.your-domain.com إلى localhost:8080 عبر Caddy أو Nginx، مع Let's Encrypt. أضف حماية بالرمز لأن LocalAI لا يفرض مفتاحًا افتراضيًا على نشر مجرّد.
ترحيل تطبيقاتك
في عملاء OpenAI لديك، غيّر عنوان URL الأساسي إلى https://ia.your-domain.com/v1 والمفتاح إلى رمزك. تنتقل استدعاءات المحادثة والتضمينات والصور إلى بنيتك التحتية.
فعّل فقط الواجهات الخلفية التي تحتاجها. تحميل نموذج محادثة ونموذج تضمين وStable Diffusion في آنٍ واحد على خادم VPS يعمل بالمعالج يُشبع ذاكرة RAM ويُنهار الأداء. عيّن SINGLE_ACTIVE_BACKEND=true للإبقاء على واجهة خلفية واحدة مقيمة في كل مرة، واحجز توليد الصور لخادم VPS مزوّد بوحدة معالجة رسومات إذا أصبح استخدامًا منتظمًا.
