ServBay

Русский

English
简体中文
繁體中文
Español
العربية
Português
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Русский

English
简体中文
繁體中文
Español
العربية
Português
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

Руководство по настройке обратного прокси-сервиса Ngrok в ServBay ​

Ngrok — это мощный инструмент безопасного туннелирования, основанный на технологии обратного прокси, который позволяет пробивать межсетевые экраны и NAT, сопоставляя локальные сервисы с публичными доменами. В этом руководстве подробно описано, как интегрировать и настроить Ngrok в вашей локальной среде разработки ServBay, чтобы предоставить доступ к локальным веб-сервисам, API или другим сервисам через интернет — идеально для удалённых демонстраций, командной работы или тестирования внешних обратных вызовов.

Технический принцип работы ​

В основе работы Ngrok — создание зашифрованного туннеля между вашим локальным компьютером и сервером Ngrok. Когда внешний пользователь обращается к публичному домену, выделенному Ngrok, запрос сначала поступает на сервер Ngrok, а затем пересылается по защищённому туннелю непосредственно к сервису, работающему в вашей локальной среде ServBay. Таким образом, даже если у вас нет публичного IP-адреса или ваш компьютер находится за фаерволом, вы всё равно можете предоставить доступ к сервисам извне. В контексте ServBay это значит, что вы в любой момент можете делиться своими локальными сайтами, backend API или другими HTTP/HTTPS-сервисами для демонстрации и тестирования сторонним пользователям.

Подготовка среды ​

Перед началом настройки Ngrok убедитесь, что выполнены следующие шаги:

  1. ServBay установлен и запущен: Проверьте, что приложение ServBay успешно установлено, а нужный веб-сервис (например, сайт) сконфигурирован и работает. Управлять конфигурацией локальных сайтов можно в панели «Веб-сайты» в ServBay.
  2. Установка клиента Ngrok: Чтобы развернуть CLI-инструмент Ngrok, воспользуйтесь следующими шагами:
    1. Перейдите на официальную страницу загрузки Ngrok и скачайте установщик для вашей операционной системы.
    2. После загрузки распакуйте архив и переместите полученный исполняемый файл ngrok в папку, входящую в переменную PATH вашей системы (например, в macOS — /usr/local/bin), чтобы команда ngrok была доступна в любом терминальном окне.
      bash
      # Пример для macOS ARM64
sudo unzip ~/Downloads/ngrok-v3-stable-darwin-arm64.zip -d /usr/local/bin
    3. Проверьте, что установка прошла успешно, выполнив команду ngrok version. Она должна вывести номер установленной версии:
      bash
      ngrok version
# Пример вывода: ngrok version 3.5.0
  3. Аккаунт Ngrok (опционально, но рекомендуется): Наличие аккаунта Ngrok (бесплатного или платного) облегчит управление туннелями и даст доступ к расширенным возможностям вроде фиксированных доменов. Зарегистрируйтесь на сайте Ngrok и получите ваш токен авторизации (ngrok config add-authtoken <YOUR_AUTH_TOKEN>), чтобы снять ограничения по времени соединения и открыть больше функций.
  4. Настроенный локальный сайт: В ServBay должен быть создан хотя бы один локальный сайт, который вы планируете сделать публичным через Ngrok (например, с доменом типа servbay.local или yourproject.servbay.demo).

Практика настройки туннелей ​

Пояснение к основным параметрам ​

Стандартная команда для сопоставления сервисов выглядит так:

bash
ngrok http --domain=<NGROK_DOMAIN> <LOCAL_ENDPOINT> \
  --request-header-add='host: <VIRTUAL_HOST>'
Компонент параметраОписание
httpОбозначает создание HTTP-туннеля. Ngrok будет обрабатывать входящие HTTP/HTTPS-запросы.
--domain <NGROK_DOMAIN>Указывает выделенное для вас доменное имя Ngrok (замените на актуальное имя из консоли управления Ngrok). В бесплатной версии этот параметр обычно не требуется — Ngrok выдаёт случайный поддомен.
<LOCAL_ENDPOINT>Адрес локального сервиса ServBay. Обычно это локальный домен виртуального хоста (например, https://servbay.local), либо http://localhost:порт.
--request-header-add='host: <VIRTUAL_HOST>'[Важно] Перезаписывает заголовок Host. ServBay различает локальные сайты по этому заголовку, поэтому его нужно установить в домен локального сайта (например, servbay.local), чтобы запросы корректно маршрутизировались.

Пример конфигурации ​

Допустим, вы настроили локальный сайт в ServBay с доменом servbay.local и хотите опубликовать его через Ngrok. Если вы используете бесплатную версию Ngrok, можно напрямую проксировать локальный адрес:

bash
# Проксируем локальный сайт ServBay (servbay.local) на случайный домен, выделенный Ngrok
ngrok http https://servbay.local --request-header-add='host: servbay.local'

Если в консоли управления Ngrok вы настроили постоянный домен, например, your-servbay-demo.ngrok-free.app (или пользовательский домен в платной версии), используйте параметр --domain:

bash
# Проксируем локальный сайт ServBay (servbay.local) на указанный домен Ngrok
ngrok http --domain=your-servbay-demo.ngrok-free.app https://servbay.local --request-header-add='host: servbay.local'

После успешного выполнения этих команд Ngrok отобразит в терминале статус туннеля, включая выданный публичный адрес (например, https://xxxx.ngrok-free.app либо ваш домен), а также адрес локальной панели мониторинга трафика (обычно http://127.0.0.1:4040).

Проверка сервиса ​

Чтобы убедиться, что сервис успешно опубликован через Ngrok, выполните следующие действия:

  1. Получите публичный адрес: В терминале Ngrok найдите строку Forwarding и скопируйте URL, начинающийся с https://.
  2. Откройте в браузере: На любом устройстве с интернетом откройте этот URL в браузере (например, https://cunning-lacewing-fresh.ngrok-free.app или ваш постоянный домен).
  3. Проверьте результат:
    • Убедитесь, что сайт, размещённый через ServBay, корректно отображается.
    • Проверьте, что в адресной строке браузера виден значок защищённого HTTPS-соединения (Ngrok предоставляет действительные SSL-сертификаты по умолчанию).
    • Ознакомьтесь с логами и статистикой в терминале Ngrok или через локальный веб-интерфейс (http://127.0.0.1:4040), чтобы убедиться, что запросы успешно доходят до ServBay.

Интерфейс успешного доступа к туннелю NgrokИллюстрация: успешный доступ к туннелю Ngrok через веб-браузер

Продвинутые советы и важные моменты ​

  1. Управление доменами:
    • С бесплатным аккаунтом Ngrok вы обычно получаете случайный поддомен .ngrok-free.app, при этом у туннеля есть ограничения по времени работы.
    • При регистрации аккаунта и в Dashboard Ngrok можно добавить постоянные домены, чтобы адрес был стабильным при каждом запуске туннеля.
    • Платные тарифы Ngrok позволяют подключать собственные домены верхнего уровня и дают дополнительные возможности: повышенную производительность, одновременные туннели, настройки безопасности и др.
  2. Проксирование нескольких сервисов: Если вы хотите опубликовать в интернет несколько сервисов или портов из ServBay, можно запускать несколько процессов Ngrok или задать все туннели через конфигурационный файл (~/.config/ngrok/ngrok.yml). Пример: публикация сайта ServBay и локального сервиса на порту 3000:
    bash
    # Проксирование сайта servbay.local (через HTTPS и Host-заголовок)
ngrok http --domain=servbay-website.ngrok-free.app https://servbay.local --request-header-add='host: servbay.local'

# Параллельно (или через конфиг) публикуем Node.js-приложение (порт 3000)
ngrok http --domain=nodejs-api.ngrok-free.app http://localhost:3000
    Обратите внимание: для виртуальных хостов в ServBay рекомендуется использовать https://[локальный_домен] вместе с --request-header-add, а не напрямую проксировать порты 80/443 — так как именно на них ServBay принимает все запросы и осуществляет маршрутизацию между сайтами.
  3. Диагностические команды:
    • ngrok config check: Проверяет синтаксис и корректность настроек в конфиге Ngrok (~/.config/ngrok/ngrok.yml).
    • ngrok logs: Показывает журналы работы клиента Ngrok в терминале в реальном времени — полезно для поиска и устранения ошибок маршрутизации и соединений.
  4. Безопасность: Помните, что публикация локальных сервисов в интернет потенциально небезопасна! Запускайте туннель только при необходимости и имейте в виду возможные угрозы. Платные тарифы Ngrok поддерживают белый список IP, ограничение доступа и другие расширенные меры защиты.

Устранение неполадок ​

ПроблемаРешение
Время ожидания соединения или сайт не грузитсяПроверьте, работает ли нужный сайт в ServBay и доступен ли он по локальному домену (https://servbay.local). Удостоверьтесь, что веб-сервер (например, Caddy или Nginx) работает без ошибок. Проверьте настройки фаервола и разрешите соединения Ngrok.
Ошибка HTTPS-сертификата/предупреждение в браузереNgrok по умолчанию генерирует действительные SSL-сертификаты для публичных доменов. Если ошибка возникает при доступе по адресу Ngrok — проверьте правильность туннеля и вашего запроса (используйте только адреса, начинающиеся с https://). Если ошибка возникает при локальном доступе к ServBay, проверьте настройки SSL веб-сервера.
Периодические обрывы или низкая скоростьПроверьте стабильность интернет-соединения на вашем компьютере. Для более надёжной работы рекомендуем использовать проводное соединение. Для требовательных задач рассмотрите платный тариф Ngrok с расширенными SLA.
Загрузка страницы по умолчанию ServBay вместо нужного сайтаПроверьте правильность указания локального адреса <LOCAL_ENDPOINT> в команде ngrok http и параметра --request-header-add='host: <VIRTUAL_HOST>', который должен содержать имя локального сайта из ServBay. Это важно для корректной маршрутизации запросов к целевому сайту.

Часто задаваемые вопросы (FAQ) ​

  • Вопрос: Можно ли опубликовать через Ngrok сервисы баз данных из ServBay?

    Ответ: Ngrok в первую очередь ориентирован на HTTP/HTTPS-туннели. Хотя он поддерживает проксирование TCP-соединений (в т.ч. для баз данных), это выходит за рамки этого руководства и, как правило, небезопасно выводить локальные базы данных в интернет. Для удалённого доступа к базе используйте SSH-туннели или другие защищённые методы.

  • Вопрос: Изменяется ли публичный домен при каждом запуске Ngrok?

    Ответ: В бесплатной версии Ngrok каждый раз выделяется случайный поддомен .ngrok-free.app. Чтобы получить постоянный публичный адрес, зарегистрируйте аккаунт Ngrok и настройте домен в консоли, либо перейдите на платный тариф.

  • Вопрос: Влияет ли Ngrok на производительность моего локального сервера ServBay?

    Ответ: Да, Ngrok может добавить небольшую сетевую задержку, так как все запросы проходят через внешний сервер. Но для разработки, тестирования и демонстраций это обычно некритично. Рабочую скорость сайта определяет производительность вашего ПК и оптимизация самого приложения.

Заключение ​

С интеграцией Ngrok пользователи ServBay могут легко, безопасно и удобно делиться результатами своей веб-разработки с внешним миром. Решение крайне простое в настройке и избавляет от сложных ручных сетевых конфигураций — что особенно полезно для удалённой работы, презентаций заказчикам и интеграционного тестирования с мобильными или сторонними сервисами. Ngrok предоставляет мониторинг трафика в реальном времени и расширенные опции безопасности (часть из них доступны только в платных тарифах). Для стабильной работы, фиксированных доменов и бизнес-критичных задач рекомендуется рассмотреть платные планы Ngrok для максимально комфортной и защищённой работы.