---
title: "Установка WSL"
id: "375"
type: "page"
slug: "wsl"
published_at: "2026-05-24T17:55:46+00:00"
modified_at: "2026-10-03T16:51:42+00:00"
url: "https://pastukhov.com/agents/agent/wsl"
markdown_url: "https://pastukhov.com/agents/agent/wsl.md"
excerpt: "WSL (Windows Subsystem for Linux) — встроенная в Windows возможность запускать Linux без виртуальной машины…"
---

# Установка WSL

[https://pastukhov.com/agents/agent/wsl.md](https://pastukhov.com/agents/agent/wsl.md)

Не хотите читать всё это? Просто скиньте в любой ИИ-чат (Claude, ChatGPT и т.д.) ссылку на [https://pastukhov.com/agents/agent/wsl.md](https://pastukhov.com/agents/agent/wsl.md)
 или на [https://pastukhov.com/llms.txt](https://pastukhov.com/llms.txt)
 и попросите сгенерировать конфигурационные файлы и команды. Он прочитает документацию, задаст несколько вопросов о вашей настройке и выдаст готовую конфигурацию. Экономьте время — пусть модель читает за вас.

 Вы также можете связаться со мной через Telegram — я всегда рад помочь. И это не просто вежливость — мне действительно нравится общаться с единомышленниками, особенно если вы так же увлечены программированием, как и я.

 WSL (Windows Subsystem for Linux) — встроенная в Windows возможность запускать Linux без виртуальной машины и переустановки системы. Простыми словами: вы получаете «настоящий Linux» внутри Windows, с теми же командами и программами. Для Pastukhov Agent это удобный способ запустить его в контейнере Docker на компьютере с Windows: контейнер полностью изолирует программу от остальной системы, а работает всё на скорости родного Linux.

## Windows 11

В Windows 11 WSL 2 уже встроен — достаточно одной команды, всё остальное система сделает сама. Откройте терминал (PowerShell или Командная строка) и выполните:

```
wsl --install
```

Эта команда установит WSL 2 вместе с Ubuntu — популярным дистрибутивом Linux, который будет играть роль окружения. Перезагрузите компьютер, когда система попросит. После перезагрузки Ubuntu откроется сама — останется только придумать имя пользователя и пароль для Linux, как при первом включении нового компьютера.

## Установка Docker

Теперь нужно установить Docker — технологию «контейнеров», в которой работает Pastukhov Agent. В терминале WSL выполните:

```
# Подготовка (нужные вспомогательные программы)
sudo apt update && sudo apt install -y ca-certificates curl

# Добавление ключа и репозитория Docker
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Установка Docker Engine
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Запуск Docker
sudo service docker start

# Добавляем себя в группу docker, чтобы не вводить sudo при каждой команде
sudo usermod -aG docker $USER
```

После добавления в группу docker закройте и снова откройте терминал WSL — так изменения вступят в силу. Проверьте, что Docker работает:

```
docker --version
docker compose version
```

## Запуск Pastukhov Agent

Создайте папку для вашего проекта и следуйте [Руководству по настройке Docker](/agents/agent/docker)
 — там по шагам показано, как настроить и запустить Pastukhov Agent. Файлы проекта можно открывать и из Windows (путь `\\wsl$\Ubuntu\` в Проводнике), и из терминала WSL — это одна и та же папка, просто видимая с двух сторон.

## Windows 10

В Windows 10 WSL 2 требует один дополнительный шаг — включение платформы виртуальной машины. Откройте PowerShell от имени администратора и выполните:

```
# Включение WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Включение платформы виртуальной машины (обязательно для WSL 2)
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
```

Перезагрузите компьютер, снова откройте PowerShell и укажите WSL 2 как версию по умолчанию:

```
wsl --set-default-version 2
```

Установите Ubuntu из Microsoft Store (найдите «Ubuntu») или выполните:

```
wsl --install -d Ubuntu
```

После установки откройте Ubuntu и задайте имя пользователя и пароль. Дальше — те же шаги установки Docker, что и для Windows 11 выше.

## Доступ к приложению

Когда Pastukhov Agent запущен, откройте браузер в Windows и перейдите по адресу `http://localhost:5001` (или тому порту, который вы указали при настройке). WSL 2 сам перенаправляет порты в Windows, поэтому ничего дополнительно настраивать не нужно.

Если адрес по какой-то причине не открывается, узнайте IP-адрес WSL:

```
# В терминале WSL
hostname -I
```

Затем откройте в браузере Windows адрес `http://<этот-ip>:5001`.

## Полезные советы

- **Где хранить файлы проекта** — диски Windows доступны из WSL по адресам `/mnt/c/`, `/mnt/d/` и так далее. Но для скорости работы Docker лучше держать файлы проекта внутри файловой системы WSL (например, в `~/projects/`), а не на дисках Windows.
- **Автозапуск Docker** — чтобы Docker стартовал сам при открытии WSL, добавьте `sudo service docker start` в файл `~/.bashrc` или `~/.zshrc`.
- **Нужен графический интерфейс?** — если удобнее управлять Docker мышью, используйте Docker Desktop: см. [руководство по Docker Desktop в Windows](/agents/agent/windows-docker-desktop) . Docker Desktop сам интегрируется с WSL 2, и ручная установка Docker из этого раздела не понадобится.

Подробности настройки Docker (файлы compose, переменные окружения, учётные данные) — в [Руководстве по настройке Docker](/agents/agent/docker)
. Для установки через нативный установщик Windows — см. [Руководство по установке Windows](/agents/agent/windows)
.