Windows (WSL)

ใช้ Matrix บน Windows ผ่าน WSL ให้ลื่นที่สุด

แม้ว่า Matrix จะรันบน Windows ได้โดยตรง แต่เราแนะนำให้ใช้ Windows Subsystem for Linux (WSL) เพื่อประสบการณ์ที่ดีที่สุด WSL ให้สภาพแวดล้อม Linux ที่ทำงานร่วมกับฟีเจอร์ของ Matrix ได้อย่างราบรื่น

การตั้งค่า

ติดตั้ง WSL

ถ้ายังไม่ได้ติดตั้ง ให้ทำตามคู่มือทางการของ Microsoft เพื่อ ติดตั้ง WSL
ติดตั้ง 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 Desktop แต่ให้เซิร์ฟเวอร์ทำงานบน WSL:

เริ่มเซิร์ฟเวอร์ใน WSL โดยใช้ --hostname 0.0.0.0 เพื่อให้เชื่อมต่อจากภายนอกได้:
Terminal window
```
matrix serve --hostname 0.0.0.0 --port 4096
```
เชื่อมต่อเดสก์ท็อปแอป ไปที่ http://localhost:4096

เมื่อใช้ --hostname 0.0.0.0 ให้ตั้งค่า MATRIX_SERVER_PASSWORD เพื่อป้องกันเซิร์ฟเวอร์

MATRIX_SERVER_PASSWORD=your-password matrix serve --hostname 0.0.0.0

เว็บไคลเอนต์ + WSL

เพื่อประสบการณ์เว็บที่ดีที่สุดบน Windows:

รัน matrix web ใน terminal WSL แทน PowerShell:
Terminal window
```
matrix web --hostname 0.0.0.0
```
เข้าจากเบราว์เซอร์บน Windows ที่ http://localhost:<port> (Matrix จะแสดง URL ให้)

การรัน matrix web จาก WSL ช่วยให้เข้าถึงระบบไฟล์และใช้งาน terminal ได้ถูกต้อง พร้อมเปิดใช้งานผ่านเบราว์เซอร์ Windows ได้เหมือนเดิม

การเข้าถึงไฟล์ Windows

WSL สามารถเข้าถึงไฟล์ Windows ทั้งหมดของคุณได้ผ่านไดเรกทอรี /mnt/:

C: drive → /mnt/c/
D: drive → /mnt/d/
ไดรฟ์อื่นก็ใช้รูปแบบเดียวกัน

ตัวอย่าง:

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

เคล็ดลับ

แม้โปรเจกต์จะอยู่บนไดรฟ์ Windows ก็ควรรัน Matrix ใน WSL เพื่อการเข้าถึงไฟล์ที่ลื่นกว่า
ใช้ Matrix ควบคู่กับ WSL extension ของ VS Code เพื่อเวิร์กโฟลว์ที่ต่อเนื่อง
การตั้งค่าและเซสชันของ Matrix จะถูกเก็บในสภาพแวดล้อม WSL ที่ ~/.local/share/matrix/