☰
22.04.2025

Ngrok: установка и политики трафика

Для настройки собственного сервера с белым адресом нужно не мало затрат: подготовить DNS-имя, выкупить белый адрес или VPS/VDS, настроить проброс через NAT. И самое главное не всегда понятно, как это все поддерживать без книжки по сетям и сетевым технологиям. Создатели сервиса Ngrok решили эту проблему предоставив свои сервера в качестве публичных точек для подключения, со всеми ранее описанными благами!

Что такое Ngrok и как его установить?

Ngrok - это сервер в публичной сети, у которого уже в заранее настроены доменное имя, есть статический адрес для подключения, позволяющий перенаправлять трафик с него на ваше локальное устройство путем туннелирования. Схематически это выглядит так:

Скриншот №1 — Схема

На локальный и публичный сервер устанавливаются агент и сервис, соответственно. После чего агент в точках под номерами 2-3 соединяется с публичной точкой Ngrok, теперь у них открыто соединение, которое можно использовать для передачи трафика в две стороны. Из сети приходит запрос к веб-приложению. После чего по правилам перенаправления в публичном узле, под номером 4. Трафик направляется в открытое соединение сервиса и попадает в агент, где распаковывается и передается веб-приложению!

Чтобы настроить сетевое соединение необходимо создать аккаунт на официальном сайте, после чего скопировать ключ!

Скриншот №2 — Ключ

Его будем использовать для аутентификации агента в reverse-прокси, скачаем ngrok через snap менеджер:

apt update && apt install snapd -y && \
echo “PATH=$PATH:/snap/bin” | tee -a ~/.bashrc && \
bash snap install ngrok

После можем создать конечную точку в панели управления во вкладке Gateway→Edges, с помощью нее вы сможете управлять своим reverse-прокси сервером:

Скриншот №3 — Создание конечной точки

Теперь подключим к нему свой локальный ресурс, к примеру, Nginx сервер, который занимает 80 порт:

Скриншот №4 — Netstat

Для этого добавим в конфигурационный файл ранее скопированный ключ в первом шаге и откроем туннель от нашего локального ресурса к публичной точке:

ngrok config add-authtoken && \
ngrok tunnel --label edge=

Где ID reverse-прокси можно найти в панеле на вкладке Overview, а URL представляет локальный ресурс, к которому необходим доступ.

Скриншот №5 — Запуск туннеля

После мы можем увидеть панель с основной статистикой по подключениям к узлу:

Скриншот №6 — Панель статистики

А обратившись на публичную точку, получим ответ от локального веб-сервера за NAT:

Скриншот №7 — Подключение к nginx

Как настроить traffic policy в Ngrok?

Фактически, это такой же модуль, как и у обычных reverse-прокси для управления сетевыми запросами и маршрутизацией путей. К примеру, по пути /cat - вернуть код 403 или перенаправить запрос пользователя.

Всего представлено 19 функций, которые можно реализовать, при получении трафика:

Скриншот №8 — Модули Reverse-proxy

Рассмотрим несколько из них, классически конфиг можно написать в YAML/JSON разметке и указать на него агенту или сразу на веб-платформе внести изменения для каждого типа трафика:

on_http_request:
- actions:
- type: custom-response
config:
status_code: 503
content: HTML code
headers:
content-type: text/html

После чего сохраним и проверим примененную заглушку на reverse-прокси:

curl -i https://example.ngrok.app/

Скриншот № 9 — Заглушка Reverse-Proxy

Отлично! Заглушка отлично отработала и выдала необходимый результат, таким же образом можно применить действия на request/response для остальных модулей по примеру! Более подробно с каждым из вы можете ознакомиться в официальной документации.