Перейти к содержанию

Как установить n8n: локально, через Docker и на VPS

Обновлено: 2026-05-29

Открыть мой план

Эта инструкция помогает выбрать способ установки n8n без лишней теории. Для знакомства подойдёт локальный запуск. Для постоянной автоматизации лучше сразу ставить n8n через Docker Compose на VPS: так проще обновляться, сохранять данные, подключать HTTPS и восстанавливать сервис после сбоя.

Какой способ выбрать

ЗадачаСпособКомментарий
Посмотреть интерфейс за 5 минутnpx n8nБыстро, но не для постоянной работы.
Учиться на своём ПКDocker с volumeДанные переживают перезапуск контейнера.
Работать 24/7VPS + Docker ComposeДомен, HTTPS, backup, обновления и monitoring.
Принимать webhooks из CRM/платежейVPS или tunnel для тестаВнешний сервис должен видеть URL n8n.
Высокая нагрузкаPostgreSQL + Redis + workersЭто уже production-архитектура, не стартовый вариант.

Быстрый локальный запуск через npx

Этот вариант подходит, если нужно понять, что такое workflow, node и execution. Он не решает вопросы HTTPS, автозапуска и backup.

npx n8n
# затем открыть http://localhost:5678

После первого запуска создайте простой workflow: Manual Trigger → Set/Edit Fields → Respond или Telegram. Цель — увидеть execution и структуру JSON. Не подключайте сразу CRM и платежи: сначала проверьте механику.

Локальная установка через Docker

Docker удобнее, потому что данные можно вынести в volume. Это важно: workflows, настройки и credentials не должны исчезать после удаления контейнера.

docker volume create n8n_data

docker run -it --rm   --name n8n   -p 5678:5678   -v n8n_data:/home/node/.n8n   docker.n8n.io/n8nio/n8n

Проверьте два действия: создать workflow, остановить контейнер и запустить снова. Если workflow остался на месте, volume подключён правильно.

n8n на Windows

На Windows лучше не ставить n8n “как обычную программу”. Самый спокойный путь — Docker Desktop или WSL2. Для обучения этого достаточно, но для публичных webhook и круглосуточной работы всё равно лучше Linux VPS.

  • Docker Desktop: проще старт, подходит новичку.
  • WSL2: ближе к Linux-среде, удобнее разработчику.
  • npm в Windows: возможен, но чаще создаёт проблемы с Node.js, путями и автозапуском.

Установка n8n на VPS

Для рабочего сервера нужны домен, HTTPS, постоянное хранилище и понятный план обновлений. Минимальная схема: n8n + PostgreSQL + reverse proxy. Если запусков много или есть долгие AI-задачи, добавляют Redis и workers.

  1. Подготовьте домен, например n8n.example.ru, и направьте A-запись на VPS.
  2. Создайте директорию проекта: /opt/n8n.
  3. Сохраните N8N_ENCRYPTION_KEY в .env и не меняйте его между обновлениями.
  4. Поднимите Docker Compose и проверьте логи.
  5. Откройте внешний URL и создайте владельца инстанса.
  6. Проверьте production webhook из внешней сети, а не с самого сервера.

Переменные, которые нельзя игнорировать

ПеременнаяЗачем нужна
N8N_ENCRYPTION_KEYШифрует credentials. Потеря ключа может сделать доступы нечитаемыми.
WEBHOOK_URLФиксирует внешний адрес для production webhook, особенно за reverse proxy.
GENERIC_TIMEZONE / TZНужны для расписаний, логов и понятного времени execution.
DB_TYPEДля production обычно выбирают PostgreSQL вместо SQLite.
EXECUTIONS_DATA_MAX_AGEПомогает не раздувать историю запусков бесконечно.

Проверка после установки

Не считайте установку законченной, пока не пройдены эти проверки:

  • workflow сохраняется после перезапуска контейнера;
  • credentials остаются доступными после обновления;
  • production webhook открывается с внешнего компьютера;
  • в логах нет циклических рестартов;
  • backup можно не только создать, но и восстановить в тестовую директорию;
  • на сервере закрыты лишние порты, а интерфейс n8n доступен только через HTTPS.

Типовые проблемы установки

  • n8n открывается локально, но webhook не работает. Проверьте домен, HTTPS, reverse proxy и WEBHOOK_URL.
  • После обновления не читаются credentials. Проверьте, не изменился ли N8N_ENCRYPTION_KEY.
  • Контейнер постоянно перезапускается. Начните с docker compose logs -f n8n, а не с переустановки.
  • Telegram или ЮKassa не достучались до n8n. Проверьте production URL из внешней сети и статус workflow.

Что дальше

Для постоянного сервера откройте руководство по Docker Compose или готовый production kit. Если цель — первый сценарий, начните с Telegram-интеграции или готового workflow для Telegram-бота.

Ответы на частые вопросы

Можно ли поставить n8n на обычный компьютер?

Да, для обучения и тестов. Для рабочих webhook, CRM и платежей лучше VPS с HTTPS, потому что внешний сервис должен стабильно отправлять события в n8n.

Что важнее всего сохранить?

N8N_ENCRYPTION_KEY, volume с данными, backup базы и файл Docker Compose. Без ключа шифрования восстановить credentials может быть невозможно.

Нужен ли PostgreSQL сразу?

Для первого локального теста — нет. Для production и долгой эксплуатации PostgreSQL предпочтительнее: проще backup, масштабирование и контроль данных.

Production-чеклист для установки n8n

Используйте этот блок как быстрый контроль перед публикацией workflow или изменением существующей автоматизации. Он не заменяет staging, но помогает поймать самые частые отказы заранее.

  • Перед запуском: проверить версию Node/Docker, домен, HTTPS и постоянный volume для данных.
  • Минимальный тест: открыть редактор, создать тестовый Manual Trigger и убедиться, что execution сохраняется.
  • Типовой отказ: потеря данных после перезапуска из-за временного volume или отсутствия encryption key.
  • Что логировать: входной payload без секретов, статус внешнего API, branch ошибки, execution id и владельца процесса.

Критерий готовности: сценарий проходит успешный путь, ошибочный путь и повтор события без дублей, потери данных и неконтролируемого падения execution.