Вебхук n8n на localhost: тестовый и рабочий адрес, туннель

Вебхук n8n на localhost:5678 через туннель: тестовый /webhook-test/ и рабочий /webhook/, 404 not registered, 500, N8N_WEBHOOK_URL и режимы Respond.

Опубликовано 15 минут чтения

  • n8n
  • вебхуки
  • localhost
  • туннель
  • автоматизация
Запрос к вебхуку n8n в ленте hook.csap.ru: ответ 500 от n8n через туннель

Чтобы вебхук пришёл в n8n на localhost:5678, нужен публичный адрес, который передаст запрос на ваш компьютер. Возьмите адрес приёма на hook.csap.ru и запустите webhooks tunnel --endpoint ВАШ_ТОКЕН --target http://localhost:5678. Запрос на https://hook.csap.ru/t/ВАШ_ТОКЕН/webhook/course/n8n102/new-order придёт в n8n как http://localhost:5678/webhook/course/n8n102/new-order, а ответ n8n вернётся отправителю.

Дальше всё решает адрес, на который отправлен запрос. У узла Webhook их два: тестовый /webhook-test/… принимает один запрос после нажатия «Listen for test event», рабочий /webhook/… работает только у опубликованного workflow. 404 от n8n в этой цепочке значит одно из трёх: запрос не на тот адрес (или тестовый уже не слушает), не тем методом или не на тот путь.

Ниже — настройка узла, туннель, проверка обоих адресов и таблица «код ответа → причина» с настоящими ответами n8n 2.43.7.

Тестовый и рабочий адрес

Тестовый: /webhook-test/<путь>Рабочий: /webhook/<путь>
Когда принимаетПосле «Listen for test event» в узле или запуска workflow кнопкой Execute на холсте (в подсказке n8n — Execute workflow)Пока workflow опубликован (в n8n до 2.0 — включён переключатель Active)
Сколько запросовОдин, затем снова 404Сколько угодно
Сколько ждёт120 секундПока workflow не снят с публикации
Где видны данныеПрямо в узле, на холстеВкладка Executions у workflow
Ответ, когда не слушает404, The requested webhook "<путь>" is not registered.404, The requested webhook "POST <путь>" is not registered.

Тестовый адрес принимает запрос и у опубликованного workflow, если в узле нажата «Listen for test event»: при проверке на 2.43.7 он ответил 200, а следующий запрос — снова 404.

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

  • n8n, запущенный на вашем компьютере. Порт по умолчанию — 5678, адрес редактора — http://localhost:5678.
  • Аккаунт на hook.csap.ru. Адрес приёма выдаётся и без регистрации, но туннель работает только после входа, в том числе на бесплатном тарифе.
  • curl, чтобы проверить цепочку до того, как запросы пойдут от настоящего отправителя.

Шаг 1. Узел Webhook: метод, путь, ответ

В узле Webhook задайте три поля.

  • HTTP Method — тот, которым шлёт отправитель. По умолчанию в узле стоит GET, и если отправитель шлёт POST, метод нужно сменить. На запрос не тем методом n8n отвечает 404: This webhook is not registered for GET requests. Did you mean to make a POST request?
  • Path — путь после /webhook/. По умолчанию n8n подставляет случайный, его можно заменить своим, например course/n8n102/new-order. Одна пара «путь + метод» принадлежит только одному опубликованному workflow.
  • Respond — когда и что отвечать отправителю. Варианты и настоящие ответы — в разделе «Что отвечает n8n» ниже.

В примере — workflow из двух узлов: Webhook (POST, course/n8n102/new-order, Respond: When Last Node Finishes) и Code с названием «Check order», который проверяет заказ:

javascript
const order = $input.first().json.body;
if (!order.order_id || typeof order.sum !== 'number') {
  throw new Error('order_id and numeric sum are required');
}
return [{ json: { ok: true, order_id: order.order_id } }];

С "sum": 1490 workflow отвечает {"ok":true,"order_id":"A-1001"}, со строкой "sum": "1490" узел Code падает, и n8n отвечает 500.

Шаг 2. Туннель до localhost:5678

Установка CLI на macOS и Linux:

bash
curl -fsSL https://hook.csap.ru/cli/install.sh | WEBHOOKS_BASE_URL=https://hook.csap.ru sh

Команда для Windows (PowerShell) и прямые ссылки на файлы — на странице туннеля. Вход:

bash
webhooks login --web --server https://hook.csap.ru

Откроется страница с кодом. Сверьте его с терминалом, нажмите «Продолжить», затем «Подтвердить вход». Новый адрес приёма создаёт webhooks endpoints create, список адресов и их токены показывает webhooks endpoints; токен — часть адреса после /t/. Туннель на порт n8n:

bash
webhooks tunnel --endpoint ВАШ_ТОКЕН --target http://localhost:5678

Путь после токена передаётся как есть, поэтому в адресе из узла Webhook достаточно заменить начало:

В узле WebhookКуда слать снаружи
http://localhost:5678/webhook/course/n8n102/new-orderhttps://hook.csap.ru/t/ВАШ_ТОКЕН/webhook/course/n8n102/new-order
http://localhost:5678/webhook-test/course/n8n102/new-orderhttps://hook.csap.ru/t/ВАШ_ТОКЕН/webhook-test/course/n8n102/new-order

Параметры запроса (?source=course), тело и заголовки отправителя доходят до n8n без изменений; Host становится адресом из --target.

Чтобы n8n сам показывал внешний адрес

Без настройки n8n собирает адрес вебхука из своего хоста и порта, и в узле видно http://localhost:5678/…. Документация n8n для работы за прокси предлагает задать адрес вручную переменной N8N_WEBHOOK_URL, тогда n8n покажет его в редакторе. Для туннеля это адрес приёма со слешем в конце:

bash
N8N_WEBHOOK_URL=https://hook.csap.ru/t/ВАШ_ТОКЕН/ npx n8n start

Прежнее имя переменной — WEBHOOK_URL; по документации, с 2.35.0 оно устарело, и n8n пишет об этом предупреждение. После перезапуска в узле на вкладках Test URL и Production URL — готовый внешний адрес, его можно копировать отправителю целиком. Сам n8n по-прежнему слушает localhost:5678, и редактор открывается там же, хотя при запуске n8n печатает внешний адрес как адрес редактора.

Шаг 3. Тестовый адрес

Откройте узел Webhook и нажмите «Listen for test event». Пока идёт ожидание, отправьте запрос:

bash
curl -s -w "\n%{http_code}\n" -X POST \
  "https://hook.csap.ru/t/ВАШ_ТОКЕН/webhook-test/course/n8n102/new-order?source=course" \
  -H "Content-Type: application/json" -H "User-Agent: course-shop/1.0" \
  -d '{"order_id":"A-1001","sum":1490}'

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

json
{"code":404,"message":"The requested webhook \"course/n8n102/new-order\" is not registered.","hint":"Click the 'Execute workflow' button on the canvas, then try again. (In test mode, the webhook only works for one call after you click this button)"}

Если переменная NODE_ENV не задана (так бывает при запуске через npx n8n), в теле ответа будет ещё поле stacktrace с трассировкой.

Шаг 4. Рабочий адрес

Рабочий адрес начинает принимать запросы после публикации workflow. В n8n 2.x это кнопка Publish вверху редактора; по описанию команд CLI, в 2.0 прежний переключатель active/inactive заменён публикацией. До публикации n8n отвечает:

json
{"code":404,"message":"The requested webhook \"POST course/n8n102/new-order\" is not registered.","hint":"The workflow must be active for a production URL to run successfully. You can activate the workflow using the toggle in the top-right of the editor. Note that unlike test URL calls, production URL calls aren't shown on the canvas (only in the executions list)"}

Подсказка в 2.43.7 всё ещё говорит о переключателе, хотя в интерфейсе вместо него кнопка Publish. Запросы на рабочий адрес на холсте не видны, их показывает вкладка Executions у workflow.

Три запроса через туннель после публикации — на тестовый адрес, на рабочий со строкой в sum и на рабочий с числом. В терминале (токен в выводе — пример со стенда):

код
туннель открыт: P6viZxc0GB2vFTNuB5qGDp → http://localhost:5678
12:09:57 8e16a5b0 POST    /webhook-test/course/n8n102/new-order → 404 (13ms)
12:09:58 0dbb5d3b POST    /webhook/course/n8n102/new-order → 500 (82ms)
12:09:59 8dfc74a5 POST    /webhook/course/n8n102/new-order → 200 (84ms)

404 — тестовый адрес не слушал. 500 и 200 — рабочий адрес: первый запрос со строкой "sum": "1490", второй с числом.

Что приходит в n8n

Узел Webhook выдаёт один элемент: заголовки, параметры пути, параметры запроса, тело, адрес вебхука и режим запуска. Запрос из шага 3 на рабочий адрес выглядел в n8n так:

json
{
  "headers": {
    "host": "localhost:5678",
    "user-agent": "course-shop/1.0",
    "content-length": "32",
    "accept": "*/*",
    "connection": "keep-alive",
    "content-type": "application/json",
    "accept-encoding": "gzip"
  },
  "params": {},
  "query": { "source": "course" },
  "body": { "order_id": "A-1001", "sum": 1490 },
  "webhookUrl": "http://localhost:5678/webhook/course/n8n102/new-order",
  "executionMode": "production"
}

В следующих узлах это {{ $json.body.order_id }}, {{ $json.query.source }}, {{ $json.headers['user-agent'] }}. Имена заголовков n8n приводит к нижнему регистру. executionMode — production для рабочего адреса. webhookUrl здесь снят без N8N_WEBHOOK_URL; с ней будет внешний адрес. host — localhost:5678: туннель обращается к n8n по адресу из --target.

Что отвечает n8n: режимы Respond

Ответы ниже сняты через туннель на одном и том же workflow «Webhook → Code» из шага 1.

RespondЗапрос верныйCode упал
Immediately200, {"message":"Workflow was started"}200, то же самое: ошибку отправитель не видит
When Last Node Finishes200, {"ok":true,"order_id":"A-1001"} — данные последнего узла500, {"message":"Error in workflow"}
Using 'Respond to Webhook' Nodeкод и тело из узла Respond to Webhook, например 201 и {"ok":true,"order_id":"A-1001"}500, {"message":"Error in workflow"}
Using 'Respond to Webhook' Node, а самого узла в workflow нет500, {"code":0,"message":"No Respond to Webhook node found in the workflow"}то же

Что из этого следует:

  • Immediately скрывает ошибки. Отправитель получает 200 до того, как workflow что-то сделал, и считает доставку успешной. Упавший запуск виден только в Executions.
  • Долгую работу ставьте после ответа. Узел Respond to Webhook сразу за Webhook отвечает отправителю, пока workflow продолжает работать: с узлом Wait на 35 секунд после него ответ 202 ушёл за 62 мс, а запуск закончился через 34 секунды.
  • 500 значит, что запрос дошёл до n8n по верному адресу, а ответить не удалось: workflow упал или не хватает узла Respond to Webhook. Причина — в запуске во вкладке Executions.

У When Last Node Finishes по умолчанию Response Data — First Entry JSON: в ответ уходит JSON первого элемента последнего узла.

500, потом 200: где смотреть

Если первый запрос получил 500, а следующий — 200, через туннель сразу видно, что оба запроса дошли до n8n: в карточке ленты «Ответ: 500 · tunnel», то есть ответил ваш n8n, а не сервис. Там же тело, на котором workflow упал, — здесь "sum": "1490" строкой.

Причину пишет n8n: откройте workflow → Executions → запуск со статусом Error. Упавший узел отмечен красным, текст ошибки — в сообщении.

Код ответа → причина → проверка

Что видноПричинаКак проверитьЧто сделать
404, The requested webhook "POST …" is not registered.Workflow не опубликован или опубликован с другим путёмПуть в строке туннеля и поле Path узлаОпубликовать (до 2.0 — включить Active), сверить путь
404, The requested webhook "…" is not registered. с подсказкой про Execute workflowЗапрос на /webhook-test/, а «Listen for test event» не нажата, прошло больше 120 с или вызов уже былТестовый ли адрес в строке туннеляНажать кнопку и повторить или слать на /webhook/
404, This webhook is not registered for <МЕТОД> requestsМетод запроса не совпадает с HTTP Method узла, в том числе адрес открыли в браузереМетод в строке туннеляПоменять метод в узле или у отправителя
500, {"message":"Error in workflow"}Узел упал, Respond — When Last Node Finishes или Respond to WebhookExecutions → запуск ErrorИсправить узел или данные
500, No Respond to Webhook node found in the workflowВыбран режим Respond to Webhook, а узла нетСостав workflowДобавить узел Respond to Webhook или сменить режим
200, {"message":"Workflow was started"}, а результата нетRespond: Immediately, workflow упал после ответаExecutions → запуск ErrorПереключить Respond на When Last Node Finishes, чтобы ошибка дошла до отправителя
502, в туннеле target.unreachablen8n не отвечает на адрес из --target: не запущен или на другом портуcurl http://localhost:5678/healthzЗапустить n8n или поправить --target
502, в туннеле target.timeout через 28 сWorkflow с When Last Node Finishes работает дольше 28 секундВремя в строке туннеляУзел Respond to Webhook сразу после Webhook, долгая работа — после него. Immediately тоже отвечает сразу, но скрывает ошибки
200, в ленте 200 · default, в n8n пустоТуннель не запущен, ответил сам адресСтрока «туннель открыт» в терминалеЗапустить туннель и повторить запрос (ниже)

Туннель был выключен: повторить запрос

Без туннеля отвечает сам адрес — если свой ответ у него не настроен, пустым 200, — и отправитель считает вебхук доставленным. Запрос при этом остаётся в ленте с пометкой «200 · default».

Запустите n8n и повторите запрос по номеру. Номера показывает webhooks tail:

код
$ webhooks tail --last 4 --compact
#36     12:09:57  POST    /webhook-test/course/n8n102/new-order    404      34 Б  127.0.0.1
#37     12:09:58  POST    /webhook/course/n8n102/new-order         500      34 Б  127.0.0.1
#38     12:09:59  POST    /webhook/course/n8n102/new-order         200      32 Б  127.0.0.1
#39     12:11:23  POST    /webhook/course/n8n102/new-order         200      32 Б  127.0.0.1

$ webhooks replay 39 --target http://localhost:5678 --show-body
POST http://localhost:5678/webhook/course/n8n102/new-order → 200 OK за 84ms, 31 Б
{"ok":true,"order_id":"A-1002"}

tail после списка ждёт новые запросы, выход — Ctrl+C. Строки #38 и #39 выглядят одинаково, хотя на первый ответил n8n, а на второй — сервис. Различает их строка «Ответ» в карточке ленты: tunnel или default. Повтор передаёт метод, путь, параметры, заголовки и тело, поэтому запрос попадает на тот же рабочий адрес n8n. replay шлёт запрос прямо с вашего компьютера на --target, туннель для этого не нужен. tail и replay без --endpoint работают, когда адрес у аккаунта один.

Вопросы

Почему n8n отвечает 404 webhook is not registered? Запрос пришёл не на тот адрес (или тестовый уже не слушает), не тем методом или не на тот путь. Тестовый /webhook-test/ слушает один запрос после «Listen for test event», рабочий /webhook/ — только у опубликованного workflow; метод по умолчанию в узле — GET.

Чем тестовый адрес n8n отличается от рабочего? Тестовый принимает один запрос и показывает данные прямо в узле, после 120 секунд ожидания снова отвечает 404. Рабочий принимает сколько угодно запросов, пока workflow опубликован; результаты — во вкладке Executions.

Как сделать, чтобы n8n показывал внешний адрес вместо localhost? Задать N8N_WEBHOOK_URL — адрес приёма со слешем в конце — и перезапустить n8n. Прежнее имя WEBHOOK_URL с n8n 2.35.0 устарело.

Почему отправитель получает 502 через 28 секунд? Workflow в режиме When Last Node Finishes не успел ответить. Поставьте узел Respond to Webhook сразу после Webhook и делайте долгую работу после ответа. Режим Immediately тоже отвечает сразу, но ошибки workflow отправитель тогда не увидит.

Что будет с запросом, если туннель выключен? Адрес ответит отправителю сам — без своих настроек пустым 200, — а запрос останется в ленте. Повторить его в n8n — webhooks replay НОМЕР --target http://localhost:5678, номер показывает webhooks tail.

Ещё по теме

Адрес для приёма выдаётся без регистрации на hook.csap.ru, туннель — после входа, тарифы — на странице тарифов.

Проверено 17.10.2026 на n8n 2.43.7 и сервисе hook.csap.ru.

Все руководства
Вкладка «Пересылка» в hook.csap.ru: три получателя одного адреса с разными условиями и состоянием доставок

Один вебхук, несколько систем: пересылка в CRM, n8n и свой сервер без кода

Как отправить один вебхук сразу в CRM, n8n и на свой сервер: получатели на одном адресе приёма, отбор по условиям, JSON по шаблону из формы Тильды, свой ключ API в заголовке и ограничение частоты для распродаж.

  • пересылка
  • несколько получателей
  • n8n
  • тильда
  • шаблон
  • интеграции
  • автоматизация
Cookie и Яндекс Метрика

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