Туннель на 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
$env:WEBHOOKS_BASE_URL='https://hook.csap.ru'; irm https://hook.csap.ru/cli/install.ps1 | iex
Скачать вручную
Контрольные суммы: 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 endpointswebhooks tailwebhooks tail <токен_адреса> --headers --last 50
webhooks tail --compact
webhooks tail --json | jq .
webhooks tail --forward http://localhost:3000/webhook
webhooks replay 42 --target http://localhost:3000
webhooks export <токен_адреса> -o requests.jsonl
webhooks export --since 24h -o requests.har
webhooks export --from 2026-09-01 --to 2026-09-08 -o week.jsonl
webhooks endpoints createwebhooks endpoints delete <токен_адреса>Обновление
Раз в сутки клиент сам проверяет, вышла ли новая версия, и напоминает об этом. Обновление ставится одной командой: она скачивает сборку под вашу систему, сверяет контрольную сумму и заменяет клиент. Если версия слишком старая, туннель откажет и попросит обновиться.
webhooks updateТуннель учитывает лимиты вашего тарифа. Подробнее на странице тарифов.