Туннель на localhost для вебхуков

Вебхук из интернета приходит прямо в сервис на вашем компьютере, а его ответ уходит обратно отправителю. CLI сам открывает защищённое соединение, поэтому туннель работает за NAT, без белого IP и проброса портов. Нужен аккаунт, бесплатный тоже подойдёт.

Замена ngrok для вебхуков

Из России клиент ngrok не подключается: он отвечает ошибкой ERR_NGROK_9040. По документации ngrok компания из США не обслуживает страны под санкциями и исключений не делает. Этот туннель подключается из России, оплата российской картой в рублях.

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

Для другого туннель не подойдёт. Он принимает HTTP-запросы на адрес приёма и не открывает сайт целиком для показа заказчику, игровой сервер, SSH или WebSocket. Для этого нужен туннель общего назначения.

1. Установите CLI

Одна команда: установщик скачает клиент под вашу систему, сверит контрольную сумму и положит его в PATH. Права администратора не нужны.

curl -fsSL https://hook.csap.ru/cli/install.sh | WEBHOOKS_BASE_URL=https://hook.csap.ru sh
Скачать вручную

Контрольные суммы: SHA256SUMS. Версия клиента означает дату и время сборки, её показывает webhooks version.

2. Войдите

Команда откроет страницу кабинета с кодом: сверьте код с терминалом и нажмите «Продолжить», затем «Подтвердить вход». CLI получит токен сам, копировать ничего не нужно. На сервере без браузера (по SSH) добавьте --no-browser и откройте ссылку на своём компьютере.

вход через браузер
webhooks login --web --server https://hook.csap.ru

Можно и по токену: создайте его в разделе API-токены и вставьте, когда команда попросит (выбор «2»): ввод скрыт и не попадает в историю команд. В скриптах токен передают переменной WEBHOOKS_TOKEN.

вход
webhooks login --server https://hook.csap.ru

3. Запустите туннель

Укажите адрес приёма (--endpoint обязателен: это токен адреса из ленты, последняя часть адреса после /t/) и локальную цель. Запросы начнут приходить в ваш сервис. Пока туннель подключён, отвечает ваш сервис, правила адреса не применяются. Если локальный сервер проверяет заголовок Host, подмените его через --header-rewrite (можно несколько раз); приставку пути убирает --strip-prefix, а добавляет --add-prefix.

туннель
webhooks tunnel --endpoint <токен_адреса> --target http://localhost:3000 \
    --header-rewrite Host=localhost:3000

Ещё команды

В tail и export адрес приёма передают просто аргументом или через --endpoint; вместо токена подойдёт и полный адрес приёма, а если адрес у аккаунта один, его можно не указывать. В replay аргументом передают номер запроса из ленты (42 или #42). Справка по любой команде: webhooks <команда> -h.

список адресов
webhooks endpoints
лента запросов в терминале
webhooks tail
лента с заголовками, последние 50
webhooks tail <токен_адреса> --headers --last 50
строка на запрос, без тела
webhooks tail --compact
JSON для jq и скриптов
webhooks tail --json | jq .
пересылать новые запросы на свой адрес
webhooks tail --forward http://localhost:3000/webhook
повторить запрос на свой адрес
webhooks replay 42 --target http://localhost:3000
выгрузить историю (JSON Lines)
webhooks export <токен_адреса> -o requests.jsonl
выгрузить за сутки в HAR (открывается в DevTools браузера)
webhooks export --since 24h -o requests.har
выгрузить за период
webhooks export --from 2026-09-01 --to 2026-09-08 -o week.jsonl
завести новый адрес
webhooks endpoints create
удалить адрес с его запросами
webhooks endpoints delete <токен_адреса>

Обновление

Раз в сутки клиент сам проверяет, вышла ли новая версия, и напоминает об этом. Обновление ставится одной командой: она скачивает сборку под вашу систему, сверяет контрольную сумму и заменяет клиент. Если версия слишком старая, туннель откажет и попросит обновиться.

обновить клиент
webhooks update

Туннель учитывает лимиты вашего тарифа. Подробнее на странице тарифов.

Cookie и Яндекс Метрика

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