WSL على ويندوز

هناك طريقتان لاستخدام WSL على ويندوز: الخفيفة تضيف صدفة WSL كملف طرفية، والكاملة تثبّت vterm-server داخل WSL. الأولى تعطيك صدفة فقط؛ والثانية تفتح إدارة الملفات ولوحة Git وMCP وكل ما عدا ذلك.

الطريقة الخفيفة: ملف طرفية WSL

على ويندوز، تُحمَّل ملفات طرفية WSL تلقائيًا: عند الإقلاع يكتشف الخادم wsl.exe ويعدّد التوزيعات المثبتة، مضيفًا مدخل ملف لكل توزيعة إلى القائمة (مثل Ubuntu (WSL)؛ ويظهر مدخل عام WSL عند عدم وجود توزيعات).

لاستخدام أحدها، اختر ببساطة مدخل WSL في قائمة الملفات بشريط عنوان العميل — تُقلع التوزيعة وتضعك مباشرة في طرفيتها، كفتح طرفية محلية.

القيد: تعمل هذه الجلسات على الخادم بجانب ويندوز — مستكشف الملفات ولوحة Git ومتغيرات البيئة وأشباهها في العميل لا تعمل (تعمل بمنطق نظام ملفات ويندوز ولا ترى نظام ملفات لينكس داخل WSL).

الطريقة الكاملة: تثبيت vterm-server داخل WSL

تعامل مع WSL كجهاز لينكس قائم بذاته وثبّت vterm-server بلا واجهة. يقدم الموقع سكربتًا من سطر واحد — الصقه في طرفية WSL:

curl -fsSL https://vterminal.dev/install.sh | bash

يقوم السكربت تلقائيًا بـ:

1. اكتشاف بيئة WSL/بلا شاشة وتنزيل vterm-server بلا واجهة إلى ~/.local/vterm;
2. تثبيت خدمة مستخدم systemd وبدئها فورًا — تعمل عند كل تسجيل دخول (بما فيه بدء WSL)، دون حاجة لبدء يدوي;
3. إضافة ~/.local/vterm إلى PATH.

عندما تكون systemd معطلة في WSL، يشير السكربت إلى إضافة [boot] systemd=true في /etc/wsl.conf، وتشغيل wsl --shutdown على جانب ويندوز، وإعادة تشغيل المثبّت.

فتح صفحة الإعداد

داخل WSL:

vterm-server --open

يطبع الأمر عنوان واجهة الويب (http://localhost:<config-port>/) ويحاول إطلاق متصفح (في WSL عبر wslview، متصفح ويندوز الافتراضي). بفضل إعادة توجيه localhost في WSL2، فتح العنوان نفسه في متصفح ويندوز يعمل بالسهولة ذاتها. أثناء عمل الخادم يحمل العنوان المطبوع رمز دخول للاستخدام مرة واحدة (?ticket=...، يُصدر عبر مقبس محلي) فتُفتح الصفحة وقد تم تسجيل الدخول.

(اختياري) مشاركة خادم WSL في مرحّل المضيف

إذا كان جهاز ويندوز يشغّل vterm-server أيضًا (كمرحّل)، يمكن لخادم WSL أن يتصل تحته ليرى العميل «الجهازين» عبر اتصال محلي واحد:

1. في واجهة ويب خادم ويندوز، اضغط رمز QR لنسخ سلسلة المشاركة;
2. افتح واجهة ويب خادم WSL (العنوان من القسم السابق)، اضغط زر اللصق الظاهر بجانب حقل Relay Address لتعبئة العنوان والمفتاح تلقائيًا، ثم Apply;
3. ما دام vterm-server لويندوز يعمل، يرى العميل طرفيات خادم WSL وملفاته وGit تحت المرحّل المحلي.

تحت شبكة NAT الافتراضية لـ WSL2، يصل WSL مضيف ويندوز عبر عنوان المضيف كما يُرى من جانب WSL (البوابة الافتراضية — nameserver في cat /etc/resolv.conf)؛ وبالشبكة المتطابقة يعمل localhost. انظر فصل المرحّل لتفاصيله.