wbstorm

Как поставить n8n локально: Docker или npm и первый Webhook

Запустите n8n через Docker или npx, откройте порт 5678, поставьте Webhook и поймайте первый запрос на Test URL.

Чтобы ввести HTTP в автоматизацию, облачное место не обязательно. n8n работает на машине: редактор в браузере, данные по умолчанию локально.

По документации поставьте n8n локально через Docker или npm, откройте localhost:5678 и соберите первый Webhook. Это инструкция по инструментам разработчика, не руководство по мозговому штурму.

УстановкаРедакторWebhook

Выберите один путь установки

См. docs.n8n.io/hosting/installation. Для ноутбука — Docker или Node. Postgres и очередь позже.

5678
Порт редактора
2 пути
Официальный старт
Webhook
Первый воркфлоу
СпособНужноКогда
DockerDocker EngineИменованный том, легко снести
npx / npmподдерживаемый Node LTSБез контейнера, только редактор
n8n CloudРегистрация в браузереБез локального процесса; не эта статья

Пять шагов до первого Webhook

  1. 1

    Запустите Docker или npm

    Docker: 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. Node: npx n8n в пустой папке или глобально плюс n8n start. Теги меняются — сверяйтесь с docs.n8n.io.

  2. 2

    Откройте редактор и создайте owner

    http://localhost:5678. Первый заход: email и пароль. Этот пользователь владеет экземпляром, не облачным планом. Мастер можно пропустить, пустой холст достаточен.

  3. 3

    Новый воркфлоу, узел Webhook

    New workflow. Узел Webhook. HTTP Method POST. Path случайный или hello. Секреты продакшена пока не подключайте.

  4. 4

    Listen и curl на Test URL

    Listen for test event, скопируйте Test URL. Во втором терминале: curl -X POST TEST_URL -H 'Content-Type: application/json' -d '{"ping":true}'. Listen остановится, JSON появится.

  5. 5

    Ответ, затем решение про Activate

    Set или Respond to Webhook с {"ok":true}. На ноутбуке оставайтесь на Test URL. Стабильный адрес: сохранить, Activate, Production URL. 5678 по умолчанию не публичный.

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

# или: npx n8n
# затем http://localhost:5678

Три части редактора сначала

01

Холст и узлы

Узел — шаг: триггер, преобразование, выход. Webhook — триггер. Справа: method, path, auth.

02

Test URL и Production URL

Тест жив только при Listen. Продакшен требует Active. Путаница даёт 404 или пустой ответ.

03

Учётные данные и env

Чужие ключи в Credentials, не в полях узла. Конфиг в .n8n. Папку не коммитить.

Частые ямы

Порт занят: -p 5679:5678 или остановите старый контейнер. Нужен том Docker, иначе --rm сотрёт воркфлоу. Старый Node валит npx n8n — берите поддерживаемый LTS.

Когда поток работает и нужен набросок, wbstorm — ID комнаты: создать или войти в комнату, основы доски, как писать Cursor Rules.

Обязателен ли Docker?

Нет. Документация также описывает npm. npx быстрее, если нужен только редактор. Docker и именованный том — если экземпляр должен быть одноразовым.

Почему Test URL отвечает 404?

Вкладка открыта и Webhook в Listen. Закрытая вкладка или нет Listen — тестовый адрес не принимает запрос.

Это то же, что n8n Cloud?

Редактор похож. Хостинг и оплата нет. Cloud не использует ваш локальный порт. Эта статья — только self-host на localhost.

Это функция wbstorm?

Нет. Только локальный n8n и Webhook. wbstorm — комната мозгового штурма в браузере и к рантайму автоматизации не относится.

Начать бесплатную встречу