n8n установка и настройка: Docker, Telegram, AI-агенты

Что такое n8n и зачем он тебе нужен

Ты приходишь утром. Открываешь почту — там 40 писем с заявками. Открываешь CRM — половина не занесена. Открываешь Slack — там вопросы, на которые уже ответили в этих письмах. Три инструмента, три вкладки, руки делают работу, которую должна делать машина.

n8n это и есть та машина.

По факту — workflow-автоматизатор с визуальным редактором, 400+ готовыми интеграциями и встроенной поддержкой AI-агентов. Аналог Zapier и Make, но open-source и работает у тебя на сервере. Никакой абонентки, никакого лимита по задачам, никакого «ваши данные уехали на чужой сервер».

Что получишь от этой статьи:

• Запустишь n8n локально или на VPS за 10 минут
• Создашь первый workflow от триггера до действия
• Подключишь Telegram-бота и внешний API
• Поднимешь HTTPS через nginx
• Настроишь AI-агента с нейросетью
• Разберёшь частые ошибки и как их чинить

Времени нужно: 30-60 минут на полную установку и первый рабочий workflow.

Что нужно: Linux-сервер или локальная машина, Docker или Node.js 18+, базовое понимание командной строки.

Чем n8n отличается от аналогов

Запрос «n8n аналоги» в Google выдаст тебе Zapier, Make (бывший Integromat), Pipedream и ещё десяток сервисов. Вот честное сравнение:

Вывод простой: если у тебя есть сервер — n8n Community закрывает 95% задач бесплатно и без потолка. Если сервера нет и лень возиться — n8n Cloud Starter дешевле Zapier при сопоставимом функционале.

n8n установка через Docker — самый быстрый способ

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

Подготовка

Проверь, что Docker установлен:

docker --version
docker compose version

Должно вернуть что-то вроде Docker version 24.x и Docker Compose version v2.x. Если нет — поставь Docker по официальной документации для своей ОС.

Создай директорию для данных n8n:

mkdir -p ~/n8n/data

Шаг 1. Запуск одной командой

Для быстрого теста — просто запусти контейнер:

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

Результат: n8n поднимется на http://localhost:5678. Открой браузер, зарегистрируй аккаунт — готово.

Шаг 2. Docker Compose — правильная установка n8n

Создай файл конфигурации:

mkdir ~/n8n && cd ~/n8n
nano docker-compose.yml

Вставь содержимое:

version: "3.8"

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - N8N_ENCRYPTION_KEY=замени-на-случайную-строку-32-символа
      - GENERIC_TIMEZONE=Europe/Moscow
      - TZ=Europe/Moscow
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

Запусти:

docker compose up -d

Проверь что поднялось:

docker compose ps
docker compose logs n8n --tail=20

Результат: в логах должна быть строка Editor is now accessible via: http://localhost:5678/. Это значит n8n живёт.

Шаг 3. n8n с PostgreSQL для надёжного хранилища

По умолчанию n8n хранит данные в SQLite. Для нагруженного использования — переключись на PostgreSQL:

version: "3.8"

services:
  postgres:
    image: postgres:15
    restart: always
    environment:
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: сильный-пароль
      POSTGRES_DB: n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data

  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=yourdomain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - N8N_ENCRYPTION_KEY=замени-на-случайную-строку-32-символа
      - GENERIC_TIMEZONE=Europe/Moscow
      - TZ=Europe/Moscow
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=сильный-пароль
    depends_on:
      - postgres
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:
  postgres_data:

n8n установить без Docker — через npm

Если Docker не вариант — ставь через npm. Нужен Node.js 18 или выше.

# Проверь версию Node.js
node --version

# Установи n8n глобально
npm install -g n8n

# Запусти
n8n start

Для работы в фоне — поставь PM2:

npm install -g pm2
pm2 start n8n
pm2 save
pm2 startup

n8n HTTPS — настройка через nginx

Без HTTPS Telegram Webhook не подключишь, да и вообще в 2025 году HTTP на продакшне — это моветон.

Установи nginx и certbot

apt update && apt install -y nginx certbot python3-certbot-nginx

Создай конфиг nginx

nano /etc/nginx/sites-available/n8n

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 88400;
    }
}

# Активируй конфиг
ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx

# Получи SSL-сертификат
certbot --nginx -d yourdomain.com

Как работают ноды в n8n

Нода — это один блок в workflow. Нода принимает данные на вход, что-то с ними делает, отдаёт на выход. Соединяешь несколько нод — получаешь автоматизацию.

Три типа нод которые нужно знать в первую очередь:

Trigger-ноды запускают workflow. Webhook, Cron, Telegram Trigger, Email Trigger, Manual Trigger. Workflow начинается всегда с триггера.

Action-ноды что-то делают. HTTP Request, Send Email, Google Sheets, Telegram, Slack, Set, Code. Их больше 400.

Logic-ноды управляют потоком. IF (условие), Switch (несколько веток), Merge (объединить потоки), Loop Over Items (цикл по массиву), Wait (задержка).

Первый workflow в n8n — пошагово

Сделаем простое: триггер по расписанию → HTTP-запрос к API → отправка результата в Telegram.

Шаг 1. Создай новый workflow

Открой n8n. Нажми «New Workflow» в левом меню. Нажми «+» на канвасе — появится меню выбора ноды.

Шаг 2. Добавь триггер по расписанию

Найди «Schedule Trigger». Настрой интервал — например каждый час. Нода появится на канвасе.

Шаг 3. Добавь HTTP Request

Нажми «+» после Schedule Trigger. Выбери «HTTP Request». Настройки:

• Method: GET
• URL: https://api.coindesk.com/v1/bpi/currentprice.json

Нажми «Execute step» — увидишь данные о курсе Bitcoin в панели результатов справа.

Шаг 4. Добавь нodu Set для форматирования

После HTTP Request — нода «Edit Fields (Set)». Добавь поле:

• Name: message
• Value: Bitcoin: {{ $json.bpi.USD.rate }} USD

Шаг 5. Подключи Telegram

Добавь ноду «Telegram». Нажми «Credential for Telegram API» — создай новый. Вставь токен бота (получить у @BotFather). Настрой:

• Operation: Send Message
• Chat ID: твой chat_id
• Text: {{ $json.message }}

Шаг 6. Активируй workflow

В правом верхнем углу переключи тумблер «Inactive» в «Active». Workflow сохранится и запустится по расписанию.

n8n Telegram — подключение бота и обработка команд

Самый популярный сценарий использования n8n — боты в Telegram. Вот как подключить входящие сообщения.

Создай бота

Напиши @BotFather в Telegram, отправь /newbot, задай имя и юзернейм. Получишь токен вида 123456789:AAF....

Настрой Webhook

Зарегистрируй вебхук через Telegram API:

curl "https://api.telegram.org/bot<ТВОЙ_ТОКЕН>/setWebhook?url=https://yourdomain.com/webhook/telegram"

Ответ должен содержать "ok":true.

Создай workflow для обработки сообщений

В n8n создай новый workflow. Добавь ноду «Telegram Trigger» с твоими кредами. Она будет получать все входящие сообщения.

После — нода IF с условием:

{{ $json.message.text }} == "/start"

На ветку «True» — Telegram нода с ответом «Привет! Бот работает.»

На ветку «False» — ещё одна Telegram нода с эхо-ответом: Ты написал: {{ $json.message.text }}

n8n AI-агент — подключение нейросети

n8n встроил поддержку LangChain и AI-агентов начиная с версии 1.x. Это не просто «вызов OpenAI API» — это полноценный агент с памятью, инструментами и цепочкой рассуждений.

Шаг 1. Добавь ноду AI Agent

На канвасе выбери «AI Agent» из категории Advanced AI. Нода содержит три слота: Chat Model, Memory, Tools.

Шаг 2. Подключи OpenAI

В слот «Chat Model» перетащи ноду «OpenAI Chat Model». В настройках создай кред — вставь API-ключ от OpenAI. Выбери модель: gpt-4o или gpt-4o-mini для экономии.

Шаг 3. Добавь память

В слот «Memory» — нода «Window Buffer Memory». Параметр «Context Window Length» поставь 10 — агент будет помнить последние 10 сообщений диалога.

Шаг 4. Добавь инструменты

В слот «Tools» можно добавить любые ноды которые агент сможет вызывать самостоятельно. Например:

• «Calculator» — агент будет считать сам
• «HTTP Request Tool» — агент сможет делать запросы к API
• «Code Tool» — агент выполнит JS-код
• «Google Sheets Tool» — агент прочитает/запишет данные в таблицу

Перед связкой триггер → AI Agent добавь System Prompt через ноду «Set»:

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

n8n шаблоны — где брать готовые workflow

Писать всё с нуля не нужно. n8n имеет официальную библиотеку шаблонов на n8n.io/workflows — там 1000+ готовых workflow.

Самые популярные категории:

• AI и ChatGPT — обработка документов, суммаризация, RAG-системы
• CRM-автоматизация — синхронизация лидов, уведомления, скоринг
• DevOps — мониторинг сервисов, алерты, деплой по webhook
• E-commerce — обработка заказов, уведомления, отчёты
• Telegram-боты — поддержка, рассылки, команды

Импорт шаблона: открой нужный workflow на сайте, нажми «Use workflow», скопируй JSON. В n8n — «Import from URL» или вставь JSON вручную через «Import from File».

n8n Max — что это и чем отличается от Community

n8n существует в нескольких редакциях. Вот что реально отличается:

«n8n Max» в поиске часто подразумевает Enterprise-план или максимальную конфигурацию self-hosted. Для большинства задач — Community с самохостингом закрывает всё.

Проверка работоспособности n8n

Проверь статус контейнера

docker compose ps
# Должно показать: n8n   Up X hours

Проверь логи на ошибки

docker compose logs n8n --tail=50 | grep -i error

Проверь доступность интерфейса

curl -I http://localhost:5678
# Должен вернуть HTTP 200 или 301

Проверь выполнение workflow

В интерфейсе n8n открой «Executions» в левом меню. Там отображается история всех запусков с результатами. Зелёный статус — успех. Красный — нужно смотреть в детали ошибки.

Частые ошибки и как их чинить

n8n не запускается — порт занят

# Найди что занимает порт
lsof -i :5678
# или
ss -tulpn | grep 5678

# Убей процесс по PID
kill -9 PID

# Или поменяй порт в docker-compose.yml
# ports: - "5679:5678"

Webhook не получает данные от Telegram

# Проверь текущий вебхук Telegram
curl "https://api.telegram.org/bot<ТОКЕН>/getWebhookInfo"

# Переустанови вебхук
curl "https://api.telegram.org/bot<ТОКЕН>/setWebhook?url=https://yourdomain.com/webhook/telegram"

# Проверь что nginx проксирует правильно
curl -v https://yourdomain.com/webhook/telegram

n8n не подключается к PostgreSQL

# Посмотри логи
docker compose logs n8n | grep -i postgres

# Проверь доступность базы изнутри контейнера n8n
docker exec -it n8n_n8n_1 ping postgres

# Проверь переменные окружения
docker exec -it n8n_n8n_1 env | grep DB_

Workflow выдаёт ошибку «Cannot read properties of undefined»

Это значит что нода ожидает данные, которых нет. Смотри на входные данные ноды — нажми на красную ноду, открой панель «Input». Там видно что пришло. Скорее всего — путь к полю написан неправильно.

Проверь структуру данных через выражение в ноде «Set»:

{{ JSON.stringify($json) }}

Это выведет весь JSON на входе — сразу увидишь как выглядит структура.

Ошибка 502 Bad Gateway на nginx

# Проверь что n8n запущен
docker compose ps

# Проверь логи nginx
tail -50 /var/log/nginx/error.log

# Убедись что порт слушается
ss -tulpn | grep 5678

n8n скачать новую версию — обновление

cd ~/n8n

# Потяни новый образ
docker compose pull

# Перезапусти с новым образом
docker compose up -d

# Проверь версию
docker exec -it n8n_n8n_1 n8n --version

Профилактика — как не словить проблемы снова

Настрой автоматический бэкап

Данные n8n хранятся в Docker-томе. Бэкап тома раз в сутки — нормальная практика:

# Добавь в crontab
crontab -e

# Бэкап каждый день в 3 ночи
0 3 * * * docker run --rm -v n8n_n8n_data:/data -v /backup:/backup alpine tar czf /backup/n8n-$(date +%Y%m%d).tar.gz /data

Настрой мониторинг

Самый простой вариант — периодический health-check через сам n8n. Создай workflow: Cron каждые 5 минут → HTTP Request к http://localhost:5678/healthz → IF статус != 200 → отправь алерт в Telegram.

n8n мониторит сам себя. Рекурсивно, зато надёжно.

Ограничь доступ к интерфейсу

# В nginx добавь базовую аутентификацию или IP-whitelist
location / {
    allow 1.2.3.4;  # твой IP
    deny all;
    proxy_pass http://localhost:5678;
    ...
}

Настрой переменные окружения правильно

Никогда не хардкоди API-ключи прямо в нодах. В n8n есть «Credentials» — используй только их. Зашифрованы ключом N8N_ENCRYPTION_KEY, который задаёшь при установке.

Одна строка в crontab без комментария способна положить всё что ты выстраивал последние три дня. Документируй конфиг прямо в нём — через #.

n8n обучение — что изучить дальше

Когда базовый workflow работает — вот куда двигаться дальше:

• Expressions и встроенные функции — $json, $node, $workflow, методы работы со строками и датами
• Sub-workflows — выноси повторяющиеся блоки в отдельные workflow и вызывай их
• Error Workflow — отдельный workflow для обработки ошибок, который запускается автоматически при сбое
• Custom nodes — написание собственных нод на TypeScript если нужен интегратор которого нет в списке
• n8n API — управление workflow программно через REST API самого n8n

FAQ

Можно ли использовать n8n бесплатно без ограничений?

Да. Community Edition — полностью бесплатная, open-source, без лимитов по числу workflow, задач или пользователей. Единственное условие — сам хостишь на своём сервере. n8n Cloud бесплатен только в пробный период, потом от $20 в месяц.

Как проверить что n8n успешно запустился?

Три способа. Первый — открой браузер и зайди на http://localhost:5678, должна показаться форма входа. Второй — выполни curl -I http://localhost:5678 и жди HTTP 200. Третий — docker compose logs n8n --tail=20 и ищи строку «Editor is now accessible via».

Что если workflow запускается, но данные не приходят в Telegram?

Проверяй в таком порядке: статус выполнения workflow в разделе Executions, токен бота и chat_id в кредах Telegram, регистрацию вебхука через getWebhookInfo, наличие HTTPS если используешь Telegram Trigger. В 80% случаев — неверный chat_id или бот не является администратором в групповом чате.

Чем n8n отличается от Zapier?

Главное отличие — n8n self-hosted и open-source. Zapier всегда в облаке, данные проходят через их серверы, есть жёсткие лимиты на бесплатном плане. n8n поддерживает написание кода прямо в нодах на JavaScript и Python, что Zapier не умеет. При сопоставимой нагрузке n8n на своём VPS обходится в 5-10 долларов в месяц против $50+ у Zapier.

Как подключить n8n к локальной нейросети / LLM?

В n8n есть ноды для Ollama — это локальный запуск LLM без интернета. Добавь ноду «Ollama Chat Model», укажи адрес Ollama API (http://localhost:11434) и имя модели (llama3, mistral и т.д.). Подключи к AI Agent как Chat Model — агент будет работать полностью локально.

n8n скачать — откуда брать официальный образ?

Официальный Docker-образ: docker.n8n.io/n8nio/n8n. npm-пакет: npm install -g n8n. Исходники на GitHub: github.com/n8n-io/n8n. Не используй неофициальные образы с Docker Hub — только официальный реестр n8n.

Итог

У тебя теперь есть работающий n8n, первый workflow, подключённый Telegram-бот и понимание как строить AI-агентов. Это не туториал-однодневка — этой инсталляцией можно пользоваться в продакшне прямо сейчас.

Самое важное что n8n даёт — скорость. Автоматизация которая раньше требовала написать скрипт, настроить крон и задеплоить — теперь делается за 15 минут через визуальный редактор. Это реально меняет то как ты работаешь с рутиной.