n8n на Windows через WSL2: полная инструкция для разработчика

Введение

Если вы решили всерьез заняться автоматизацией на n8n, первый совет, который вы услышите на форумах: "Ставь через Docker". И если у вас MacBook(macOS) или ноутбук на Linux (Ubuntu) — проблем нет. Но как быть, если ваша основная рабочая машина работает на Windows? Исторически сложилось так, что Docker Desktop на Windows всегда "съедал" всю оперативную память и безбожно тормозил, заставляя кулеры выть.

К счастью, в последние годы Microsoft выкатила WSL2 (Windows Subsystem for Linux). Это не симулятор и не тяжеловесная виртуальная машина вроде VirtualBox, а настоящее, полноценное ядро Linux, работающее прямо внутри вашей Windows 10/11 практически без потери производительности. В этой статье мы пошагово разберем, как правильно поднять локальную среду для разработки на n8n, используя WSL2 и Docker.

Шаг 1: Активация WSL2 и установка Ubuntu

Забудьте про клики мышкой по меню управления компонентами Windows, мы всё сделаем по-инженерному, одной командой. Откройте приложение PowerShell (Обязательно от имени Администратора) и просто введите:

wsl --install

Что произойдет в фоне?

1. Windows включит необходимые компоненты виртуализации.
2. Скачает последнее ядро Linux от Microsoft.
3. Скачает и установит дистрибутив Ubuntu по умолчанию.

После завершения процесса обязательно перезагрузите компьютер. При следующем включении откроется черное окно терминала с просьбой придумать UNIX username (логин) и пароль. Пароль при вводе отображаться не будет — это нормально для Linux. Запомните этот пароль, он понадобится вам для команды sudo.

Шаг 2: Установка Docker Desktop

Теперь нам нужен механизм, который будет запускать контейнеры (изолированные "коробочки" с программами) внутри нашего нового Linux. Для управления этим процессом под Windows существует Docker Desktop.

1. Зайдите на официальный сайт Docker и скачайте установщик для Windows.
2. Запустите установку. На одном из первых экранов убедитесь, что стоит галочка: "Use WSL 2 instead of Hyper-V (recommended)". Именно она скажет Докеру использовать нашу быструю подсистему Linux.
3. После установки запустите Docker Desktop. В настройках (шестеренка сверху справа) перейдите в Resources -> WSL Integration и убедитесь, что интеграция включена для вашего дистрибутива "Ubuntu".

Шаг 3: Запуск n8n через Docker Compose

Обычно новичкам советуют запускать n8n одной длинной командой docker run .... Это плохой совет. В реальности вам всегда понадобятся переменные окружения, проброс портов и сохранение данных. Поэтому мы сразу будем использовать взрослый инструмент — Docker Compose (он уже установился вместе с Docker Desktop).

Откройте терминал вашей Ubuntu (через меню "Пуск" найдите приложение Ubuntu) или используйте Windows Terminal (лучший терминал для Windows). Создадим папку для нашего проекта и зайдем в неё:

mkdir n8n-local
cd n8n-local

Теперь нам нужно создать файл описания конфигурации. Мы заведем файл docker-compose.yml при помощи встроенного текстового редактора nano:

nano docker-compose.yml

Вставьте в редактор следующий код (для вставки в WSL обычно используется правая кнопка мыши):

version: '3.8'

volumes:
  n8n_data:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n_local
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://localhost:5678/
      - GENERIC_TIMEZONE=Europe/Moscow
    volumes:
      - n8n_data:/home/node/.n8n

Нажмите Ctrl+O (сохранить), затем Enter (подтвердить имя файла), затем Ctrl+X (выйти из редактора).

Разбор конфигурации:

• restart: always — если n8n упадет или вы перезагрузите ПК, сервис поднимется сам.
• ports: "5678:5678" — пробрасываем порт из контейнера наружу. Без этого вы не зайдете в интерфейс.
• volumes — Самое важное! Без этой строки все ваши рабочие процессы (Workflows) удалятся навсегда при перезапуске контейнера. Мы говорим Docker сохранять всё в виртуальном защищенном хранялище n8n_data.
• GENERIC_TIMEZONE — часовой пояс. Замените на свой, иначе триггеры расписания (Cron) будут срабатывать криво.

Шаг 4: Запуск и проверка

Находясь в той же папке n8n-local, введите команду старта в "фоновом" (detached) режиме:

docker compose up -d

Docker скачает последние образы системы (около 500-800Мб) и запустит контейнер. Как только процесс завершится, откройте браузер в вашей Windows и перейдите по адресу:

http://localhost:5678

Поздравляю! Вы увидите окно первичной настройки n8n. Создайте локального пользователя администратора. Поскольку всё крутится на вашем ПК (localhost), эти данные безопасны и не "светятся" в интернете.

Бонус: Как получать Webhook от внешних сервисов из интернета к вам на локальный ПК?

Работать локально удобно: быстро, бесплатно, безопасно. Но есть проблема: если Telegram к вам должен прислать вебхук, когда клиент пишет сообщение боту, Telegram не может послать его на localhost (он попытается послать его самому себе).

Для разработки вам понадобится инструмент типа ngrok, localtunnel на node.js или встроенный в самом n8n туннель (работает только в демо-целях). Если используете n8n-tunnel, добавьте в секцию environment вашего docker-compose.yml строку: - N8N_TUNNEL=true и запустите docker compose up -d --force-recreate.

Заключение

Связка Windows + WSL2 + Docker Compose сегодня работает так же безупречно, как на родном Linux. Такой подход позволяет вам тестировать любые безумные идеи, подключать локальные ИИ-модели по сети внутри WSL, парсить сайты и ошибаться сколь угодно раз, не платя ни копейки за облачный хостинг, пока ваш проект не станет готов к Production-развертыванию.

Частые вопросы по установке n8n на Windows

Как выполнить установка n8n на Windows?

n8n установка на Windows выполняется через WSL2 (Windows Subsystem for Linux) — это самый стабильный способ для продакшен-использования. Альтернативно — Desktop App с официального сайта n8n.io, но он подходит только для тестирования.

Установка n8n на ПК: в чём разница WSL2 и Docker Desktop?

Установка n8n на ПК через WSL2 + Docker даёт лучшую производительность и меньше накладных расходов. Docker Desktop работает поверх WSL2 и добавляет GUI-интерфейс, что удобнее для новичков. Для разработчиков — WSL2 напрямую предпочтительнее.

Установка n8n на локальный сервер: когда это нужно?

Установка n8n на локальный сервер актуальна для корпоративных сетей без выхода в интернет или при требованиях к полному контролю данных. Локальный сервер внутри сети — например, NAS или выделенная машина с Ubuntu — даёт постоянный доступ без VPS.

n8n docker установка на Ubuntu: краткая инструкция

n8n docker установка на убунту:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
mkdir ~/n8n && cd ~/n8n
cat > docker-compose.yml << 'EOF'
version: "3.8"
services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    environment:
      GENERIC_TIMEZONE: Europe/Moscow
volumes:
  n8n_data:
EOF
docker compose up -d

Подробная установка с PostgreSQL и HTTPS — в статье n8n HTTPS через Nginx.