> هل يمكن تشغيل vLLM على ويندوز؟ نعم — عبر WSL2▋

93 632 نجمة على GitHub منذ فبراير 2023، وما زالت متطلبات التثبيت تُفتَح بسطر واحد: «OS: Linux. Python 3.10–3.13.» وبعدها بسطرين تأتي الملاحظة التي ترسل الجميع إلى البحث: «لا يدعم vLLM ويندوز أصلاً. لتشغيل vLLM على ويندوز، يمكنك استخدام نظام ويندوز الفرعي للينكس (WSL) مع توزيعة متوافقة، أو استخدام بعض ال forks التي يحتفظ بها المجتمع.» هذه الملاحظة هي المقال كله. الطريق المدعوم هو WSL2؛ أما الطريق الأصلي فهو fork واسمك على تقارير العلل. هذا المقال يسكن عنقود تشغيل نماذج LLM محليًاهل يشغّل vLLM صيغة GGUF.

كيف تشغّل vLLM على ويندوز؟

عبر WSL2 — وسريعًا يتوقف عن أن يبدو كويندوز.

• ويندوز 10/11 مع GPU من NVIDIA؟ AMD يسلك طريق ROCm-on-WSL والطريق أضيق — احسب ذلك
• wsl --install -d Ubuntu من PowerShell بصلاحيات المدير، ثم أعد التشغيل
• تعريف NVIDIA يُثبَّت على جهة ويندوز — لا شيء داخل WSL، فمعالج الرسوميات يمر عبره
• داخل أوبونتو: uv pip install vllm — مسار لينكس نفسه الوارد في الوثائق حرفيًا
• شغّل نموذجًا صغيرًا واطلب نقطة النهاية models للتأكيد — الأمر أدناه

WSL2 هو اعتراف رسمي من مايكروسوفت بأن أفضل ميزة في ويندوز هي لينكس. يأتي مع النظام، يُثبَّت بسطر واحد، وداخل أوبونتو تنطبق عليك أي تعليمات vLLM على الإنترنت دون تغيير:

# PowerShell (مدير) — ثم أعد التشغيل عندما يطلب:
wsl --install -d Ubuntu

# داخل أوبونتو — التثبيت اللينكسي المعتاد، لا خطوة خاصة بويندوز:
uv venv --python 3.12 && source .venv/bin/activate
uv pip install vllm --torch-backend=auto

# شغّل نموذجًا صغيرًا وأثبت أن معالج الرسوميات عبر:
vllm serve Qwen/Qwen3-0.6B --port 8000

تحقق: curl http://localhost:8000/v1/models من ويندوز — WSL2 يمرّر localhost ويعود نموذجك في JSON

التفصيل الذي يفوت الجميع: تعريف معالج الرسوميات يسكن جهة ويندوز. تصميم CUDA-on-WSL من NVIDIA يجعل المعالج يمر عبر تعريف ويندوز إلى أي توزيعة، فتثبّت التعريف مرة واحدة في ويندوز ولا تثبته أبدًا داخل أوبونتو. ثبّت تعريفًا داخل WSL رغم ذلك وستقضي مساء كاملًا في «إصلاح» منظومة لم تكن معطلة قط.

هل يمكنك تشغيل vLLM على ويندوز بدون WSL؟

فقط عبر fork مجتمعي — وضريبة الشوكة حقيقية: تستبدل المُثبِّت بمترجم.

الوثائق تسمّي المشهد بنفسها: «بعض ال forks التي يحتفظ بها المجتمع». قرأت سجلها جميعًا هذا الأسبوع:

• SystemPanic/vllm-windows — الحي. 663 نجمة، وآخر دفع في اليوم السابق لهذا المقال. حزم ويندوز أصلية، CUDA 13، دعم Blackwell، بل تعدد بطاقات عبر NCCL على ويندوز. مشروع جاد يفعل ما يرفضه النواة.
• devnen/vllm-windows — 28 نجمة، آخر دفع في مايو 2026. خمسة أشهر من الصمت في مشروع بهذه السرعة إعلان تقاعد.
• dexteri-ai/vllm-windows — غلاف بواجهة رسومية، أُنشئ في يناير 2026. انظر خلف الواجهة: يقود vLLM داخل WSL2 — الطريق الذي يدّعي تجاوزه.

حتى على ال fork السليم ستجمّع نوى CUDA بترقيعات MSVC، وتخسر FlashAttention-3، وتعيد الاختبار بعد كل إصدار من المنبع. هذه هي ضريبة الشوكة. ادفعها عندما تمنع سياسة الشركة WSL ويكون الخادم خارج النطاق — لا لأن التثبيت بسطر واحد بدا سهلًا أكثر من اللازم.

لماذا لا توجد نسخة ويندوز أصلية أصلًا؟

vLLM يجمّع نوى CUDA ويعتمد على NCCL — منظومة أدوات لا تكتمل إلا على لينكس. الوثائق تقولها صريحة: «vLLM لا يعمل اكتمالًا إلا على لينكس». المنفذ الأصلي يعني إعادة بناء النوى لـ MSVC — وهي بالضبط الصيانة التي اختار المشروع ألا يتحملها، وال forks تقيس حجم العمل بعدد الناجين.

هل يعمل vLLM على ويندوز مع نماذج GGUF؟

نعم — عبر WSL2، على GPU من NVIDIA أو AMD. صيغة GGUF في vLLM تعمل على معالج الرسوميات فقط، لذا يضيف ويندوز شرط النظام فوق شرط العتاد. على جهاز ويندوز بمعالج فقط، شغّل الملف نفسه في Ollama أو llama.cpp — وكلاهما أصلي.

قفلان، بالترتيب. قفل العتاد أولًا: هل يشغّل vLLM صيغة GGUF — نعم، عبر الإضافة الرسمية، على معالج الرسوميات فقط، ومعالجا x86 و Arm مرفوضان. ثم قفل النظام، وهذا المقال: مسار «رسوميات فقط» لا بد أن يعمل في مكان ما، وعلى ويندوز يكون ذلك المكان هو WSL2 مع CUDA عابرًا. القفلان يُفتحان معًا أو لا يُفتحان. لا GPU في الأفق؟ الملف يعمل رغم ذلك — تشغيل نماذج GGUF محليًا يغطي الأدوات الأصلية، واختيار الضغط في دليل الضغط لدينا.

vLLM على ويندوز — أم Ollama مباشرة؟

معظم أسئلة vLLM على ويندوز هي في الحقيقة أسئلة عن التزامن. vLLM وُجد ليخدم مستخدمين كثر من بطاقات رسوميات كبيرة عبر التجميع المستمر. إذا كان عدد المستخدمين «أنا، على مكتبي» فالجواب الصادق في الصف الأخير:

الطريق	vLLM؟	التثبيت	لمن
vLLM داخل WSL2	المحرك كاملًا	سطر واحد + إعادة تشغيل	خدمة فريق من بطاقة واحدة
fork SystemPanic الأصلي	شبه كامل، والاختبار عليك	تجميع ومطاردة CUDA	WSL ممنوع بسياسة العمل والبطاقة موجودة
vLLM على جهاز لينكس وويندوز عميلًا	المحرك كاملًا، في مكان آخر	أي عميل متوافق مع OpenAI	البطاقة تسكن غرفة أخرى أصلًا
Ollama، أصلي	لا — محرك آخر	مُثبِّت واحد	استخدام فردي، GGUF، منفذ 11434
llama.cpp، أصلي	لا — محرك آخر	ملفات تنفيذية لويندوز	مستخدم واحد، أوسع تغطية ضغط

جدول الدعم في الوثائق يقول: لينكس. وWSL2 يقول: حسنًا. وإذا كان السؤال من الخلف لم يكن عن vLLM قط — مجرد «شغّل نموذجًا على جهاز ويندوز الخاص بي» — فلم يكن هناك باب موصدان قط: Ollama يُثبَّت أصليًا، ويخدم على 127.0.0.1:11434، وإذا أبى أن يبدأ فـلك ذلك الفشل تشريح أيضًا لدينا.