Chuyện gì đang xảy ra
Bạn chạy wsl --install hoặc cố khởi động một bản phân phối Linux, và gặp phải:
WslRegisterDistribution failed with error: 0x80370102
Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.
Windows đang nói chính xác vấn đề là gì — nó không thể khởi động máy ảo vì ảo hóa phần cứng bị tắt trong BIOS, hoặc các thành phần Windows cần thiết chưa được bật. Hãy thực hiện theo từng bước dưới đây theo thứ tự. Hầu hết mọi người đều giải quyết xong trong vòng 15 phút.
Danh sách kiểm tra trước khi debug
- Bạn đang dùng Windows 10 (build 19041 trở lên) hoặc Windows 11
- CPU của bạn hỗ trợ ảo hóa (hầu hết CPU sản xuất sau năm 2010 đều hỗ trợ)
- Bạn có quyền admin
Bước 1 — Kiểm tra xem ảo hóa phần cứng có được bật không
Mở Task Manager → tab Performance → nhấp vào CPU. Tìm dòng Virtualization ở góc dưới bên phải. Nếu hiển thị Disabled, đó chính là nguyên nhân gốc rễ.
Bạn cần vào BIOS/UEFI và bật tính năng này. Tên cài đặt thay đổi tùy theo nhà sản xuất:
- CPU Intel: Intel VT-x, Intel Virtualization Technology, hoặc VT-x
- CPU AMD: AMD-V, SVM Mode, hoặc AMD Virtualization
Để vào BIOS: khởi động lại máy và nhấn Del, F2, hoặc F10 — phím đúng sẽ hiển thị thoáng qua trong quá trình POST. Sau khi vào, tìm trong mục Advanced, CPU Configuration, hoặc System Configuration. Bật cài đặt ảo hóa, lưu và thoát.
Quay lại Windows, mở Task Manager lần nữa. Virtualization giờ sẽ hiển thị Enabled.
Bước 2 — Bật các tính năng Windows cần thiết
WSL 2 cần hai tính năng Windows: Virtual Machine Platform và Windows Subsystem for Linux. Mở PowerShell với quyền Administrator và chạy:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Sau đó khởi động lại máy. Sau khi khởi động lại, đặt WSL 2 làm phiên bản mặc định:
wsl --set-default-version 2
Bước 3 — Đảm bảo Hyper-V đang chạy
Dù Hyper-V không thực sự bắt buộc với WSL 2, nhưng nền tảng hypervisor bên dưới nó thì có. Kiểm tra xem nó có đang hoạt động không:
bcdedit /enum | findstr hypervisorlaunchtype
Nếu kết quả hiển thị hypervisorlaunchtype Off, hãy bật lại:
bcdedit /set hypervisorlaunchtype auto
Khởi động lại máy sau khi thực hiện thay đổi này.
Bước 4 — Xung đột với phần mềm ảo hóa bên thứ ba
VMware Workstation, VirtualBox (ở chế độ cũ), và một số driver hypervisor của phần mềm diệt virus có thể chiếm dụng ảo hóa phần cứng hoàn toàn — khiến WSL 2 không thể sử dụng được.
VMware Workstation 15.5.5 trở lên hỗ trợ cùng tồn tại với Hyper-V. Nếu bạn đang dùng phiên bản cũ hơn, hãy cập nhật.
VirtualBox: các phiên bản trước 6.1 không thể cùng tồn tại với Hyper-V. Cập nhật lên VirtualBox 6.1 trở lên và bật paravirtualization Hyper-V trong cài đặt VM.
Người dùng Docker Desktop: đảm bảo nó được cấu hình để dùng backend WSL 2, không phải Hyper-V isolation. Cách này thực ra giải quyết xung đột thay vì làm phức tạp thêm.
Các công cụ diệt virus cũ — Avast, AVG, Kaspersky phiên bản trước 2020 — cũng có thể chặn hypervisor. Tắt tạm thời phần mềm diệt virus để xác nhận đó có phải nguyên nhân không, sau đó cập nhật hoặc thêm quy tắc whitelist cho tiến trình hypervisor.
Bước 5 — Đăng ký lại bản phân phối
Đã sửa xong vấn đề ảo hóa nhưng bản phân phối vẫn lỗi? Trạng thái đăng ký có thể bị hỏng. Kiểm tra những gì đang được đăng ký:
wsl --list --verbose
Nếu bản phân phối hiển thị trạng thái lỗi, hãy hủy đăng ký và cài lại:
wsl --unregister Ubuntu
wsl --install -d Ubuntu
Hoặc cập nhật bản thân WSL trước — thao tác này xử lý được nhiều lỗi đăng ký:
wsl --update
wsl --shutdown
Xác nhận đã khắc phục
Khởi động bản phân phối từ Start menu, hoặc chỉ cần chạy:
wsl
Bạn sẽ được đưa vào bash shell. Xác nhận WSL 2 đang chạy đúng:
wsl --list --verbose
Kết quả mong đợi:
NAME STATE VERSION
* Ubuntu Running 2
VERSION hiển thị 2 và STATE hiển thị Running là bạn đã thành công.
Bài học rút ra
Ảo hóa BIOS bị tắt là nguyên nhân gốc rễ trong khoảng 60–70% trường hợp — đặc biệt trên máy mới xuất xưởng hoặc sau khi reset BIOS. Panel CPU của Task Manager phát hiện điều này trong vài giây, không cần khởi động lại.
Một tình huống phổ biến khác: máy từng cài VMware hoặc VirtualBox nhiều năm trước, trước khi cùng tồn tại với Hyper-V trở thành tiêu chuẩn. Những bản cài đặt cũ đó để lại cấu hình hypervisor xung đột với WSL 2. Giữ các công cụ ảo hóa bên thứ ba luôn được cập nhật sẽ tránh được hầu hết những phiền toái này.
Đang dùng laptop công ty? Chính sách IT đôi khi khóa ảo hóa BIOS. Nếu đó là trường hợp của bạn, hãy nhờ quản trị viên hệ thống bật lên — hoặc dùng WSL 1 (wsl --set-default-version 1), vốn không cần ảo hóa phần cứng.