Как работает туннель
Туннель представляет собой постоянное соединение между агентом на вашем компьютере и сервером Nurl. Агент сам подключается к серверу, поэтому входящие порты, белый IP и настройки роутера не нужны.
браузер ──HTTPS──▶ n8k05t26.nurl.pw ──WebSocket──▶ агент nurl ──HTTP──▶ localhost:3000Путь запроса#
- Посетитель открывает
https://n8k05t26.nurl.pw/catalog. - Сервер Nurl принимает запрос по HTTPS. Сертификат уже выпущен на
*.nurl.pw, браузер показывает замочек. - Сервер находит туннель по поддомену и передаёт запрос агенту по WebSocket.
- Агент отправляет тот же запрос в ваше приложение:
http://localhost:3000/catalog. - Ответ приложения возвращается тем же путём.
Метод, путь, query, заголовки и тело приходят в приложение без изменений. Отличия перечислены ниже.
Что меняется в запросе#
Чтобы приложение строило абсолютные ссылки на публичный адрес, включите в нём доверие к X-Forwarded-*. Например, app.set("trust proxy", true) в Express, ProxyFix во Flask, USE_X_FORWARDED_HOST в Django.
На тарифе Open служебные пути /__nurl/... обслуживают экран предупреждения и в приложение не попадают. На Pro в приложение уходят все пути без исключений.
Если агента нет#
- Агент переподключается: сервер отвечает
503и ждёт его. - У своего имени не запущен агент: тоже
503. - Такого адреса нет или туннель закрыт:
404.
Пока агент запущен#
- Агент держит соединение и отвечает на проверки сервера.
- Связь оборвалась, например пропал Wi-Fi или компьютер уснул: агент переподключается сам: через 1 секунду, затем реже, до 30 секунд между попытками.
- Сервер ждёт агента 2 минуты и держит адрес за ним. Если агент успел вернуться, адрес прежний. Если не успел, временный адрес сменится, а своё имя на Pro останется вашим. Подробнее в разделе Временные адреса.
Когда туннель закрывается#
- Вы нажали
Ctrl+Cили закрыли терминал. - Туннель остановили из панели.
- Вход агента отозвали в разделе «Сессии».
- Это же имя занял агент, запущенный позже.
- Закончилась подписка Pro, аккаунт заморожен или заблокирован.
В каждом случае агент пишет причину и подсказку, что делать. Все сообщения собраны в разделе Ошибки агента.