Как установить n8n: локально, через Docker и на VPS
Обновлено: 2026-05-29
Эта инструкция помогает выбрать способ установки n8n без лишней теории. Для знакомства подойдёт локальный запуск. Для постоянной автоматизации лучше сразу ставить n8n через Docker Compose на VPS: так проще обновляться, сохранять данные, подключать HTTPS и восстанавливать сервис после сбоя.
Какой способ выбрать
| Задача | Способ | Комментарий |
|---|---|---|
| Посмотреть интерфейс за 5 минут | npx n8n | Быстро, но не для постоянной работы. |
| Учиться на своём ПК | Docker с volume | Данные переживают перезапуск контейнера. |
| Работать 24/7 | VPS + 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.
- Подготовьте домен, например
n8n.example.ru, и направьте A-запись на VPS. - Создайте директорию проекта:
/opt/n8n. - Сохраните
N8N_ENCRYPTION_KEYв.envи не меняйте его между обновлениями. - Поднимите Docker Compose и проверьте логи.
- Откройте внешний URL и создайте владельца инстанса.
- Проверьте 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.