Установка ngrok на Termux чаще всего упирается в одну и ту же ошибку: пользователь скачивает бинарник не под ту архитектуру процессора, и при запуске получает сообщение вроде bad interpreter или cannot execute binary file. Причина почти всегда одна — на Android-смартфонах используется архитектура ARM или ARM64, а не привычный x86_64 с десктопа. Поэтому первое, что нужно проверить перед установкой, — разрядность вашего устройства.
Ngrok — это сервис для создания публичных туннелей к локальным сервисам. В связке с Termux он превращает смартфон в полноценную платформу для тестирования веб-серверов, ботов и API: вы поднимаете сервер локально, а ngrok выдаёт внешний HTTPS-адрес, доступный из любой точки интернета. Ниже разберём установку по шагам — от подготовки Termux до первого работающего туннеля.
Подготовка Termux и проверка архитектуры
Перед установкой убедитесь, что Termux у вас свежий. Рекомендуется ставить его из F-Droid или с GitHub-репозитория проекта — версия из Google Play давно не обновляется и может выдавать ошибки репозиториев. После установки откройте терминал и обновите пакеты:
pkg update && pkg upgrade -yТеперь определите архитектуру процессора. Выполните команду uname -m — она выведет что-то вроде aarch64 (64-битный ARM) или armv7l/armv8l (32-битный ARM). Именно от этого результата зависит, какой файл ngrok скачивать. Если пропустить этот шаг, вы почти гарантированно столкнётесь с ошибкой запуска.
- 📱
aarch64— скачивайте сборку ngrok для Linux ARM64 - 📱
armv7l/armv8l— нужна сборка для Linux ARM - 📱
x86_64— редкость на смартфонах, но встречается на эмуляторах и некоторых планшетах
Регистрация и получение authtoken
Без аккаунта ngrok работать не будет — сервис требует привязки токена. Зарегистрируйтесь на официальном сайте ngrok через браузер смартфона: достаточно email или аккаунта Google/GitHub. После входа в личном кабинете в разделе Your Authtoken вы найдёте длинную строку — это и есть ваш ключ.
Скопируйте токен сразу и сохраните его в заметках. Он понадобится на этапе настройки, а искать его заново в кабинете с маленького экрана неудобно. Обратите внимание: токен привязан к аккаунту, и публиковать его в открытом доступе (например, в скриншотах или репозиториях) не стоит — любой, кто его знает, сможет поднимать туннели от вашего имени.
⚠️ Внимание: бесплатный тариф ngrok выдаёт случайный адрес при каждом запуске туннеля. Если вам нужен постоянный домен для вебхуков или бота, проверьте актуальные условия тарифов на официальном сайте — они периодически меняются.
Скачивание и установка ngrok в Termux
Существует два рабочих способа установки: через пакетный менеджер и вручную с официального сайта. Самый простой вариант — попробовать установить через pkg, так как в репозиториях Termux пакет ngrok может присутствовать:
pkg install ngrokЕсли пакет не найден, скачивайте бинарник вручную. Перейдите на страницу загрузки ngrok, найдите ссылку на архив для вашей архитектуры (Linux ARM64 или ARM) и скачайте его через wget:
wget https://bin.equinox.io/c/bNyj1mQVY4c/ngrok-v3-stable-linux-arm64.tgzАктуальную ссылку на нужную версию берите с официальной страницы загрузки — URL может отличаться в зависимости от версии. После скачивания распакуйте архив и дайте файлу права на исполнение:
tar -xvzf ngrok-v3-stable-linux-arm64.tgz
chmod +x ngrok
☑️ Проверка перед первым запуском
Привязка токена и первый запуск туннеля
Осталось привязать аккаунт. Выполните команду, подставив свой токен:
./ngrok config add-authtoken ВАШ_ТОКЕНЕсли всё прошло успешно, ngrok создаст конфигурационный файл и больше токен спрашивать не будет. Теперь можно поднимать туннель. Например, чтобы открыть наружу локальный веб-сервер на порту 8080, выполните:
./ngrok http 8080На экране появится консоль со статусом: строка Forwarding покажет публичный HTTPS-адрес, который ведёт на ваш локальный порт. Скопируйте его и откройте в браузере — если на порту 8080 работает сервер, вы увидите свой сайт. Чтобы туннель не закрывался при сворачивании Termux, приобретите wakelock через команду termux-wake-lock, иначе Android может усыпить процесс.
Частые ошибки и их решение
Разберём типичные проблемы, с которыми сталкиваются при установке ngrok на Termux. Большинство из них решается за пару минут, если понимать причину.
| Ошибка | Вероятная причина | Решение |
|---|---|---|
| cannot execute binary file | Бинарник не под архитектуру | Проверьте uname -m и скачайте нужную сборку |
| permission denied | Нет прав на исполнение | Выполните chmod +x ngrok |
| authentication failed | Неверный или незаданный токен | Повторите команду add-authtoken с корректным токеном |
| command not found | Запуск без ./ или файл в другой папке | Запускайте как ./ngrok из каталога с файлом |
| Туннель рвётся через время | Android усыпляет Termux | Включите termux-wake-lock и отключите оптимизацию батареи для Termux |
Отдельно стоит упомянуть ошибку bad interpreter — она возникает, если вы скачали версию для Windows или macOS. Решение то же: удалите файл и скачайте сборку именно для Linux под вашу архитектуру.
Как запускать ngrok в фоне
Используйте tmux (pkg install tmux). Создайте сессию командой tmux, запустите внутри ngrok, затем отсоединитесь клавишами Ctrl+B, затем D. Вернуться в сессию можно командой tmux attach. Так туннель продолжит работать, даже если вы закроете текущее окно терминала.
Безопасность при работе с туннелями
Открывая локальный порт наружу, вы делаете сервис доступным всему интернету. Если на порту крутится панель управления, база данных или файловый сервер без авторизации — их сможет открыть любой, у кого есть ссылка. Адреса ngrok выглядят случайными, но это не защита: такие адреса регулярно сканируются ботами.
- 🔒 Не выставляйте наружу сервисы без пароля или иной авторизации
- 🔒 Закрывайте туннель (Ctrl+C) сразу после завершения тестов
- 🔒 Не публикуйте authtoken и активные адреса туннелей в открытых источниках
- 🔒 По возможности используйте встроенные средства защиты ngrok, например базовую авторизацию через флаг
--basic-auth, если она поддерживается вашей версией
⚠️ Внимание: если вы поднимаете SSH или удалённый доступ через ngrok, убедитесь, что используете надёжные пароли или ключи. Открытый SSH-порт со слабым паролем — один из самых частых векторов взлома.
Альтернативы ngrok для Termux
Если ngrok по какой-то причине не подходит — например, нужен постоянный домен на бесплатном тарифе или сервис недоступен — существуют альтернативы. Среди известных вариантов: Cloudflare Tunnel (cloudflared), localtunnel, serveo и bore. Большинство из них также устанавливаются в Termux через pkg или скачиванием бинарника.
Выбор зависит от задачи: для вебхуков Telegram-ботов удобны сервисы с постоянными поддоменами, для быстрого теста достаточно любого туннеля с HTTPS. Принцип настройки у всех похожий: установка, авторизация (не всегда нужна), запуск с указанием локального порта.
Часто задаваемые вопросы
Работает ли ngrok на Termux без root-прав?
Да, root не требуется. Ngrok — обычное пользовательское приложение, оно не трогает системные разделы. Достаточно стандартных разрешений Termux.
Почему ngrok выдаёт ошибку "cannot execute binary file"?
Почти всегда причина в несоответствии архитектуры: вы скачали сборку под x86_64, а смартфон работает на ARM. Проверьте архитектуру командой uname -m и скачайте правильную версию для Linux ARM или ARM64.
Можно ли получить постоянный адрес вместо случайного?
На бесплатном тарифе ngrok адрес генерируется случайно при каждом запуске. Постоянные домены обычно доступны на платных тарифах — актуальные условия смотрите на официальном сайте сервиса, так как они могут меняться.
Туннель отключается, когда я сворачиваю Termux. Что делать?
Android усыпляет фоновые процессы для экономии батареи. Выполните termux-wake-lock в Termux и отключите оптимизацию батареи для приложения в настройках системы. Для длительных сессий удобно запускать ngrok внутри tmux.
Чем распаковать скачанный архив .tgz?
Используйте встроенную утилиту tar: команда tar -xvzf имя_файла.tgz распакует архив в текущую папку. После этого не забудьте выдать файлу права на исполнение через chmod +x.