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 अद्यतन" के माध्यम से अपने सिस्टम को अपग्रेड करें।

1.2 हार्डवेयर वर्चुअलाइज़ेशन सक्षम करें

WSL 2 वर्चुअलाइज़ेशन तकनीक पर चलता है, इसलिए मदरबोर्ड BIOS/UEFI में वर्चुअलाइज़ेशन तकनीक (Virtualization Technology) सक्षम होनी चाहिए।

• जाँच विधि: "टास्क मैनेजर" → "प्रदर्शन" टैब → "CPU" खोलें।
• स्थिति देखें: नीचे दाईं ओर "वर्चुअलाइज़ेशन" स्थिति "सक्षम" होनी चाहिए।
• सक्षम करने की विधि: यदि सक्षम नहीं है, तो आपको कंप्यूटर पुनः प्रारंभ कर BIOS/UEFI सेटिंग्स में जाना होगा, Intel VT-x या AMD-V जैसा विकल्प ढूँढकर Enabled पर सेट करें।

1.3 Windows संबंधित सुविधाएँ सक्षम करें

आपको Windows की "Linux के लिए Windows सबसिस्टम" और "वर्चुअल मशीन प्लेटफ़ॉर्म" सुविधाएँ सक्षम करनी होंगी।

विधि A: ग्राफ़िकल इंटरफ़ेस के माध्यम से (अनुशंसित)

1. Win + S दबाएँ, "Windows सुविधाएँ चालू या बंद करें" खोजें और खोलें।
2. निम्नलिखित दो विकल्प चुनें:
   • Linux के लिए Windows सबसिस्टम (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 संस्करण Microsoft Store के माध्यम से WSL अद्यतन प्राप्त कर सकते हैं।

• डाउनलोड पता: Microsoft Store - Windows Subsystem for Linux
• मैनुअल डाउनलोड: यदि Store उपलब्ध नहीं है, तो WSL GitHub Releases से नवीनतम .msixbundle या .msi इंस्टॉलेशन पैकेज डाउनलोड कर ऑफ़लाइन इंस्टॉल करें।

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 का उपयोग करके मौजूदा WSL 1 इंस्टेंस को WSL 2 में अपग्रेड कर सकते हैं।

2. कमांड उपलब्ध होना इंस्टॉलेशन सफल होने के बराबर नहीं है

wsl --version, wsl -l -v जैसे कमांड सामान्य रूप से चल पाना यह नहीं दर्शाता कि Linux इंस्टॉल करने की शर्तें पूरी हो चुकी हैं। दोनों अलग-अलग चरण हैं, उन्हें बराबर नहीं माना जा सकता।

कमांड उपलब्ध होने का मतलब केवल यह है:

• ✅ Windows में WSL घटक सक्षम/इंस्टॉल हो चुके हैं
• ✅ wsl.exe कमांड-लाइन टूल उपलब्ध है
• ✅ सिस्टम WSL संबंधित कमांड को पहचानता है

लेकिन Linux डिस्ट्रो को सफलतापूर्वक इंस्टॉल करने के लिए अतिरिक्त शर्तें पूरी होनी चाहिए। सामान्य रूप से अटकने वाले स्थान:

1. वर्चुअलाइज़ेशन बंद है: BIOS/UEFI में VT-x / AMD-V सक्षम नहीं है, WSL 2 प्रारंभ नहीं हो सकता, या डिस्ट्रो इंस्टॉल करते समय वर्चुअलाइज़ेशन त्रुटि रिपोर्ट होती है (जाँच विधि 1.2 हार्डवेयर वर्चुअलाइज़ेशन सक्षम करें देखें)।
2. Windows संस्करण/बिल्ड बहुत पुराना है: WSL 2 को कर्नेल और संस्करण की आवश्यकताएँ हैं, होम संस्करण, पुराने एंटरप्राइज़ इमेज में सुविधाएँ कम हो सकती हैं (जाँच विधि 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 निष्पादित करें, सफल होना चाहिए। सामान्य विफलता कारण: वर्चुअल मशीन प्लेटफ़ॉर्म सक्षम नहीं, या BIOS में VT-x / AMD-V सक्षम नहीं।

3.3 सामान्य विफलता कारण त्वरित संदर्भ

स्थिति	विवरण	समाधान
BIOS में वर्चुअलाइज़ेशन सक्षम नहीं	निश्चित रूप से विफल	पुनः प्रारंभ कर BIOS में VT-x / AMD-V सक्षम करें (देखें 1.2)
Windows 10 19041 से नीचे	wsl --install समर्थित नहीं	सिस्टम अपग्रेड करें (देखें 1.1)
एंटरप्राइज़ वातावरण में Hyper-V / वर्चुअलाइज़ेशन अक्षम	संभवतः विफल	सिस्टम व्यवस्थापक से संपर्क करें
पुराना होम संस्करण सिस्टम	मैनुअल इंस्टॉलेशन आवश्यक	1.4 के अनुसार WSL कर्नेल मैनुअल इंस्टॉल करें

3.4 त्रुटि 0xc03a0014: वर्चुअल डिस्क समर्थन प्रदाता नहीं मिला

त्रुटि संदेश Cannot find a virtual disk support provider for the specified file है। यह Linux डिस्ट्रो की समस्या नहीं है, बल्कि Windows का VHD/VHDX वर्चुअल डिस्क स्टैक सामान्य रूप से कार्य नहीं कर रहा है, WSL 2 डिस्ट्रो पंजीकरण, ext4.vhdx बनाने/माउंट करने में विफल होता है।

पहले न्यूनतम सत्यापन करें: PowerShell को व्यवस्थापक के रूप में चलाएँ, New-VHD परीक्षण निष्पादित करें (जैसे New-VHD -Path C:\test.vhdx -SizeBytes 1GB)। यदि यह कमांड भी वही त्रुटि रिपोर्ट करती है, तो समस्या 100% Windows पक्ष की है, डिस्ट्रो से कोई संबंध नहीं।

निम्नलिखित क्रम में समस्या निवारण करें:

1. Virtual Disk सेवा नहीं चल रही: services.msc खोलें, Virtual Disk सेवा ढूँढें, प्रारंभ प्रकार "स्वचालित" पर सेट करें और प्रारंभ करें।

2. WSL / वर्चुअल मशीन प्लेटफ़ॉर्म सुविधा सक्षम नहीं (या प्रभावी नहीं): 1.3 Windows संबंधित सुविधाएँ सक्षम करें में दिए गए कमांड पुनः निष्पादित करें, फिर पुनः प्रारंभ करना अनिवार्य है। Windows होम संस्करण में पूर्ण Hyper-V नहीं है, लेकिन WSL 2 को केवल वर्चुअल मशीन प्लेटफ़ॉर्म की आवश्यकता है, Hyper-V प्रबंधन इंटरफ़ेस की नहीं।

3. वर्चुअल डिस्क ड्राइवर/डिवाइस अनुपलब्ध: डिवाइस मैनेजर खोलें, "सिस्टम डिवाइस / स्टोरेज कंट्रोलर" में निम्नलिखित की उपस्थिति जाँचें:

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

   अनुपलब्ध होने पर hdwwiz.exe के माध्यम से मैन्युअल रूप से जोड़ें (स्टोरेज कंट्रोलर → Microsoft → Microsoft VHD लूपबैक कंट्रोलर), और 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) वर्चुअल डिस्क संचालन में हस्तक्षेप कर सकती हैं, समस्या निवारण के दौरान अस्थायी रूप से बंद करके पुनः प्रयास करें।