n8n: что это, как установить в Docker, цены и примеры

n8n (читается «эн-эйт-эн», сокращение от nodemation) называют конструктором автоматизаций. Сценарий собирается из блоков-нод в визуальном редакторе: одна нода принимает вебхук, другая пишет строку в Google Sheets, третья отправляет сообщение в Telegram или вызывает ИИ-модель. Делает n8n немецкая компания n8n GmbH из Берлина.

Работать с n8n можно двумя способами. Облако n8n Cloud платное, от 20 € в месяц при оплате за год. Своя установка бесплатна: Community Edition ставится в Docker на любой VPS, и платите вы только за сервер. Ниже три способа установки с рабочими командами и четыре первых сценария для арбитражника.

Что такое n8n простыми словами

Главная единица в n8n: workflow, то есть сценарий. Он всегда начинается с триггера: входящий вебхук, расписание, сообщение боту, новая строка в таблице. За триггером идут ноды, которые обрабатывают данные и передают их дальше.

• Ноды. На главной n8n.io заявлено более 500 встроенных интеграций. Для сервиса без готовой ноды есть HTTP Request: он вызывает любой API.
• Credentials. Токены и ключи хранятся отдельно от сценария в зашифрованном виде, ноды ссылаются на них по имени.
• Executions. Каждый запуск попадает в журнал: видно, какая нода упала и с какими данными.
• Code. Если готовых нод не хватает, в ноде Code пишут JavaScript или Python.
• ИИ. Нода AI Agent подключает языковую модель, память и инструменты. Из неё собирают чат-ботов и агентов.

С версии 2.0 сценарий не «включают», а публикуют: кнопка Publish заменила старый переключатель Active. Правки сохраняются как черновик и попадают в работу только после новой публикации (документация).

Готовые сценарии лежат в библиотеке n8n.io/workflows: на 1 октября 2026 там 12 798 шаблонов от сообщества. Нашу подборку одним архивом смотрите в статье 450+ шаблонов n8n для скачивания.

Важно в октябре 2026. На этот месяц запланирован выпуск n8n 3.0. Своя установка будет работать только через Docker: npm и npx n8n перестанут поддерживаться. Из 3.0 уберут старые ноды Function, Function Item, Cron, Interval, Item Lists и ещё два десятка. Перед обновлением откройте Settings → Migration Report (список изменений 3.0).

Бесплатный ли n8n: лицензия и цены

Код n8n открыт, но лицензия не open source в классическом смысле. Это Sustainable Use License по модели fair-code (описание лицензии). Бесплатная установка на своём сервере разрешает:

• автоматизировать свой бизнес, личные и учебные проекты;
• собирать сценарии для клиентов на своём сервере, если клиенты не могут их создавать и править;
• брать деньги за настройку, поддержку, обучение и консультации;
• использовать n8n внутри своего продукта, где пользователи только запускают готовые сценарии.

Запрещено: продавать доступ к n8n как к сервису, в котором клиенты сами строят сценарии, делать white-label без брендинга n8n и включать функции Enterprise без лицензии (FAQ по лицензии). Команде, которая автоматизирует свою работу, бесплатной версии хватает.

Цены на 1 октября 2026 по странице n8n.io/pricing:

Облако можно попробовать 14 дней без карты. n8n считает целое выполнение сценария, а не каждый шаг. Сценарий, который срабатывает каждые 5 минут, даёт около 8 600-8 900 выполнений в месяц: это больше лимита Starter. Каждый входящий постбэк тоже отдельное выполнение.

Облако или свой сервер

Если вы не администрируете серверы, n8n сама советует облако. Если сценарии работают постоянно (постбэки, боты, ежечасные отчёты), выполнения в облаке быстро кончаются, а свой сервер стоит фиксированно. Готовый вариант без ручной установки есть у Beget: VPS с предустановленным n8n, конфигурация 2 ядра, 2 ГБ, 30 ГБ, 32 ₽ в день на 1 октября 2026. Файлы установки лежат в /opt/beget/n8n, порядок обновления описан в базе знаний Beget.

Установка n8n через Docker

n8n рекомендует Docker для большинства случаев, а с версии 3.0 это единственный поддерживаемый способ для своей установки. Подойдёт любой из трёх вариантов ниже.

Что понадобится

• Docker Engine и плагин Docker Compose v2. Для Ubuntu ставьте по официальной инструкции Docker через apt-репозиторий. На Windows и macOS подойдёт Docker Desktop.
• Для сервера: VPS и поддомен, например n8n.example.com, с A-записью на IP сервера.
• Проверка, что всё на месте: docker --version и docker compose version.

Вариант 1. Попробовать на своём компьютере

Команды из документации n8n. Первая создаёт том для данных, вторая скачивает образ и запускает контейнер:

docker volume create n8n_data

docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e GENERIC_TIMEZONE="Europe/Moscow" \
 -e TZ="Europe/Moscow" \
 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
 -v n8n_data:/home/node/.n8n \
 n8nio/n8n

Откройте http://localhost:5678 и создайте аккаунт владельца. Сценарии и ключи хранятся в томе n8n_data, поэтому переживут остановку контейнера. В PowerShell обратный слеш не переносит строку: запишите docker run одной строкой. Переменная N8N_RUNNERS_ENABLED, которая есть в старых инструкциях, с версии 2.0 не нужна.

Вариант 2. Официальный скрипт одной командой

Новый официальный способ, которым n8n заменяет установку через npm: установка одной командой.

curl -fsSL https://get.n8n.io | sh

Скрипт проверит Docker, создаст папку n8n с файлами compose.yml и .env и запустит n8n вместе с песочницей для встроенного ИИ-помощника n8n Assistant. Нужен именно плагин docker compose v2, на Windows скрипт запускают из WSL. Для этого набора n8n указывает минимум 4 ГБ памяти и 2 vCPU. Обновление: curl -fsSL https://get.n8n.io | sh -s -- --upgrade. Скрипт открывает n8n на порту 5678 без HTTPS, поэтому для сервера с доменом удобнее третий вариант.

Вариант 3. Сервер с доменом и HTTPS

Основа взята из инструкции n8n для Docker Compose. Traefik получает сертификат Let’s Encrypt и проксирует запросы в n8n. Внесены три правки: убраны метки SSLRedirect и SSLHost (в Traefik v3 их больше нет, с ними Traefik пропускает контейнер), адрес вебхуков задан новой переменной N8N_WEBHOOK_URL и добавлен N8N_PROXY_HOPS=1, как требует документация для работы за прокси.

1. Создайте A-запись n8n на IP сервера. Запись должна вести прямо на сервер: Let’s Encrypt проверяет домен по порту 443.
2. Создайте папку проекта и папку для файлов:

   mkdir n8n-compose
   cd n8n-compose
   mkdir local-files

3. Создайте файл .env со своими значениями:

   DOMAIN_NAME=ВАШ_ДОМЕН.com
   SUBDOMAIN=n8n
   GENERIC_TIMEZONE=Europe/Moscow
   SSL_EMAIL=ВАШ_EMAIL@ВАШ_ДОМЕН.com

4. Создайте файл compose.yaml:

   services:
     traefik:
       image: "traefik:v3"
       restart: always
       command:
         - "--providers.docker=true"
         - "--providers.docker.exposedbydefault=false"
         - "--entrypoints.web.address=:80"
         - "--entrypoints.web.http.redirections.entryPoint.to=websecure"
         - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
         - "--entrypoints.websecure.address=:443"
         - "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
         - "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
         - "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
       ports:
         - "80:80"
         - "443:443"
       volumes:
         - traefik_data:/letsencrypt
         - /var/run/docker.sock:/var/run/docker.sock:ro
   
     n8n:
       image: n8nio/n8n:2.41.4
       restart: always
       ports:
         - "127.0.0.1:5678:5678"
       labels:
         - traefik.enable=true
         - traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
         - traefik.http.routers.n8n.entrypoints=websecure
         - traefik.http.routers.n8n.tls=true
         - traefik.http.routers.n8n.tls.certresolver=mytlschallenge
         - traefik.http.middlewares.n8n.headers.STSSeconds=315360000
         - traefik.http.middlewares.n8n.headers.STSIncludeSubdomains=true
         - traefik.http.middlewares.n8n.headers.STSPreload=true
         - traefik.http.middlewares.n8n.headers.forceSTSHeader=true
         - traefik.http.middlewares.n8n.headers.contentTypeNosniff=true
         - traefik.http.middlewares.n8n.headers.browserXSSFilter=true
         - traefik.http.routers.n8n.middlewares=n8n@docker
       environment:
         - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
         - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
         - N8N_PORT=5678
         - N8N_PROTOCOL=https
         - NODE_ENV=production
         - N8N_WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
         - N8N_PROXY_HOPS=1
         - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
         - TZ=${GENERIC_TIMEZONE}
         - N8N_RESTRICT_FILE_ACCESS_TO=/files
       volumes:
         - n8n_data:/home/node/.n8n
         - ./local-files:/files
   
   volumes:
     n8n_data:
     traefik_data:

5. Запустите: sudo docker compose up -d. Когда Traefik получит сертификат, откройте https://n8n.ВАШ_ДОМЕН.com и создайте аккаунт владельца. Если страница не открывается, смотрите журнал: sudo docker compose logs traefik.

Версия образа закреплена: 2.41.4 стабильная на 1 октября 2026, свежую смотрите на странице релизов. Без закрепления docker compose pull однажды поставит 3.0 без вашей проверки. Порт 5678 открыт только на 127.0.0.1, наружу смотрят 80 и 443. Это важно: порты, которые публикует Docker, обходят правила ufw.

Обновление и резервная копия

Перед обновлением n8n советует сделать полный бэкап. Это том с папкой .n8n, где лежит ключ шифрования credentials, плюс база PostgreSQL, если вы её подключали. Без ключа сохранённые доступы из бэкапа не расшифровать (документация по бэкапам). Само обновление: поменяйте версию в строке image и выполните

docker compose pull
docker compose down
docker compose up -d

Сценарии можно дополнительно выгрузить в JSON, по файлу на сценарий. Команду запускайте из папки с compose.yaml:

sudo docker compose exec -u node n8n n8n export:workflow --backup --output=/home/node/.n8n/backups/workflows/

Файлы окажутся в томе n8n_data. Такая выгрузка не содержит пользователей, историю выполнений и ключ шифрования, поэтому сам том всё равно копируйте.

Первые сценарии для арбитражника

Четыре сценария ниже собираются из стандартных нод, код понадобится только в третьем. Они закрывают самую частую рутину: постбэки, заявки, сводки и контроль ошибок. Адреса вида https://n8n.ВАШ_ДОМЕН/webhook/... рабочие, /webhook-test/... тестовые.

1. Постбэк из Keitaro в таблицу и Telegram

1. Добавьте ноду Webhook: HTTP Method GET, Path keitaro-postback, Respond Immediately. Трекеру достаточно ответа 200.
2. В Options ноды добавьте Only Run If с выражением {{ $json.query.token === 'СЕКРЕТНАЯ_СТРОКА' }}. Запрос без верного токена получит ответ 200, но выполнение не создастся. Если знаете IP трекера, добавьте его в IP(s) Allowlist.
3. Добавьте Google Sheets с операцией Append or Update Row. Столбцы: subid, status, revenue, campaign, updated. Ключ сопоставления (Column to Match On): subid. Значения: {{ $json.query.subid }}, {{ $json.query.status }} и так далее, в updated {{ $now.toISO() }}. Когда по той же конверсии придёт новый статус, строка обновится, дубля не будет.
4. Добавьте If с условием {{ $('Webhook').item.json.query.status }} равно sale и на ветку true ноду Telegram с операцией Send Message. Текст: Продажа: {{ $('Webhook').item.json.query.campaign }}, доход {{ $('Webhook').item.json.query.revenue }}. Chat ID проще всего взять из ноды Telegram Trigger или у бота @RawDataBot. Подпись «This message was sent automatically with n8n» выключается в Additional Fields переключателем Append n8n Attribution.
5. Опубликуйте сценарий кнопкой Publish.
6. В Keitaro откройте кампанию, вкладку S2S Postbacks, нажмите «Добавить», выберите метод GET и статусы (справка Keitaro). URL:

   https://n8n.ВАШ_ДОМЕН/webhook/keitaro-postback?token=СЕКРЕТНАЯ_СТРОКА&subid={subid}&status={status}&revenue={conversion_revenue}&campaign={campaign_name}

Перед подключением трекера нажмите в ноде Webhook «Listen for test event» и за 120 секунд отправьте тестовый запрос:

curl "https://n8n.ВАШ_ДОМЕН/webhook-test/keitaro-postback?token=СЕКРЕТНАЯ_СТРОКА&subid=test1&status=sale&revenue=10&campaign=test"

Keitaro экранирует значения макросов, поэтому пробелы и кириллица в названии кампании дойдут без поломки адреса. Что ушло и что ответил n8n, видно в трекере в разделе «Обслуживание → Логи → S2S postbacks». Если те же конверсии нужно отдать в Meta, у нас есть отдельный разбор Keitaro и Facebook Conversions API со скриптом.

2. Заявки с лендинга в Telegram

1. Нода Webhook: метод POST, Path lead, Authentication Header Auth. В credential задайте имя заголовка, например X-Api-Key, и длинное случайное значение.
2. Нода Google Sheets с операцией Append Row сохраняет заявку, нода Telegram присылает её менеджеру: Заявка: {{ $json.body.name }}, {{ $json.body.phone }}, оффер {{ $json.body.offer }}.
3. Отправляйте копию заявки из серверного обработчика формы (например, PHP), а не из JavaScript в браузере, иначе ключ увидит любой посетитель.

curl -X POST "https://n8n.ВАШ_ДОМЕН/webhook-test/lead" \
  -H "X-Api-Key: СЕКРЕТНЫЙ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"name":"Тест","phone":"+70000000000","offer":"test"}'

Дубли лучше отсекать ещё до n8n, на стороне лендинга: как это сделать, разбирали в статье про фильтрацию дублей лидов.

3. Telegram-бот со сводкой за день

Бот отвечает на команду /today сводкой из таблицы, которую заполняет первый сценарий.

1. Создайте бота у @BotFather командой /newbot и добавьте токен в Telegram credentials.
2. Нода Telegram Trigger, событие Message. В Options укажите Restrict to User IDs, чтобы бот отвечал только вашим сотрудникам.
3. Нода If: {{ $json.message.text }} равно /today.
4. Нода Google Sheets, операция Get Row(s), тот же лист.
5. Нода Code (JavaScript, режим Run Once for All Items) считает итог:

   const today = $now.toISODate();
   const rows = $input.all()
     .map(item => item.json)
     .filter(row => String(row.updated).startsWith(today));
   const sales = rows.filter(row => row.status === 'sale');
   const revenue = sales.reduce((sum, row) => sum + Number(row.revenue || 0), 0);
   
   return [{ json: { text: `За ${today}: постбэков ${rows.length}, продаж ${sales.length}, доход ${revenue}` } }];

6. Нода Telegram, Send Message: Chat ID {{ $('Telegram Trigger').first().json.message.chat.id }}, текст {{ $json.text }}.

Telegram Trigger работает через вебхук, поэтому ему нужен HTTPS. Для отладки удобнее завести второго, тестового бота (почему, см. таблицу ошибок ниже).

4. Уведомления об ошибках сценариев

Создайте отдельный сценарий: нода Error Trigger, за ней Telegram с текстом Упал {{ $json.workflow.name }}: {{ $json.execution.error.message }} {{ $json.execution.url }}. Затем в каждом рабочем сценарии откройте Settings и выберите его в поле Error Workflow. Публиковать сценарий с Error Trigger не нужно, а проверить его ручным запуском нельзя: он срабатывает только на ошибках автоматических выполнений (документация).

Похожие готовые сценарии (ошибки в Telegram, бэкап сценариев в GitHub, ИИ-боты для Telegram) есть в нашем архиве шаблонов n8n.

Вебхуки в n8n: что важно знать

У ноды Webhook два адреса (документация ноды):

• Когда отвечать. Immediately отвечает сразу фразой «Workflow got started». When Last Node Finishes возвращает данные последней ноды. Режим Using Respond to Webhook Node отдаёт ответ, который вы соберёте сами. Для постбэков и форм хватает Immediately: источник не ждёт, пока отработают таблица и Telegram.
• Защита. Basic Auth, Header Auth или JWT, список разрешённых IP и условие Only Run If. За обратным прокси задайте N8N_PROXY_HOPS, иначе allowlist будет видеть IP прокси.
• Ограничения. Тело запроса до 16 МБ, на своём сервере лимит меняется переменной N8N_PAYLOAD_SIZE_MAX. На одну пару «путь + метод» можно повесить только один вебхук.
• Долгие задачи. В n8n Cloud запрос, на который нет ответа 100 секунд, падает с ошибкой 524. Отвечайте сразу, а результат отдавайте вторым вебхуком или сообщением.
• Повторы. Источник может прислать одно и то же событие дважды, а постбэк по конверсии приходит при каждой смене статуса. Пишите данные операцией «добавить или обновить» по ключу (subid, ID заявки), а не простым добавлением строки.

Как собрать сценарий, который не ломается

Ломкие сценарии обычно смешивают на одном полотне приём данных, логику и обработку сбоев. Помогает простая схема:

1. Вход. Триггер и сразу проверка обязательных полей нодой If или Filter. Плохие данные отсекаются до записи в таблицы.
2. Логика. Запросы к API, расчёты, маршрутизация. Длинные куски выносите в отдельные сценарии и вызывайте нодой Execute Sub-workflow.
3. Результат. Запись, уведомление, ответ источнику.
4. Ошибки. На нодах с внешними API включите в Settings Retry On Fail. Если сбой одной ноды не должен останавливать всё, выберите On Error → Continue (using error output) и обработайте ошибку отдельной веткой. Для остального есть Error Workflow из сценария 4.

В настройках сценария можно выбрать, сохранять ли успешные и неудачные выполнения. На своём сервере n8n по умолчанию удаляет выполнения старше 14 дней или сверх 10 000 штук (настройки хранения).

Queue mode: когда одного процесса мало

По умолчанию n8n работает одним процессом: он принимает вебхуки, держит редактор и выполняет сценарии. Если тяжёлый сценарий начинает тормозить остальные, есть два шага.

Шаг 1: лимит одновременных выполнений. В обычном режиме n8n не ограничивает число параллельных рабочих выполнений. Переменная N8N_CONCURRENCY_PRODUCTION_LIMIT=20 включает очередь: лишние выполнения ждут и идут по порядку. Лимит касается только запусков от вебхуков и триггеров, ручные запуски и подпроцессы он не трогает (документация).

Шаг 2: queue mode. Главный процесс принимает вебхуки и таймеры, но сам сценарии не выполняет. Он кладёт ID выполнения в Redis, а воркеры забирают задачи, берут сценарий из базы и пишут результат обратно (документация).

• Нужны Redis и PostgreSQL: с SQLite такая схема не поддерживается.
• На главном процессе и воркерах задаются EXECUTIONS_MODE=queue, адрес Redis (QUEUE_BULL_REDIS_HOST, QUEUE_BULL_REDIS_PORT) и общий N8N_ENCRYPTION_KEY, иначе воркеры не расшифруют credentials.
• Воркер запускается командой n8n worker. По умолчанию он берёт 10 задач одновременно (флаг --concurrency), n8n советует не ставить меньше 5.
• Хранение файлов в режиме filesystem queue mode не поддерживает, для бинарных данных нужен S3.
• Queue mode есть в бесплатной Community Edition. Платная только схема с несколькими главными процессами (multi-main).

Queue mode добавляет в схему Redis, Postgres и несколько контейнеров. Включайте его, когда лимита из первого шага уже не хватает.

Безопасность

• Только HTTPS. По умолчанию N8N_SECURE_COOKIE=true: cookie входа передаются только по HTTPS. Не отключайте настройку, а поставьте домен с сертификатом, как в варианте 3.
• Ключи только в Credentials. Экспортированный JSON содержит имена и ID credentials, а HTTP Request, созданный импортом cURL, может хранить заголовок авторизации. Чистите файл, прежде чем делиться. С версии 2.0 нода Code по умолчанию не видит переменные окружения.
• Чужие шаблоны читайте до импорта. Шаблон может отправлять данные на сторонний адрес через HTTP Request или выполнять команды на сервере. Ноды Execute Command и Local File Trigger с версии 2.0 выключены по умолчанию, включайте их только при реальной необходимости.
• Двухфакторный вход и обновления. Включите 2FA для пользователей и обновляйтесь: новая минорная версия n8n выходит почти каждую неделю.

Частые ошибки

Если n8n работает в связке с трекером, полезно понимать и его возможности: сравнение Keitaro, Binom и AIO есть в обзоре трекеров для арбитража.

Частые вопросы