[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"page-ru-/guides/windows/enable-wsl2":3,"mdc--xl8k90-key":477,"mdc--ackgwn-key":502,"mdc--kxeldw-key":518,"mdc--bkb9lj-key":526,"mdc-fpu5xb-key":553,"mdc-xdxecj-key":569,"mdc-kiefm9-key":585,"mdc-xw9asd-key":593,"related-/guides/windows/install-ubuntu-wsl2,/guides/windows/wsl2-docker-setup,/errors/windows/wsl-error-0x800701bc":629},{"id":4,"title":5,"appliesTo":6,"author":9,"body":10,"canonical":415,"code":415,"createdAt":416,"description":417,"difficulty":418,"draft":419,"estimatedTime":420,"extension":421,"faq":422,"howToSteps":432,"howToTotalTime":448,"image":415,"keywords":449,"locale":456,"meta":457,"navigation":458,"path":459,"platform":460,"related":461,"section":465,"seo":466,"severity":415,"stem":467,"summary":468,"tags":469,"twitterCreator":415,"twitterSite":415,"type":475,"updatedAt":416,"__hash__":476},"content_ru/guides/windows/enable-wsl2.md","Как включить WSL2 на Windows 10 и 11: пошаговая инструкция",[7,8],"Windows 10 версия 2004 и выше","Windows 11","FixPedia Team",{"type":11,"value":12,"toc":396},"minimark",[13,18,27,53,56,60,63,97,103,107,112,127,133,137,140,156,159,186,195,199,206,209,213,216,232,238,241,245,248,257,267,274,283,289,293,296,322,325,329,333,336,345,349,352,385,389,392],[14,15,17],"h2",{"id":16},"зачем-нужен-wsl2","Зачем нужен WSL2",[19,20,21,22,26],"p",{},"WSL2 (Windows Subsystem for Linux 2) — это технология Microsoft, позволяющая запускать Linux-среду непосредственно в Windows без использования виртуальной машины. В отличие от первой версии, WSL2 использует ",[23,24,25],"strong",{},"настоящее ядро Linux"," через легковесную виртуальную машину, что дает:",[28,29,30,37,43],"ul",{},[31,32,33,36],"li",{},[23,34,35],{},"Полную совместимость"," с системными вызовами Linux (можно запускать Docker, Kubernetes, любые Linux-приложения)",[31,38,39,42],{},[23,40,41],{},"Нативную производительность"," — файловые операции работают в 2-5 раз быстрее, чем в WSL1",[31,44,45,48,49],{},[23,46,47],{},"Удобную интеграцию"," — доступ к файлам Linux из Windows через проводник по пути ",[50,51,52],"code",{},"\\\\wsl$\\",[19,54,55],{},"Если вы разработчик, системный администратор или изучаете Linux — WSL2 станет незаменимым инструментом.",[14,57,59],{"id":58},"требования-перед-установкой","Требования перед установкой",[19,61,62],{},"Перед началом убедитесь, что ваш компьютер соответствует требованиям:",[28,64,65,73,79,85,91],{},[31,66,67,70,71],{},[23,68,69],{},"Windows 10"," версия 2004 (May 2020 Update) или выше, либо ",[23,72,8],{},[31,74,75,78],{},[23,76,77],{},"64-битная версия"," Windows",[31,80,81,84],{},[23,82,83],{},"至少 4 ГБ оперативной памяти"," (рекомендуется 8 ГБ)",[31,86,87,90],{},[23,88,89],{},"Поддержка аппаратной виртуализации"," в процессоре (Intel VT-x, AMD-V или ARM64)",[31,92,93,96],{},[23,94,95],{},"Не менее 5 ГБ"," свободного места на диске",[98,99,100],"blockquote",{},[19,101,102],{},"⚠️ Важно: WSL2 конфликрует с некоторыми гипервизорами третьих сторон (старые версии VirtualBox, VMware). Если вы используете виртуальные машины — убедитесь, что они выключены перед запуском WSL2.",[14,104,106],{"id":105},"пошаговая-инструкция-по-включению-wsl2","Пошаговая инструкция по включению WSL2",[108,109,111],"h3",{"id":110},"шаг-1-запустите-powershell-от-имени-администратора","Шаг 1: Запустите PowerShell от имени администратора",[19,113,114,115,118,119,122,123,126],{},"Нажмите сочетание клавиш ",[23,116,117],{},"Win + X"," и выберите ",[23,120,121],{},"Терминал Windows (администратор)",". В Windows 10 это может называться ",[23,124,125],{},"Windows PowerShell (администратор)",".",[19,128,129,130,126],{},"Подтвердите запрос контроля учетных записей, нажав ",[23,131,132],{},"Да",[108,134,136],{"id":135},"шаг-2-включите-компонент-wsl","Шаг 2: Включите компонент WSL",[19,138,139],{},"В открывшемся окне PowerShell выполните следующую команду:",[141,142,147],"pre",{"className":143,"code":144,"language":145,"meta":146,"style":146},"language-powershell shiki shiki-themes github-light github-dark","wsl --install\n","powershell","",[50,148,149],{"__ignoreMap":146},[150,151,154],"span",{"class":152,"line":153},"line",1,[150,155,144],{},[19,157,158],{},"Эта команда делает всё необходимое:",[28,160,161,167,172,179],{},[31,162,163,164],{},"Включает компонент ",[23,165,166],{},"Платформа виртуальной машины",[31,168,163,169],{},[23,170,171],{},"Подсистема Windows для Linux",[31,173,174,175,178],{},"Устанавливает ",[23,176,177],{},"Ядро WSL2"," от Microsoft",[31,180,181,182,185],{},"Скачивает и устанавливает дистрибутив ",[23,183,184],{},"Ubuntu"," по умолчанию",[98,187,188],{},[19,189,190,191,194],{},"💡 Совет: Если команда ",[50,192,193],{},"wsl --install"," выдает ошибку на Windows 10 версии ниже 1903 — обновите систему через Центр обновления Windows.",[108,196,198],{"id":197},"шаг-3-перезагрузите-компьютер","Шаг 3: Перезагрузите компьютер",[19,200,201,202,205],{},"После успешного выполнения команды вы увидите сообщение о необходимости перезагрузки. ",[23,203,204],{},"Обязательно перезагрузите ПК"," — без этого изменения не вступят в силу, и WSL2 не запустится.",[207,208],"in-article-ad",{},[108,210,212],{"id":211},"шаг-4-настройте-linux-дистрибутив","Шаг 4: Настройте Linux-дистрибутив",[19,214,215],{},"После перезагрузки автоматически откроется окно установки Ubuntu (или другого выбранного дистрибутива). Следуйте инструкциям:",[217,218,219,222,229],"ol",{},[31,220,221],{},"Дождитесь загрузки компонентов",[31,223,224,225,228],{},"Придумайте и введите имя пользователя (не используйте ",[50,226,227],{},"root"," для повседневной работы)",[31,230,231],{},"Создайте пароль и подтвердите его",[19,233,234,235,126],{},"Пароль при вводе не отображается — это нормально. Введите его и нажмите ",[23,236,237],{},"Enter",[19,239,240],{},"После завершения установки вы увидите приглашение командной строки Ubuntu.",[108,242,244],{"id":243},"шаг-5-проверьте-версию-wsl","Шаг 5: Проверьте версию WSL",[19,246,247],{},"Чтобы убедиться, что установлена именно вторая версия, выполните в PowerShell:",[141,249,251],{"className":143,"code":250,"language":145,"meta":146,"style":146},"wsl -l -v\n",[50,252,253],{"__ignoreMap":146},[150,254,255],{"class":152,"line":153},[150,256,250],{},[19,258,259,260,263,264,126],{},"Вы увидите таблицу с установленными дистрибутивами. В столбце ",[23,261,262],{},"VERSION"," должно быть указано число ",[23,265,266],{},"2",[19,268,269,270,273],{},"Если там стоит ",[23,271,272],{},"1"," — выполните преобразование вручную:",[141,275,277],{"className":143,"code":276,"language":145,"meta":146,"style":146},"wsl --set-version Ubuntu 2\n",[50,278,279],{"__ignoreMap":146},[150,280,281],{"class":152,"line":153},[150,282,276],{},[19,284,285,286,288],{},"Замените ",[50,287,184],{}," на название вашего дистрибутива, если он другой.",[14,290,292],{"id":291},"проверка-результата","Проверка результата",[19,294,295],{},"Чтобы убедиться, что WSL2 работает корректно:",[217,297,298,305,312],{},[31,299,300,301,304],{},"Запустите установленный Linux-дистрибутив через меню Пуск или выполните ",[50,302,303],{},"wsl"," в PowerShell",[31,306,307,308,311],{},"Выполните команду ",[50,309,310],{},"uname -r"," — должна отобразиться версия ядра Linux",[31,313,314,315,318,319],{},"Проверьте работу системных вызовов: запустите ",[50,316,317],{},"docker --version"," (если Docker установлен) или ",[50,320,321],{},"python3 --version",[19,323,324],{},"Если всё работает — поздравляем, WSL2 настроен и готов к использованию.",[14,326,328],{"id":327},"возможные-проблемы","Возможные проблемы",[108,330,332],{"id":331},"ошибка-wsl-2-требует-обновления-ядра","Ошибка: «WSL 2 требует обновления ядра»",[19,334,335],{},"Выполните обновление ядра WSL вручную:",[141,337,339],{"className":143,"code":338,"language":145,"meta":146,"style":146},"wsl --update\n",[50,340,341],{"__ignoreMap":146},[150,342,343],{"class":152,"line":153},[150,344,338],{},[108,346,348],{"id":347},"ошибка-виртуализации","Ошибка виртуализации",[19,350,351],{},"Если при запуске появляется ошибка, связанная с виртуализацией:",[217,353,354,361,375,382],{},[31,355,356,357,360],{},"Перезагрузите компьютер и войдите в ",[23,358,359],{},"BIOS/UEFI"," (обычно клавиша Del, F2 или F12 при загрузке)",[31,362,363,364,367,368,371,372],{},"Найдите параметр ",[23,365,366],{},"Intel VT-x",", ",[23,369,370],{},"AMD-V"," или ",[23,373,374],{},"SVM Mode",[31,376,377,378,381],{},"Убедитесь, что он ",[23,379,380],{},"включен"," (Enabled)",[31,383,384],{},"Сохраните настройки и перезагрузитесь",[108,386,388],{"id":387},"wsl2-не-работает-параллельно-с-hyper-v","WSL2 не работает параллельно с Hyper-V",[19,390,391],{},"WSL2 использует тот же гипервизор, что и Hyper-V. Убедитесь, что виртуальные машины Hyper-V выключены, или используйте внешний коммутатор для сетевых подключений в WSL2.",[393,394,395],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":146,"searchDepth":397,"depth":397,"links":398},2,[399,400,401,409,410],{"id":16,"depth":397,"text":17},{"id":58,"depth":397,"text":59},{"id":105,"depth":397,"text":106,"children":402},[403,405,406,407,408],{"id":110,"depth":404,"text":111},3,{"id":135,"depth":404,"text":136},{"id":197,"depth":404,"text":198},{"id":211,"depth":404,"text":212},{"id":243,"depth":404,"text":244},{"id":291,"depth":397,"text":292},{"id":327,"depth":397,"text":328,"children":411},[412,413,414],{"id":331,"depth":404,"text":332},{"id":347,"depth":404,"text":348},{"id":387,"depth":404,"text":388},null,"2026-04-09 11:33:55","Подробный гайд по активации WSL2 за 10 минут. Включите подсистему Linux и используйте полноценную среду разработки в Windows.","medium",false,"10-15 мин","md",[423,426,429],{"answer":424,"question":425},"WSL2 использует полноценную виртуальную машину с ядром Linux, что дает **полную совместимость** системных вызовов и **нативную производительность** Docker. WSL1 — это лишь уровень совместимости без ядра Linux.","Чем WSL2 отличается от WSL1?",{"answer":427,"question":428},"Да, для WSL2 требуется **аппаратная виртуализация** (Intel VT-x или AMD-V). Если она отключена в BIOS, WSL2 не запустится. Большинство современных ПК имеют её включенной по умолчанию.","Нужно ли включать виртуализацию в BIOS для WSL2?",{"answer":430,"question":431},"Да, но потребуется настройка. VirtualBox 7.0+ поддерживает работу совместно с WSL2. В более ранних версиях могут возникнуть конфликты с гипервизором.","Можно ли использовать WSL2 вместе с VirtualBox?",[433,436,439,442,445],{"name":434,"text":435},"Запустите PowerShell от имени администратора","Нажмите **Win + X**, выберите **Терминал Windows (администратор)** или **PowerShell (администратор)**. Подтвердите запрос контроля учетных записей (UAC).",{"name":437,"text":438},"Включите компонент WSL","Выполните команду: `wsl --install`. Команда автоматически включит все необходимые компоненты: платформу виртуальной машины, подсистему Windows для Linux и ядро WSL2.",{"name":440,"text":441},"Перезагрузите компьютер","После установки компонентов **обязательно перезагрузите ПК**. Это необходимо для применения изменений и запуска требуемых служб.",{"name":443,"text":444},"Установите дистрибутив Linux","После перезагрузки откроется окно установки Ubuntu. Следуйте инструкциям на экране: выберите язык, создайте имя пользователя и пароль. Это можно пропустить и установить другой дистрибутив через Microsoft Store.",{"name":446,"text":447},"Проверьте версию WSL","Откройте PowerShell и выполните `wsl -l -v`. В столбце **VERSION** должно быть указано **2**. Если стоит 1 — выполните `wsl --set-version Ubuntu 2`.","PT15M",[450,451,452,453,454,455],"как включить WSL2","активация WSL2 Windows 10","WSL2 Windows 11 установка","включить подсистему Linux Windows","WSL2 инструкция","Windows Subsystem for Linux 2","ru_RU",{},true,"/guides/windows/enable-wsl2","windows",[462,463,464],"/guides/windows/install-ubuntu-wsl2","/guides/windows/wsl2-docker-setup","/errors/windows/wsl-error-0x800701bc","Гайды Windows",{"title":5,"description":417},"guides/windows/enable-wsl2","Пошаговое руководство по включению WSL2 на Windows 10 и Windows 11. После выполнения инструкции вы получите работающую подсистему Linux с полной поддержкой системных вызовов и Docker.",[470,69,8,471,472,473,474],"WSL2","подсистема Linux","Linux на Windows","гипервизор","PowerShell","guide","cGuMFH3R7n2obZdc_z5gxra1GLCxOlLezJzkyWqAHNQ",{"data":478,"body":479},{},{"type":227,"children":480},[481],{"type":482,"tag":19,"props":483,"children":484},"element",{},[485,488,493,495,500],{"type":486,"value":487},"text","WSL2 использует полноценную виртуальную машину с ядром Linux, что дает ",{"type":482,"tag":23,"props":489,"children":490},{},[491],{"type":486,"value":492},"полную совместимость",{"type":486,"value":494}," системных вызовов и ",{"type":482,"tag":23,"props":496,"children":497},{},[498],{"type":486,"value":499},"нативную производительность",{"type":486,"value":501}," Docker. WSL1 — это лишь уровень совместимости без ядра Linux.",{"data":503,"body":504},{},{"type":227,"children":505},[506],{"type":482,"tag":19,"props":507,"children":508},{},[509,511,516],{"type":486,"value":510},"Да, для WSL2 требуется ",{"type":482,"tag":23,"props":512,"children":513},{},[514],{"type":486,"value":515},"аппаратная виртуализация",{"type":486,"value":517}," (Intel VT-x или AMD-V). Если она отключена в BIOS, WSL2 не запустится. Большинство современных ПК имеют её включенной по умолчанию.",{"data":519,"body":520},{},{"type":227,"children":521},[522],{"type":482,"tag":19,"props":523,"children":524},{},[525],{"type":486,"value":430},{"data":527,"body":528},{},{"type":227,"children":529},[530],{"type":482,"tag":19,"props":531,"children":532},{},[533,535,539,541,545,546,551],{"type":486,"value":534},"Нажмите ",{"type":482,"tag":23,"props":536,"children":537},{},[538],{"type":486,"value":117},{"type":486,"value":540},", выберите ",{"type":482,"tag":23,"props":542,"children":543},{},[544],{"type":486,"value":121},{"type":486,"value":371},{"type":482,"tag":23,"props":547,"children":548},{},[549],{"type":486,"value":550},"PowerShell (администратор)",{"type":486,"value":552},". Подтвердите запрос контроля учетных записей (UAC).",{"data":554,"body":555},{},{"type":227,"children":556},[557],{"type":482,"tag":19,"props":558,"children":559},{},[560,562,567],{"type":486,"value":561},"Выполните команду: ",{"type":482,"tag":50,"props":563,"children":565},{"className":564},[],[566],{"type":486,"value":193},{"type":486,"value":568},". Команда автоматически включит все необходимые компоненты: платформу виртуальной машины, подсистему Windows для Linux и ядро WSL2.",{"data":570,"body":571},{},{"type":227,"children":572},[573],{"type":482,"tag":19,"props":574,"children":575},{},[576,578,583],{"type":486,"value":577},"После установки компонентов ",{"type":482,"tag":23,"props":579,"children":580},{},[581],{"type":486,"value":582},"обязательно перезагрузите ПК",{"type":486,"value":584},". Это необходимо для применения изменений и запуска требуемых служб.",{"data":586,"body":587},{},{"type":227,"children":588},[589],{"type":482,"tag":19,"props":590,"children":591},{},[592],{"type":486,"value":444},{"data":594,"body":595},{},{"type":227,"children":596},[597],{"type":482,"tag":19,"props":598,"children":599},{},[600,602,608,610,614,616,620,622,628],{"type":486,"value":601},"Откройте PowerShell и выполните ",{"type":482,"tag":50,"props":603,"children":605},{"className":604},[],[606],{"type":486,"value":607},"wsl -l -v",{"type":486,"value":609},". В столбце ",{"type":482,"tag":23,"props":611,"children":612},{},[613],{"type":486,"value":262},{"type":486,"value":615}," должно быть указано ",{"type":482,"tag":23,"props":617,"children":618},{},[619],{"type":486,"value":266},{"type":486,"value":621},". Если стоит 1 — выполните ",{"type":482,"tag":50,"props":623,"children":625},{"className":624},[],[626],{"type":486,"value":627},"wsl --set-version Ubuntu 2",{"type":486,"value":126},[]]