Инструкции и ответы

Как начать

От установки до первого подключения. Здесь же — выбор сборки, правила для приложений и помощь с частыми вопросами.

Установка

1

Выберите сборку

Для Android 12 и новее обычно подходит ShrimpNG. Для Android 8–11 и Huawei / Honor на EMUI или HarmonyOS 2–4 выбирайте Legacy. FOSS Calculator — тот же клиент с названием и иконкой калькулятора.

Перейти к скачиванию
2

Откройте APK на телефоне

Найдите скачанный файл в загрузках браузера или файловом менеджере. Если Android попросит разрешение на установку из этого источника, разрешите её и вернитесь к APK.

Для обновления откройте новый APK поверх установленного приложения. Удалять предыдущую сборку не нужно — так сохранятся настройки.

Добавление подключения

Клиент работает с подписками разных провайдеров и с вашими собственными серверами. Для добавления нужна ссылка, QR-код или готовый конфиг.

1

Скопируйте ссылку

Откройте страницу своего провайдера или настройки сервера и скопируйте ссылку на подписку либо отдельное подключение.

2

Нажмите «Добавить»

На главном экране чип «Добавить» находится в конце ряда подписок. Выберите добавление из буфера обмена. Для QR-кода используйте вариант сканирования, для собственных настроек — ручное добавление.

3

Дождитесь импорта

У подписки появится свой раздел и список серверов. Если список пуст, сначала обновите подписку и проверьте, что ссылка ещё действует.

Первое подключение

  1. Откройте нужную подписку и выберите сервер в списке.
  2. Нажмите большую кнопку подключения на главном экране.
  3. Подтвердите системное разрешение Android на создание подключения.
  4. Дождитесь изменения статуса и проверьте нужное приложение или страницу.

Задержку серверов можно проверить в приложении. Часто используемые серверы удобно отметить звездой, чтобы находить их в избранном.

Выбор приложений

В настройках откройте «Прокси по приложениям» и включите выбор приложений.

  • Основной режим: отмеченные приложения используют прокси, остальные подключаются напрямую.
  • Режим обхода: отмеченные приложения подключаются напрямую, остальные используют прокси.

Для более точной настройки есть раздел «Правила». Результат зависит от выбранного режима и конфигурации сервера; готовые конфиги провайдера могут содержать собственные правила.

Совместимость

  • Android 12 и новее: ShrimpNG или FOSS Calculator.
  • Android 8–11: ShrimpNG Legacy.
  • Huawei / Honor с EMUI или HarmonyOS 2–4: ShrimpNG Legacy.
  • HarmonyOS NEXT (5.0+): не поддерживается, так как не запускает Android-приложения.

Все три APK включают arm64-v8a и armeabi-v7a. Опубликованных сборок для x86 нет. В Legacy доступны встроенные палитры; системных цветов Material You в ней нет.

Если что-то не работает

APK не устанавливается

Сначала проверьте версию Android. Основная сборка и FOSS Calculator требуют Android 12+, для Android 8–11 нужна Legacy.

Если файл скачался не полностью, загрузите его заново. При обновлении приложения из другого источника возможна несовместимость подписи. Перед удалением установленного клиента сохраните настройки через резервное копирование.

Открыть сборку Legacy

Подписка добавилась, но серверов нет

Обновите подписку и проверьте срок действия ссылки. Попробуйте открыть страницу провайдера и скопировать ссылку ещё раз: ссылка на личный кабинет и ссылка на подписку могут отличаться.

Посмотрите результат обновления и логи в приложении. Не публикуйте свою личную ссылку в общем чате.

Подключение включено, но нужная страница не открывается

Проверьте другой сервер и измерьте задержку. Посмотрите, не исключено ли нужное приложение в выборе приложений и какие правила применяются к его адресам.

При готовом конфиге провайдера маршрут может быть задан внутри этого конфига. Если проблема остаётся, сохраните короткий фрагмент лога ошибки и обратитесь в чат проекта или к провайдеру.

После сна или в фоне соединение перестаёт работать

Проверьте настройки фоновой работы и энергосбережения Android. На некоторых устройствах нужно отдельно разрешить приложению работать в фоне.

В клиенте есть проверка подключения после сна и смены сети. Также убедитесь, что используете текущую версию.

Можно поставить сразу две сборки?

У ShrimpNG, FOSS Calculator и Legacy один пакет. Они устанавливаются друг поверх друга, поэтому одновременно на телефоне может стоять одна из этих сборок. При смене сборки из этого источника настройки сохраняются.

Где взять подписку или сервер?

Подойдёт подписка выбранного вами провайдера или конфигурация собственного сервера. ShrimpNG — универсальный клиент; готовое подключение нужно добавить самостоятельно.

Связаться с проектом

Новости проекта — в Telegram-канале. Для вопроса подойдёт чат, для воспроизводимой ошибки — GitHub Issues. Укажите версию клиента, сборку, модель телефона, версию Android и действия, после которых возникла проблема.