การตั้งค่า WSL

ก่อนใช้ WSL Dashboard ระบบ Windows ของคุณต้องเปิดใช้งานและกำหนดค่าสภาพแวดล้อม WSL 2 อย่างถูกต้อง เอกสารนี้แบ่งออกเป็นสามส่วนหลัก:

1. เปิดใช้งานและกำหนดค่า WSL: ทำการติดตั้งและกำหนดค่าพื้นฐานของ WSL 2 ให้เสร็จสมบูรณ์
2. คำสั่งที่ใช้ได้ไม่เท่ากับการติดตั้งสำเร็จ: อธิบายว่าการที่คำสั่ง wsl รันได้ไม่ได้หมายความว่าสามารถติดตั้ง Linux ได้สำเร็จ
3. การตรวจสอบการติดตั้งที่ล้มเหลว: วิธีการตรวจสอบและแก้ไขเมื่อการติดตั้งยังล้มเหลวหลังจากการกำหนดค่าเสร็จสมบูรณ์

1. เปิดใช้งานและกำหนดค่า WSL

บทนี้จะแนะนำให้คุณทำการตั้งค่าพื้นฐานที่จำเป็นให้เสร็จสมบูรณ์ หลังจากจบบทนี้แล้ว โปรดอ่าน บทที่ 2 เพื่อทำความเข้าใจความแตกต่างระหว่างคำสั่งที่ใช้ได้กับการติดตั้งสำเร็จ หากการติดตั้งยังมีปัญหา โปรดดู บทที่ 3

1.1 ตรวจสอบข้อกำหนดของระบบ

WSL 2 มีข้อกำหนดขั้นต่ำของเวอร์ชัน Windows กด Win + R พิมพ์ winver เพื่อตรวจสอบเวอร์ชันของคุณ:

• Windows 10: เวอร์ชัน 1903 ขึ้นไป โดยมี Build 18362 ขึ้นไป
• Windows 11: ทุกเวอร์ชันรองรับ

IMPORTANT

หากเวอร์ชันของคุณต่ำเกินไป โปรดอัปเกรดระบบของคุณผ่าน "Windows Update" ก่อน

1.2 เปิดใช้งานการจำลองเสมือนของฮาร์ดแวร์

WSL 2 ทำงานบนเทคโนโลยีการจำลองเสมือน ดังนั้นต้องเปิดใช้งาน เทคโนโลยีการจำลองเสมือน (Virtualization Technology) ใน BIOS/UEFI ของเมนบอร์ด

• วิธีตรวจสอบ: เปิด "ตัวจัดการงาน" -> แท็บ "ประสิทธิภาพ" -> "CPU"
• ดูสถานะ: ยืนยันว่าสถานะ "การจำลองเสมือน" ที่มุมขวาล่างแสดง "เปิดใช้งานแล้ว"
• วิธีเปิดใช้งาน: หากยังไม่ได้เปิดใช้งาน คุณต้องรีสตาร์ทคอมพิวเตอร์เพื่อเข้าสู่การตั้งค่า BIOS/UEFI หาตัวเลือกคล้าย Intel VT-x หรือ AMD-V แล้วตั้งค่าเป็น Enabled

1.3 เปิดใช้งานคุณสมบัติ Windows ที่เกี่ยวข้อง

คุณต้องเปิดใช้งานคุณสมบัติ "ระบบย่อย Windows สำหรับ Linux" และ "แพลตฟอร์มเครื่องเสมือน" ของ Windows

วิธี A: ผ่านอินเทอร์เฟซกราฟิก (แนะนำ)

1. กด Win + S ค้นหาและเปิด "เปิดหรือปิดคุณสมบัติ Windows"
2. ทำเครื่องหมายสองรายการต่อไปนี้:
   • ระบบย่อย Windows สำหรับ Linux (Windows Subsystem for Linux)
   • แพลตฟอร์มเครื่องเสมือน (Virtual Machine Platform)
3. คลิก "ตกลง" และ รีสตาร์ทคอมพิวเตอร์ เมื่อได้รับพร้อมท์

วิธี B: ผ่านบรรทัดคำสั่ง (สิทธิ์ผู้ดูแลระบบ)

รัน PowerShell ในฐานะผู้ดูแลระบบและดำเนินการคำสั่งต่อไปนี้:

# เปิดใช้งาน WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# เปิดใช้งานแพลตฟอร์มเครื่องเสมือน
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

หลังจากดำเนินการเสร็จ โปรด รีสตาร์ทคอมพิวเตอร์ ด้วยตนเอง

1.4 ติดตั้ง / อัปเดตเคอร์เนล WSL

Windows เวอร์ชันใหม่สามารถรับการอัปเดต WSL ผ่าน Microsoft Store

• ที่อยู่ดาวน์โหลด: Microsoft Store - Windows Subsystem for Linux
• ดาวน์โหลดด้วยตนเอง: หากไม่สามารถใช้ Store ได้ คุณสามารถดาวน์โหลดแพ็กเกจติดตั้ง .msixbundle หรือ .msi ล่าสุดจาก WSL GitHub Releases เพื่อติดตั้งแบบออฟไลน์

1.5 ตั้งค่า WSL 2 เป็นเวอร์ชันเริ่มต้น

เพื่อให้แน่ใจว่าดิสทริบิวชันที่ติดตั้งใหม่ใช้ WSL 2 โดยค่าเริ่มต้น ให้รันในเทอร์มินัล:

wsl --set-default-version 2

1.6 คำถามที่พบบ่อย

• ข้อผิดพลาด 0x80370102: มักเกิดจากการจำลองเสมือนไม่ได้เปิดใช้งานใน BIOS หรือมีความขัดแย้งกับ Hyper-V
• การสลับระหว่าง WSL 1 และ WSL 2: คุณสามารถใช้ wsl --set-version <ชื่อดิสทริบิวชัน> 2 เพื่ออัปเกรด instance WSL 1 ที่มีอยู่เป็น WSL 2

2. คำสั่งที่ใช้ได้ไม่เท่ากับการติดตั้งสำเร็จ

คำสั่งเช่น wsl --version, wsl -l -v รันได้ปกติ ไม่ได้หมายความว่ามีเงื่อนไขพร้อมสำหรับการติดตั้ง Linux ทั้งสองอย่างอยู่ในขั้นตอนที่แตกต่างกัน ไม่สามารถเทียบเท่ากันได้

คำสั่งที่ใช้ได้ เพียงหมายความว่า:

• ✅ ส่วนประกอบ WSL ใน Windows เปิดใช้งาน/ติดตั้งแล้ว
• ✅ เครื่องมือบรรทัดคำสั่ง wsl.exe ใช้งานได้
• ✅ ระบบรู้จักคำสั่งที่เกี่ยวข้องกับ WSL

แต่การติดตั้งดิสทริบิวชัน Linux ให้สำเร็จ ยังต้องมีเงื่อนไขเพิ่มเติม จุดที่มักติดขัด:

1. การจำลองเสมือนถูกปิด: ไม่ได้เปิดใช้งาน VT-x / AMD-V ใน BIOS/UEFI WSL 2 ไม่สามารถเริ่มต้นได้ หรือรายงานข้อผิดพลาดการจำลองเสมือนเมื่อติดตั้งดิสทริบิวชัน (ดูวิธีตรวจสอบที่ 1.2 เปิดใช้งานการจำลองเสมือนของฮาร์ดแวร์)
2. เวอร์ชัน/Build ของ Windows ต่ำเกินไป: WSL 2 มีข้อกำหนดด้านเคอร์เนลและเวอร์ชัน รุ่น Home และอิมเมจองค์กรเก่าอาจมีคุณสมบัติไม่ครบ (ดูวิธีตรวจสอบที่ 1.1 ตรวจสอบข้อกำหนดของระบบ)
3. ยังไม่ได้ติดตั้งดิสทริบิวชัน Linux จริง ๆ: wsl -l -v แสดงเฉพาะดิสทริบิวชันที่ ติดตั้งแล้ว เท่านั้น หากยังไม่ได้ติดตั้งอะไร รายการก็จะว่างเปล่า ไม่ได้หมายความว่าสามารถรัน Ubuntu ได้โดยตรง
4. ปัญหาเครือข่าย / Microsoft Store: wsl --install -d <ดิสทริบิวชัน> ต้องดึงอิมเมจจาก Store หรือเครือข่าย เครือข่ายบริษัท พร็อกซี ไฟร์วอลล์ อาจบล็อกได้ทั้งหมด
5. สิทธิ์ไม่เพียงพอ: การติดตั้งดิสทริบิวชันหรือแก้ไขการตั้งค่า WSL ต้องใช้สิทธิ์ผู้ดูแลระบบ

TIP

พูดง่าย ๆ คือ: คำสั่ง WSL ใช้ได้ ≠ Linux พร้อมใช้งาน แค่ได้ "บัตรผ่านเข้าประตู" ยังไม่ได้ติดตั้งระบบจริง ๆ

3. การตรวจสอบการติดตั้งที่ล้มเหลว

หลังจากกำหนดค่าเสร็จตาม บทที่ 1 (หรือคุณคิดว่ากำหนดค่าเสร็จแล้ว) หากรัน wsl --install ยังล้มเหลว โปรดตรวจสอบตามลำดับต่อไปนี้

3.1 ทำ "การตรวจสอบด้วยคลิกเดียว" ก่อน

รัน PowerShell ในฐานะ ผู้ดูแลระบบ แล้วดำเนินการตามลำดับ:

wsl --install --no-distribution
wsl --set-default-version 2

• ✅ หากคำสั่งทั้งสองนี้รันได้เรียบร้อย แสดงว่าส่วนประกอบเสริมของ WSL เปิดใช้งานแล้ว และเงื่อนไขการจำลองเสมือนเป็นที่พอใจโดยพื้นฐาน
• ❌ หากล้มเหลว จะระบุโดยตรงว่าขาดอะไร (เช่น แพลตฟอร์มเครื่องเสมือน Hyper-V การจำลองเสมือน BIOS เป็นต้น)

จากนั้นรัน systeminfo และยืนยันว่าในผลลัพธ์มี Virtualization Enabled In Firmware: Yes หากไม่มีข้อผิดพลาดข้างต้น ก็สามารถรัน wsl --install เพื่อติดตั้งดิสทริบิวชันได้อย่างสบายใจ

NOTE

ไม่มีคำสั่งใดรับประกัน 100% ว่า wsl --install จะสำเร็จ แต่การตรวจสอบข้างต้นยืนยันได้ว่าเงื่อนไขการติดตั้งพร้อมหรือยัง

3.2 รายการตรวจสอบด้วยตนเอง

หาก "การตรวจสอบด้วยคลิกเดียว" ยังหาปัญหาไม่พบ ให้ตรวจสอบทีละรายการ:

1. ตรวจสอบว่าเปิดใช้งานการจำลองเสมือน BIOS/เฟิร์มแวร์แล้วหรือยัง: ใน PowerShell ผู้ดูแลระบบรัน systeminfo ผลลัพธ์ต้องเห็น Virtualization Enabled In Firmware: Yes
2. ตรวจสอบว่าเปิดใช้งานคุณสมบัติ Windows แล้วหรือยัง:

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
   Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   สถานะของทั้งสองคำสั่งต้องเป็น Enabled
3. ตรวจสอบว่า WSL ใช้งานได้หรือไม่: รัน wsl --version ควรมีผลลัพธ์ปกติ หากแจ้งว่าไม่พบคำสั่ง แสดงว่ายังไม่ได้ติดตั้งส่วนประกอบ WSL โปรดกลับไปที่ บทที่ 1
4. ตรวจสอบว่าสามารถใช้ WSL 2 ได้หรือไม่ (เคอร์เนลและแพลตฟอร์มเครื่องเสมือน): รัน wsl --set-default-version 2 ควรคืนค่าสำเร็จ สาเหตุความล้มเหลวที่พบบ่อย: ยังไม่ได้เปิดใช้งานแพลตฟอร์มเครื่องเสมือน หรือยังไม่ได้เปิดใช้งาน VT-x / AMD-V ใน BIOS

3.3 คู่มือค้นหาสาเหตุความล้มเหลวที่พบบ่อย

สถานการณ์	คำอธิบาย	วิธีจัดการ
ยังไม่ได้เปิดใช้งานการจำลองเสมือนใน BIOS	ล้มเหลวแน่นอน	รีสตาร์ทเข้า BIOS เปิดใช้งาน VT-x / AMD-V (ดู 1.2)
Windows 10 ต่ำกว่า 19041	ไม่รองรับ wsl --install	อัปเกรดระบบ (ดู 1.1)
สภาพแวดล้อมองค์กรปิดใช้งาน Hyper-V / การจำลองเสมือน	อาจล้มเหลว	ติดต่อผู้ดูแลระบบ
ระบบรุ่น Home เก่า	ต้องติดตั้งด้วยตนเอง	ติดตั้งเคอร์เนล WSL ด้วยตนเองตาม 1.4

3.4 ข้อผิดพลาด 0xc03a0014: หาผู้ให้บริการดิสก์เสมือนไม่พบ

ข้อความข้อผิดพลาดคือ Cannot find a virtual disk support provider for the specified file นี่ไม่ใช่ปัญหาของดิสทริบิวชัน Linux เอง แต่เป็น สแตกดิสก์เสมือน VHD/VHDX ของ Windows ทำงานไม่ปกติ WSL 2 ล้มเหลวเมื่อลงทะเบียนดิสทริบิวชัน สร้าง/เมานต์ ext4.vhdx

ทำการตรวจสอบขั้นต่ำก่อน: รัน PowerShell ในฐานะผู้ดูแลระบบ แล้วทดสอบ New-VHD (เช่น New-VHD -Path C:\test.vhdx -SizeBytes 1GB) หากคำสั่งนี้รายงานข้อผิดพลาดเดียวกัน ปัญหาอยู่ที่ฝั่ง Windows 100% ไม่เกี่ยวกับดิสทริบิวชัน

ตรวจสอบและแก้ไขตามลำดับต่อไปนี้:

1. บริการ Virtual Disk ไม่ทำงาน: เปิด services.msc หาบริการ Virtual Disk ตั้งค่าประเภทการเริ่มต้นเป็น "อัตโนมัติ" แล้วเริ่มต้นบริการ

2. คุณสมบัติ WSL / แพลตฟอร์มเครื่องเสมือนยังไม่ได้เปิดใช้งาน (หรือยังไม่เริ่มมีผล): รันคำสั่งใน 1.3 เปิดใช้งานคุณสมบัติ Windows ที่เกี่ยวข้อง อีกครั้ง จากนั้นต้องรีสตาร์ท Windows รุ่น Home ไม่มี Hyper-V ครบถ้วน แต่ WSL 2 ต้องการแค่แพลตฟอร์มเครื่องเสมือน ไม่ใช่อินเทอร์เฟซการจัดการ Hyper-V

3. ไดรเวอร์/อุปกรณ์ดิสก์เสมือนหายไป: เปิดตัวจัดการอุปกรณ์ ตรวจสอบใน "อุปกรณ์ระบบ / ตัวควบคุมการจัดเก็บข้อมูล" ว่ามี:

   • Microsoft Virtual Disk Provider
   • Microsoft Virtual Drive Enumerator
   • Microsoft VHD Loopback Controller

   หากขาดหายไป สามารถเพิ่มด้วยตนเองผ่าน hdwwiz.exe (ตัวควบคุมการจัดเก็บข้อมูล → Microsoft → Microsoft VHD Loopback Controller) และยืนยันว่าบริการ FsDepends ไม่ถูกปิดใช้งาน

4. อิมเมจที่นำเข้าไม่ตรงตามข้อกำหนด WSL: เมื่อใช้ wsl --import --vhd VHDX ต้องเป็นระบบไฟล์ ext4 ไม่สามารถเป็นดิสก์เข้ารหัส LUKS raw.img ทั่วไป Live ISO หรือดิสก์เปล่าที่ฟอร์แมต NTFS/FAT .img / .qcow2 / .iso ไม่สามารถ wsl --import --vhd โดยตรง

5. ปัญหาเส้นทาง/สิทธิ์/ระบบไฟล์: ไดเรกทอรีเป้าหมายต้องอยู่บนดิสก์ NTFS (FAT32/exFAT ไม่ได้) หลีกเลี่ยงอักษรจีน ช่องว่าง และสัญลักษณ์พิเศษในเส้นทาง อย่านำเข้าจากไดรฟ์เครือข่าย OneDrive หรือโฟลเดอร์บีบอัด ต้องใช้ PowerShell ผู้ดูแลระบบจริง (ไม่ใช่เทอร์มินัลทั่วไป)

6. ส่วนประกอบระบบเสียหาย: รัน DISM และ SFC ตามลำดับเพื่อซ่อมแซมส่วนประกอบระบบ จากนั้นลองอีกครั้ง:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   sfc /scannow

TIP

เครื่องเสมือนของบริษัทอื่น (VirtualBox, VMware) หรือฟีเจอร์แซนด์บ็อกซ์/การเสริมความแข็งแกร่งของซอฟต์แวร์ความปลอดภัย (เช่น 360, Huorong) อาจรบกวนการทำงานของดิสก์เสมือน เมื่อตรวจสอบสามารถปิดชั่วคราวแล้วลองใหม่