ngrok

ngrok — это агент командной строки, который подключает локальные или частные сервисы к облачной сети ngrok через исходящее зашифрованное соединение. Он предоставляет публичные эндпоинты, не требуя входящих изменений в брандмауэре или публичного IP-адреса на исходной машине. Разработчики используют его для предварительного просмотра приложений, тестирования вебхуков, разработки API и контролируемого доступа к сервисам за NAT или брандмауэрами.

Основные возможности

• Предоставляйте локальные HTTP- и HTTPS-сервисы через публичные эндпоинты и перенаправляйте трафик на выбранный порт вышестоящего сервиса.
• Создавайте эндпоинты TCP или TLS для поддерживаемых сценариев, отличных от HTTP, в соответствии с правами вашей учетной записи.
• Применяйте Traffic Policy для аутентификации запросов, маршрутизации трафика, перезаписи запросов или ограничения частоты доступа до попадания в вышестоящий сервис.
• Инспектируйте HTTP-трафик и воспроизводите захваченные запросы для отладки вебхуков и воспроизведения сбоев.
• Настраивайте эндпоинты и поведение агента в файле конфигурации, автоматизируйте поддерживаемые команды или запускайте агент как службу ОС.
• Используйте одно исходящее соединение TLS на порту 443 для передачи трафика из сети ngrok обратно к источнику.

Установка и первое использование

Установите brew install --cask ngrok. Пакет устанавливает исполняемый файл ngrok и дополнения для оболочки, а не графическое приложение для Mac. Создайте учетную запись ngrok, получите собственный authtoken агента и настройте его с помощью ngrok config add-authtoken <YOUR_AUTHTOKEN>. Запустите локальное приложение, затем выполните ngrok http 8080, заменив 8080 на его порт прослушивания. Используйте эндпоинт, выведенный агентом. Эндпоинт, созданный этим агентом, существует, пока работает сеанс агента; отдельный Cloud Endpoint имеет другое поведение жизненного цикла.

Требования, зависимости и конфликты

Автономный агент не имеет внешних зависимостей времени выполнения. Homebrew не объявляет дополнительных зависимостей formula, явных конфликтов cask и явной минимальной версии macOS в этом снимке. Он предоставляет отдельные нативные загрузки для Apple Silicon и Intel Mac. Эти метаданные не подтверждают поддержку каждого исторического выпуска macOS; обратитесь на страницу загрузки поставщика, чтобы найти совместимые сборки.

Поставщик документирует 64 MB минимальной памяти, 128 MB рекомендуемой и примерно 25 MB дискового пространства; фактическое потребление ресурсов растет с одновременным трафиком. Это рекомендации по времени выполнения, а не размер сжатой загрузки. Ваше вышестоящее приложение должно быть запущено и доступно агенту. Для облачных эндпоинтов требуются доступ в интернет и исходящее подключение TLS к ngrok; корпоративный прокси, брандмауэр или средства контроля учетной записи могут влиять на подключение.

Отдельные официальные сборки агента поддерживают macOS x86-64/arm64, Windows x86-64/x86, Linux для семейств x86, ARM, MIPS, PowerPC и s390x, а также FreeBSD x86-64/x86/ARM. Загрузите подходящую сборку вместо использования ZIP-архива для Mac в другой ОС. SDK агента, контейнеры и обратный SSH — это отдельные варианты развертывания. Инструменты, используемые вышестоящим сервисом, сохраняют свои собственные требования.

Учетные записи, расходы и лицензия

Для использования облачного агента ngrok требуются учетная запись и authtoken агента. Доступен бесплатный тариф с ограничениями; платные тарифы или тарифы с оплатой по использованию предоставляют другие лимиты и возможности. Домены, параметры аутентификации, протоколы эндпоинтов, хранение трафика и плата за использование зависят от текущего тарифа. Загрузка бинарного файла не делает каждую функцию сервиса ngrok бесплатной или неограниченной.

Текущий агент и облачный сервис регулируются Условиями обслуживания ngrok. Современный распределенный агент — это не старый проект ngrok v1 с открытым исходным кодом. Официальный репозиторий сообщества используется для обратной связи и отслеживания проблем; он не является полным исходным кодом этого агента. SDK с открытым исходным кодом и другие компоненты ngrok имеют собственные лицензии.

Ссылки: загрузка macOS, установка агента и требования, обзор агента, инспекция трафика, цены и условия.