[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"page-ru-/guides/windows/setup-wsl2":3,"mdc-qegmfe-key":479,"mdc-6wse9-key":505,"mdc--29qsvx-key":538,"mdc--9eedke-key":546,"related-/guides/windows/setup-wsl,/guides/windows/configure-hyper-v,/guides/linux/ubuntu-install":562,"mdc--ow1sjg-key":563,"mdc-81gg5f-key":588,"mdc--ufgiu4-key":623,"mdc--c19yhh-key":652,"mdc-iwy4eu-key":690},{"id":4,"title":5,"appliesTo":6,"author":10,"body":11,"canonical":411,"code":73,"createdAt":412,"description":413,"difficulty":414,"draft":415,"estimatedTime":416,"extension":417,"faq":418,"howToSteps":431,"howToTotalTime":447,"image":411,"keywords":448,"locale":459,"meta":460,"navigation":461,"path":462,"platform":463,"related":464,"section":468,"seo":469,"severity":73,"stem":470,"summary":471,"tags":472,"twitterCreator":411,"twitterSite":411,"type":477,"updatedAt":412,"__hash__":478},"content_ru/guides/windows/setup-wsl2.md","Настроить WSL2 на Windows 11 за 5 минут – пошаговое руководство",[7,8,9],"Windows 10 21H2+","Windows 11 22H2+","Ubuntu 22.04 LTS","FixPedia Team",{"type":12,"value":13,"toc":397},"minimark",[14,19,35,38,42,55,59,64,67,90,93,97,100,115,126,130,133,142,149,152,156,159,195,202,237,241,244,276,279,283,315,318,322,372,385,393],[15,16,18],"h2",{"id":17},"введение-зачем-это-нужно","Введение / Зачем это нужно",[20,21,22,23,27,28,27,31,34],"p",{},"WSL2 (Windows Subsystem for Linux 2) позволяет запускать полноценные дистрибутивы Linux прямо в Windows без необходимости двойной загрузки или виртуальной машины. Это удобно для разработчиков, DevOps-инженеров и всех, кто хочет использовать инструменты Linux, такие как ",[24,25,26],"code",{},"git",", ",[24,29,30],{},"docker",[24,32,33],{},"python"," и другие, не покидая среду Windows.",[20,36,37],{},"После выполнения этого руководства у вас будет полностью настроенная среда WSL2 с дистрибутивом Ubuntu, готовая к повседневной работе с Linux-командами.",[15,39,41],{"id":40},"требования-подготовка","Требования / Подготовка",[43,44,45,49,52],"ul",{},[46,47,48],"li",{},"Windows 10 (версия 2004 или выше) или Windows 11 с включённым режимом разработчика.",[46,50,51],{},"Права администратора для включения необходимых компонентов Windows.",[46,53,54],{},"Интернет-соединение для загрузки ядра и дистрибутива.",[15,56,58],{"id":57},"пошаговая-инструкция","Пошаговая инструкция",[60,61,63],"h3",{"id":62},"шаг-1-включение-hyperv-и-virtual-machine-platform","Шаг 1: Включение Hyper‑V и Virtual Machine Platform",[20,65,66],{},"Откройте PowerShell от имени администратора и выполните:",[68,69,74],"pre",{"className":70,"code":71,"language":72,"meta":73,"style":73},"language-powershell shiki shiki-themes github-light github-dark","Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All\nEnable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All\n","powershell","",[24,75,76,84],{"__ignoreMap":73},[77,78,81],"span",{"class":79,"line":80},"line",1,[77,82,83],{},"Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All\n",[77,85,87],{"class":79,"line":86},2,[77,88,89],{},"Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All\n",[20,91,92],{},"Перезагрузите систему для применения изменений.",[60,94,96],{"id":95},"шаг-2-обновление-ядра-wsl2","Шаг 2: Обновление ядра WSL2",[20,98,99],{},"Убедитесь, что используется последнее ядро:",[68,101,103],{"className":70,"code":102,"language":72,"meta":73,"style":73},"wsl --update\nwsl --install\n",[24,104,105,110],{"__ignoreMap":73},[77,106,107],{"class":79,"line":80},[77,108,109],{},"wsl --update\n",[77,111,112],{"class":79,"line":86},[77,113,114],{},"wsl --install\n",[20,116,117,118,121,122,125],{},"Команда ",[24,119,120],{},"wsl --update"," скачает и установит последнюю версию ядра, а ",[24,123,124],{},"wsl --install"," подготовит систему к первому дистрибутиву.",[60,127,129],{"id":128},"шаг-3-установка-дистрибутива-ubuntu","Шаг 3: Установка дистрибутива Ubuntu",[20,131,132],{},"Запустите установщик дистрибутива:",[68,134,136],{"className":70,"code":135,"language":72,"meta":73,"style":73},"wsl --install -d Ubuntu\n",[24,137,138],{"__ignoreMap":73},[77,139,140],{"class":79,"line":80},[77,141,135],{},[20,143,144,145,148],{},"Создайте пароль для пользователя root при первом запуске. После завершения установки запустите Ubuntu из меню «Пуск» или через команду ",[24,146,147],{},"ubuntu",".",[150,151],"in-article-ad",{},[60,153,155],{"id":154},"шаг-4-создание-первого-пользователя-и-настройка-домашней-директории","Шаг 4: Создание первого пользователя и настройка домашней директории",[20,157,158],{},"В терминале Ubuntu выполните:",[68,160,164],{"className":161,"code":162,"language":163,"meta":73,"style":73},"language-bash shiki shiki-themes github-light github-dark","sudo adduser alice\nsudo usermod -aG sudo alice\n","bash",[24,165,166,179],{"__ignoreMap":73},[77,167,168,172,176],{"class":79,"line":80},[77,169,171],{"class":170},"sScJk","sudo",[77,173,175],{"class":174},"sZZnC"," adduser",[77,177,178],{"class":174}," alice\n",[77,180,181,183,186,190,193],{"class":79,"line":86},[77,182,171],{"class":170},[77,184,185],{"class":174}," usermod",[77,187,189],{"class":188},"sj4cs"," -aG",[77,191,192],{"class":174}," sudo",[77,194,178],{"class":174},[20,196,197,198,201],{},"Затем войдите под новым пользователем (",[24,199,200],{},"su - alice",") и установите необходимые инструменты, например:",[68,203,205],{"className":161,"code":204,"language":163,"meta":73,"style":73},"sudo apt update && sudo apt install -y git vim\n",[24,206,207],{"__ignoreMap":73},[77,208,209,211,214,217,221,223,225,228,231,234],{"class":79,"line":80},[77,210,171],{"class":170},[77,212,213],{"class":174}," apt",[77,215,216],{"class":174}," update",[77,218,220],{"class":219},"sVt8B"," && ",[77,222,171],{"class":170},[77,224,213],{"class":174},[77,226,227],{"class":174}," install",[77,229,230],{"class":188}," -y",[77,232,233],{"class":174}," git",[77,235,236],{"class":174}," vim\n",[60,238,240],{"id":239},"шаг-5-проверка-работоспособности-и-запуск-команд","Шаг 5: Проверка работоспособности и запуск команд",[20,242,243],{},"Проверьте версию ядра и список дистрибутивов:",[68,245,247],{"className":161,"code":246,"language":163,"meta":73,"style":73},"wsl --list --verbose\nwsl -d Ubuntu uname -r\n",[24,248,249,260],{"__ignoreMap":73},[77,250,251,254,257],{"class":79,"line":80},[77,252,253],{"class":170},"wsl",[77,255,256],{"class":188}," --list",[77,258,259],{"class":188}," --verbose\n",[77,261,262,264,267,270,273],{"class":79,"line":86},[77,263,253],{"class":170},[77,265,266],{"class":188}," -d",[77,268,269],{"class":174}," Ubuntu",[77,271,272],{"class":174}," uname",[77,274,275],{"class":188}," -r\n",[20,277,278],{},"Теперь вы можете запускать любые Linux-команды напрямую из PowerShell или Windows Terminal.",[15,280,282],{"id":281},"проверка-результата","Проверка результата",[43,284,285,296,306],{},[46,286,117,287,290,291,295],{},[24,288,289],{},"wsl --list --verbose"," должна показать статус ",[292,293,294],"strong",{},"Running"," для Ubuntu.",[46,297,298,301,302,305],{},[24,299,300],{},"wsl -d Ubuntu uname -r"," отобразит версию ядра (например, ",[24,303,304],{},"5.15.90.1-microsoft-standard-WSL2",").",[46,307,308,309,311,312,305],{},"Запустите ",[24,310,147],{}," из меню «Пуск» — вы увидите приглашение bash с вашей домашней директорией (",[24,313,314],{},"/home/alice",[20,316,317],{},"Если всё вышеперечисленное отображается корректно, настройка WSL2 завершена успешно.",[15,319,321],{"id":320},"возможные-проблемы","Возможные проблемы",[43,323,324,334,346,358],{},[46,325,326,329,330,333],{},[292,327,328],{},"Hyper‑V или Virtualization Platform отключены"," – выполните команды из Шага 1 с параметром ",[24,331,332],{},"-All"," и перезагрузите систему.",[46,335,336,339,340,343,344,148],{},[292,337,338],{},"WSL2 выдаёт ошибку «0x80070103» при обновлении"," – удалите старое ядро вручную: ",[24,341,342],{},"wsl --shutdown"," и повторите ",[24,345,120],{},[46,347,348,353,354,357],{},[292,349,117,350,352],{},[24,351,253],{}," не найдена"," – убедитесь, что каталог ",[24,355,356],{},"C:\\Program Files\\WindowsSubSystemLinux"," добавлен в системный PATH (добавляется автоматически после установки).",[46,359,360,363,364,367,368,371],{},[292,361,362],{},"Ubuntu не запускается"," – переустановите дистрибутив: ",[24,365,366],{},"wsl --uninstall Ubuntu"," и выполните ",[24,369,370],{},"wsl --install -d Ubuntu"," повторно.",[373,374,375],"blockquote",{},[20,376,377,380,381,384],{},[292,378,379],{},"💡 Совет:"," Храните все команды WSL2 в отдельном скрипте (",[24,382,383],{},"wsl-setup.ps1","), чтобы быстро повторить настройку на новом ПК.",[373,386,387],{},[20,388,389,392],{},[292,390,391],{},"⚠️ Важно:"," Для использования Docker внутри WSL2 дополнительно требуется установка Docker Desktop для Windows с включённым背部 engine WSL2. Это выходит за рамки данного гайда, но может быть полезно для дальнейшей работы.",[394,395,396],"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);}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":73,"searchDepth":86,"depth":86,"links":398},[399,400,401,409,410],{"id":17,"depth":86,"text":18},{"id":40,"depth":86,"text":41},{"id":57,"depth":86,"text":58,"children":402},[403,405,406,407,408],{"id":62,"depth":404,"text":63},3,{"id":95,"depth":404,"text":96},{"id":128,"depth":404,"text":129},{"id":154,"depth":404,"text":155},{"id":239,"depth":404,"text":240},{"id":281,"depth":86,"text":282},{"id":320,"depth":86,"text":321},null,"2026-08-09 09:14:45","Узнайте, как быстро установить и настроить WSL2 на Windows 11, включая включение Hyper‑V, установку Ubuntu и запуск команд Linux. Пошаговая инструкция за 5 минут.","medium",false,"5-10 мин","md",[419,422,425,428],{"question":420,"answer":421},"Почему WSL2 не запускается после установки?","Проверьте, включены ли Hyper‑V и Virtualization Platform, а также правильность режима UEFI. Используйте `wsl --status` и выполните `dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux`.",{"question":423,"answer":424},"Как установить дистрибутив Linux, помимо Ubuntu?","После установки WSL2 запустите `wsl --list` для просмотра установленных дистрибутивов, а затем выполните `wsl -d Ubuntu --user root` для обновления или `wsl --install -d \u003Cdistro>` для установки нового.",{"question":426,"answer":427},"Что делать, если команда `wsl` не найдена?","Добавьте Windows Terminal или PowerShell из меню «Пуск» в PATH. Также убедитесь, что включена опция «Windows PowerShell» в разделе «Приложения» > «Выполнить как администратор`.",{"question":429,"answer":430},"Можно ли использовать WSL2 без установки дополнительных пакетов?","Да, базовый WSL2 работает с минимальным набором инструментов. Для расширенных возможностей (например, Docker) выполните `wsl --update` и установите необходимые пакеты внутри выбранного дистрибутива.",[432,435,438,441,444],{"name":433,"text":434},"Включение Hyper‑V и Virtual Machine Platform","Откройте PowerShell от имени администратора и выполните:\n```powershell\nEnable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All\nEnable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All\n```\nПерезагрузите систему для применения изменений.",{"name":436,"text":437},"Обновление ядра WSL2","Убедитесь, что используется последнее ядро:\n```powershell\nwsl --update\nwsl --install\n```\nКоманда `wsl --update` скачает и установит последнюю версию ядра, а `wsl --install` подготовит систему к первому дистрибутиву.",{"name":439,"text":440},"Установка дистрибутива Ubuntu","Запустите установщик дистрибутива:\n```powershell\nwsl --install -d Ubuntu\n```\nСоздайте пароль для пользователя root при первом запуске. После завершения установки запустите Ubuntu из меню «Пуск» или через команду `ubuntu`.",{"name":442,"text":443},"Создание первого пользователя и настройка домашней директории","В терминале Ubuntu выполните:\n```bash\nsudo adduser alice\nsudo usermod -aG sudo alice\n```\nЗатем войдите под новым пользователем (`su - alice`) и установите необходимые инструменты, например, `sudo apt update && sudo apt install -y git vim`.",{"name":445,"text":446},"Проверка работоспособности и запуск команд","Проверьте версию ядра и список дистрибутивов:\n```bash\nwsl --list --verbose\nwsl -d Ubuntu uname -r\n```\nТеперь вы можете запускать любые Linux-команды напрямую из PowerShell или Windows Terminal.","PT10M",[449,450,451,452,453,454,455,456,457,458],"WSL2","Windows 11","hyper-v","Ubuntu","установка WSL2","настройка WSL2","команды Linux","WSL2 настройка","как установить WSL2","пошаговое руководство WSL2","ru_RU",{},true,"/guides/windows/setup-wsl2","windows",[465,466,467],"/guides/windows/setup-wsl","/guides/windows/configure-hyper-v","/guides/linux/ubuntu-install","Гайды Windows",{"title":5,"description":413},"guides/windows/setup-wsl2","В этом гайде вы узнаете, как установить WSL2 на Windows 11, активировать Hyper‑V, установить Ubuntu и начать использовать команды Linux. После выполнения инструкции вы сможете запускать любые инструменты Linux напрямую из PowerShell.",[449,450,473,452,474,475,476],"Hyper-V","Linux","пошаговое руководство","установка","guide","IDpdhpmE3CR1AbamsVQBShPZgjcJgszZQboNPjXLxq0",{"data":480,"body":481},{},{"type":482,"children":483},"root",[484],{"type":485,"tag":20,"props":486,"children":487},"element",{},[488,491,497,498,504],{"type":489,"value":490},"text","Проверьте, включены ли Hyper‑V и Virtualization Platform, а также правильность режима UEFI. Используйте ",{"type":485,"tag":24,"props":492,"children":494},{"className":493},[],[495],{"type":489,"value":496},"wsl --status",{"type":489,"value":367},{"type":485,"tag":24,"props":499,"children":501},{"className":500},[],[502],{"type":489,"value":503},"dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux",{"type":489,"value":148},{"data":506,"body":507},{},{"type":482,"children":508},[509],{"type":485,"tag":20,"props":510,"children":511},{},[512,514,520,522,528,530,536],{"type":489,"value":513},"После установки WSL2 запустите ",{"type":485,"tag":24,"props":515,"children":517},{"className":516},[],[518],{"type":489,"value":519},"wsl --list",{"type":489,"value":521}," для просмотра установленных дистрибутивов, а затем выполните ",{"type":485,"tag":24,"props":523,"children":525},{"className":524},[],[526],{"type":489,"value":527},"wsl -d Ubuntu --user root",{"type":489,"value":529}," для обновления или ",{"type":485,"tag":24,"props":531,"children":533},{"className":532},[],[534],{"type":489,"value":535},"wsl --install -d \u003Cdistro>",{"type":489,"value":537}," для установки нового.",{"data":539,"body":540},{},{"type":482,"children":541},[542],{"type":485,"tag":20,"props":543,"children":544},{},[545],{"type":489,"value":427},{"data":547,"body":548},{},{"type":482,"children":549},[550],{"type":485,"tag":20,"props":551,"children":552},{},[553,555,560],{"type":489,"value":554},"Да, базовый WSL2 работает с минимальным набором инструментов. Для расширенных возможностей (например, Docker) выполните ",{"type":485,"tag":24,"props":556,"children":558},{"className":557},[],[559],{"type":489,"value":120},{"type":489,"value":561}," и установите необходимые пакеты внутри выбранного дистрибутива.",[],{"data":564,"body":565},{},{"type":482,"children":566},[567,571,580,584],{"type":485,"tag":20,"props":568,"children":569},{},[570],{"type":489,"value":66},{"type":485,"tag":68,"props":572,"children":575},{"className":573,"code":71,"language":72,"meta":73,"style":574},"language-powershell","undefined",[576],{"type":485,"tag":24,"props":577,"children":578},{"__ignoreMap":73},[579],{"type":489,"value":71},{"type":485,"tag":20,"props":581,"children":582},{},[583],{"type":489,"value":92},{"type":485,"tag":394,"props":585,"children":586},{},[587],{"type":489,"value":73},{"data":589,"body":590},{},{"type":482,"children":591},[592,596,603,619],{"type":485,"tag":20,"props":593,"children":594},{},[595],{"type":489,"value":99},{"type":485,"tag":68,"props":597,"children":598},{"className":573,"code":102,"language":72,"meta":73,"style":574},[599],{"type":485,"tag":24,"props":600,"children":601},{"__ignoreMap":73},[602],{"type":489,"value":102},{"type":485,"tag":20,"props":604,"children":605},{},[606,607,612,613,618],{"type":489,"value":117},{"type":485,"tag":24,"props":608,"children":610},{"className":609},[],[611],{"type":489,"value":120},{"type":489,"value":121},{"type":485,"tag":24,"props":614,"children":616},{"className":615},[],[617],{"type":489,"value":124},{"type":489,"value":125},{"type":485,"tag":394,"props":620,"children":621},{},[622],{"type":489,"value":73},{"data":624,"body":625},{},{"type":482,"children":626},[627,631,638,648],{"type":485,"tag":20,"props":628,"children":629},{},[630],{"type":489,"value":132},{"type":485,"tag":68,"props":632,"children":633},{"className":573,"code":135,"language":72,"meta":73,"style":574},[634],{"type":485,"tag":24,"props":635,"children":636},{"__ignoreMap":73},[637],{"type":489,"value":135},{"type":485,"tag":20,"props":639,"children":640},{},[641,642,647],{"type":489,"value":144},{"type":485,"tag":24,"props":643,"children":645},{"className":644},[],[646],{"type":489,"value":147},{"type":489,"value":148},{"type":485,"tag":394,"props":649,"children":650},{},[651],{"type":489,"value":73},{"data":653,"body":654},{},{"type":482,"children":655},[656,660,668,686],{"type":485,"tag":20,"props":657,"children":658},{},[659],{"type":489,"value":158},{"type":485,"tag":68,"props":661,"children":663},{"className":662,"code":162,"language":163,"meta":73,"style":574},"language-bash",[664],{"type":485,"tag":24,"props":665,"children":666},{"__ignoreMap":73},[667],{"type":489,"value":162},{"type":485,"tag":20,"props":669,"children":670},{},[671,672,677,679,685],{"type":489,"value":197},{"type":485,"tag":24,"props":673,"children":675},{"className":674},[],[676],{"type":489,"value":200},{"type":489,"value":678},") и установите необходимые инструменты, например, ",{"type":485,"tag":24,"props":680,"children":682},{"className":681},[],[683],{"type":489,"value":684},"sudo apt update && sudo apt install -y git vim",{"type":489,"value":148},{"type":485,"tag":394,"props":687,"children":688},{},[689],{"type":489,"value":73},{"data":691,"body":692},{},{"type":482,"children":693},[694,698,705,709],{"type":485,"tag":20,"props":695,"children":696},{},[697],{"type":489,"value":243},{"type":485,"tag":68,"props":699,"children":700},{"className":662,"code":246,"language":163,"meta":73,"style":574},[701],{"type":485,"tag":24,"props":702,"children":703},{"__ignoreMap":73},[704],{"type":489,"value":246},{"type":485,"tag":20,"props":706,"children":707},{},[708],{"type":489,"value":278},{"type":485,"tag":394,"props":710,"children":711},{},[712],{"type":489,"value":73}]