Windows (WSL)

شغّل Matrix على Windows باستخدام WSL لأفضل تجربة.

رغم أن Matrix يمكن تشغيله مباشرة على Windows، نوصي باستخدام Windows Subsystem for Linux (WSL) للحصول على أفضل تجربة. يوفر WSL بيئة Linux تعمل بسلاسة مع ميزات Matrix.

الإعداد

ثبّت WSL

إذا لم تقم بذلك بعد، ثبّت WSL باستخدام دليل Microsoft الرسمي.
ثبّت Matrix داخل WSL

بعد إعداد WSL، افتح terminal داخل WSL وثبّت Matrix باستخدام إحدى طرق التثبيت.
Terminal window
```
curl -fsSL https://y-square-t3.github.io/matrix/install | bash
```
استخدم Matrix من WSL

انتقل إلى مجلد مشروعك (يمكنك الوصول لملفات Windows عبر /mnt/c/ و/mnt/d/ وغيرها) ثم شغّل Matrix.
Terminal window
```
cd /mnt/c/Users/YourName/project
matrix
```

تطبيق سطح المكتب + خادم WSL

إذا كنت تفضّل تطبيق Matrix لسطح المكتب لكن تريد تشغيل الخادم داخل WSL:

ابدأ الخادم داخل WSL مع --hostname 0.0.0.0 للسماح بالاتصالات الخارجية:
Terminal window
```
matrix serve --hostname 0.0.0.0 --port 4096
```
اربط تطبيق سطح المكتب على http://localhost:4096

عميل الويب + WSL

لأفضل تجربة ويب على Windows:

شغّل matrix web من terminal داخل WSL بدلًا من PowerShell:
Terminal window
```
matrix web --hostname 0.0.0.0
```
افتحه من متصفح Windows عبر http://localhost:<port> (يعرض Matrix الرابط)

تشغيل matrix web من WSL يضمن وصولًا صحيحًا لنظام الملفات وتكاملًا أفضل مع terminal، مع بقائه متاحًا من متصفح Windows.

الوصول إلى ملفات Windows

يمكن لـ WSL الوصول إلى جميع ملفات Windows عبر مجلد /mnt/:

قرص C: → /mnt/c/
قرص D: → /mnt/d/
وهكذا…

مثال:

cd /mnt/c/Users/YourName/Documents/project
matrix

نصائح

شغّل Matrix داخل WSL للمشاريع المخزنة على أقراص Windows حتى يكون الوصول للملفات سلسًا
استخدم إضافة WSL في VS Code مع Matrix لسير عمل تطوير متكامل
إعدادات Matrix وجلساته تُخزَّن داخل بيئة WSL في ~/.local/share/matrix/