Документация Stealtify

Коротко о главном

Этот раздел — для тех, кто открыл Stealtify впервые. Здесь нет ни одной настройки: только то, что стоит понять до установки. Пять минут чтения избавят от большинства вопросов дальше.

Что это за приложение

Stealtify — приложение для Android, которое решает, каким путём пойдёт трафик каждой программы на вашем телефоне. Одни программы вы отправляете через свой сервер, другие оставляете работать напрямую. Решение принимается для каждой программы отдельно, а не для телефона целиком.

Обычные VPN-приложения работают иначе: они уводят через сервер весь телефон разом. Из-за этого ломаются программы, которые ждут вашего обычного адреса, — банковские приложения, госсервисы, служба доставки. Stealtify этого не делает: то, что вы не отметили, продолжает работать как раньше.

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

Шесть слов, которые встретятся

Дальше в документации эти слова используются постоянно. Их достаточно понять один раз.

Сервер

Чужой компьютер в другом месте, через который идёт ваш трафик. Вы либо арендуете его сами, либо получаете доступ у поставщика.

Конфиг

Набор данных для подключения к серверу: адрес, номер порта, пароль или ключ. Обычно приходит одной длинной строкой или картинкой с QR-кодом. Конфиг — это не сам сервер, а пропуск к нему.

Туннель

Защищённый проход между телефоном и сервером. Пока он поднят, то, что вы отправляете, читается только на двух концах, а не по дороге.

Транспорт

Способ, которым устроен туннель. Их несколько, они отличаются скоростью и заметностью в сети. Выбирать транспорт вручную не нужно: он записан внутри конфига, и приложение читает его само.

Подписка

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

Группа

Полка, на которую вы складываете программы. У полки один сервер на всех. Переставили сервер у группы — маршрут поменялся сразу у всех программ на ней.

Что нужно, чтобы всё заработало

Приложение — только половина. Вторая половина у вас.

• Телефон на Android 10 или новееПрава root не нужны, прошивку менять не надо. Версия смотрится в настройках телефона, раздел «О телефоне».
• Доступ к серверуЛибо свой сервер, поднятый самостоятельно, либо доступ, полученный у поставщика. Без этого приложение установится, но подключаться будет некуда.
• Конфиг или ссылка-подпискаТа самая строка или QR-код. Это единственное, что придётся куда-то вставить руками, и делается это один раз.

Чем Stealtify отличается

Четыре вещи, которых по отдельности хватает у других, а вместе — редко.

• Правила по программам и по сайтам на одном экранеНе нужно выбирать между «весь телефон через сервер» и «ничего через сервер». Список программ и список сайтов лежат рядом, и отметки ставятся касанием.
• Несколько серверов работают одновременноРазным программам можно назначить разные серверы, и они будут работать в один момент времени. Переключать профили вручную не требуется.
• Восемь способов подключения в одном приложенииСсылка, которая у вас уже есть, скорее всего подойдёт: приложение понимает восемь распространённых форматов и разбирает их само. Держать несколько клиентов под разные конфиги не нужно.
• Ничего о вас не собираетсяНи учётной записи, ни аналитики, ни отправки статистики. Настройки и пароли остаются на телефоне, ключи хранятся в защищённом хранилище Android.

Как выбрать, у кого брать доступ

Мы не продаём доступ и никого не рекомендуем — ни в текстах, ни ссылками. Но выбирать вам, поэтому вот то, на что стоит смотреть. Список работает одинаково для любого поставщика.

• Пробный период или возврат денег. Поставщик, уверенный в своих серверах, даёт попробовать до оплаты.
• Сколько устройств на одном доступе. Один телефон, три, пять — цифра должна быть названа заранее, а не выясняться после оплаты.
• Есть ли в подписке несколько серверов. Один сервер — это одна точка отказа: упал он, и подключаться некуда.
• Обновляется ли список серверов. Живая подписка подтягивает новые адреса сама; мёртвая остаётся с теми, что были при покупке.
• Как быстро отвечает поддержка. Проверяется до оплаты одним вопросом.
• Открывается ли ссылка в стороннем клиенте. Если конфиг работает только в приложении поставщика, вы привязаны к нему целиком — включая его сроки и его решения.
• Не просят ли лишнего. Для выдачи доступа не нужны ни ваши документы, ни доступ к телефону, ни пароли от других сервисов.
• Цена, сильно выпадающая из общей, — повод задать вопросы, а не повод радоваться.

Что важно знать заранее

Четыре вещи, которые чаще всего выясняются поздно.

• Ссылка на сервер — это парольВнутри неё лежат ваши учётные данные. Не публикуйте её в открытых чатах и не пересылайте тем, кому не доверяете: у получившего будет тот же доступ, что у вас.
• Скорость задаёт сервер, а не приложениеЧерез сервер путь всегда длиннее прямого. Насколько — зависит от того, где сервер стоит и сколько людей на нём. Приложение на это не влияет.
• Сервер видит, куда вы обращаетесьТуннель закрывает трафик от посторонних по дороге, но не от того, кто держит сервер. Поэтому вопрос доверия к поставщику — не формальность.
• Настройки переносятся на другое устройствоВсё, что вы настроили, выгружается в один файл и переносится на новый телефон или на телевизор. Заново вставлять конфиги не придётся — подробности в разделах ниже.

Дальше — раздел 2: пошаговый первый запуск, форматы конфигураций, правила маршрутизации и решение проблем.

Первый запуск за 5 минут

Инструкция для тех, у кого уже есть подписка или свой сервер. Stealtify — клиент: серверов мы не предоставляем, а подключаемся к вашим. Пройдите шаги по порядку — к концу у вас будет рабочее правило «приложение → группа» и резервный прокси на случай сбоя.

Установка APK

1. Скачайте файл

   Откройте страницу релизов и скачайте APK последней версии. Загружайте файл только с этого сайта или из канала обновлений — сборки из сторонних каталогов мы не контролируем.

   Открыть страницу релизов

2. Разрешите установку из неизвестных источников

   Android спросит разрешение при первом открытии файла. Разрешение выдаётся тому приложению, из которого вы открываете APK: браузеру или файловому менеджеру. После установки его можно отозвать.

3. Откройте приложение

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

Импорт подписки: три способа

Конфигурацию даёт ваш продавец подписки или ваш собственный сервер. Клиенту нужен только сам конфиг — в одном из трёх видов.

Ссылка из буфера обмена

Скопируйте ссылку вида vless://…, vmess://…, trojan://…, ss://… или awg://… и нажмите «Добавить сервер» → «Вставить из буфера». Клиент разберёт параметры сам. Это самый быстрый путь, если продавец прислал конфиг текстом.

QR-код

Выберите «Сканировать QR» и наведите камеру на код в личном кабинете продавца. Так удобнее переносить конфиг с экрана компьютера, не пересылая ссылку через мессенджер.

Импорт резервной копии

Если серверов много или вы переносите настройки с другого устройства, используйте импорт конфигурации целиком. Учтите: файл заменяет текущую конфигурацию, а не дополняет её, — сначала сохраните свою через экспорт. Формат файла и что лежит внутри — в разделе Форматы конфигураций.

Правило для приложения

Пример: весь трафик Telegram должен идти через US VLESS. Откройте экран правил, найдите Telegram в списке приложений и назначьте его на группу с прокси US VLESS. Всё — правило создано.

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

Правило по домену

Пример: *.youtube.com → US VLESS. На том же экране правил переключитесь к доменам, добавьте маску домена и назначьте её группе с прокси US VLESS. Маршрутизация идёт по домену из TLS SNI, поэтому правило работает для любого приложения, которое ходит на этот адрес.

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

Резервный прокси и health-check

Добавьте второй сервер тем же способом, что и первый, и укажите его как резервный для основного. Включите health-check: клиент периодически проверяет доступность основного сервера и, если тот перестал отвечать, переключает трафик на резервный.

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

Мониторинг

На экране мониторинга видно, сколько трафика израсходовало каждое приложение и через какой сервер оно ходило. Там же лежит журнал соединений — он показывает попытки подключения, ошибки и срабатывания health-check.

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

Установка и обновления

Требования

Android 10 и новее, только архитектура arm64-v8a. На 32-битные устройства и более старые версии Android клиент не установится.

Установка

1. Скачайте APK.
2. Откройте файл — если Android запросит разрешение на установку из неизвестных источников, разрешите его.
3. Нажмите «Установить».

К каждой сборке публикуется контрольная сумма SHA-256. Проверить скачанный файл можно командой Get-FileHash с алгоритмом SHA256 и сравнить результат с опубликованным значением.

Обновления

Обновления клиент находит сам: предложение появляется на главном экране и в Настройки → Обновления. Диалог показывает номер версии и список изменений, кнопки «Обновить» и «Позже». Обязательные обновления отложить нельзя.

Первый запуск

Добавьте прокси, нажмите подключение и подтвердите системный запрос разрешения на VPN — статус сменится на «VPN активен».

Откат версии

Android не устанавливает версию с меньшим versionCode поверх более новой, поэтому откатиться на предыдущую сборку простой переустановкой не получится: сначала нужно удалить приложение, а это стирает настройки и базу серверов. Если откат может понадобиться, экспортируйте конфигурацию заранее.

Откуда скачивать

Единственный официальный источник — update.stealtify.app. В Google Play клиента нет и не будет, поэтому Android при установке попросит разрешить установку из неизвестных источников. Надёжнее всего обновляться прямо из приложения: встроенное обновление идёт по защищённому соединению с закреплённым сертификатом, а контрольная сумма проверяется перед установкой.

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

Контрольная сумма подтверждает только то, что файл скачался без повреждений, — она ничего не говорит о том, кто его собрал. Пересобрать APK со своими серверами и выложить под именем Stealtify может кто угодно, и для VPN-клиента это главная угроза: поддельная сборка видит весь трафик. Поэтому каждая настоящая сборка подписана ключом разработчика, и приложение проверяет подпись при запуске. Если проверка не прошла, клиент не запускается: вместо интерфейса — предупреждение о неподлинной копии и ссылка на официальный источник. Доступа к VPN и настройкам в этом состоянии нет, поэтому подделка не сможет пустить трафик через чужой сервер. Делать для этого ничего не нужно, проверка работает сама.

Сборки старше 1.41.0

Они не могут обновиться по сети: сменился пиннинг сертификатов Let’s Encrypt, и старая сборка не проверяет сертификат сервера обновлений. Скачайте последний APK вручную с официального сайта и установите поверх — конфигурация и данные сохранятся, ключ подписи тот же.

Импорт и управление серверами

Сервер можно добавить тремя способами: кнопкой «+» для быстрого добавления, сканером QR-кода или подпиской по URL. Имя сервера необязательно — если его не указать, клиент подставит «ТИП host». Кнопка «Расширенный ввод» открывает полный редактор со всеми параметрами.

Действия с карточкой сервера

• Тест — проверка доступности, показывает задержку или текст ошибки.
• Редактировать — открывает расширенный редактор.
• Удалить — требует подтверждения «Это действие нельзя отменить».

Поля расширенного редактора

Базовые поля есть у любого сервера: имя, тип протокола, хост, порт, логин и пароль.

• VLESS, VMess и Trojan — UUID, security (tls / reality / none), транспорт (tcp / ws / grpc), SNI, ALPN, fingerprint, flow, путь и хост WebSocket, имя gRPC-сервиса, параметры REALITY (public key, short ID).
• Shadowsocks — метод шифрования.
• SSH — отпечаток ключа хоста, шифр.
• AmneziaWG — приватный ключ, публичный ключ пира, preshared-ключ, адрес (CIDR), DNS, MTU, keepalive, параметры обфускации Jc/Jmin/Jmax и S1–S4, H1–H4.

Отдельно от протокола: переключатель «Использовать TLS» и настройка «Цепочка» (chain) — пустить трафик сначала через другой прокси, а затем через этот.

Форматы конфигураций

Клиент разбирает ссылку одной из восьми схем. Вот они:

• SOCKS5 — socks5://[user:pass@]host:port (или просто host:port)
• HTTP CONNECT — http://[user:pass@]host:port
• Shadowsocks — ss://BASE64(method:password)@host:port#name
• VLESS — vless://UUID@host:port?параметры#name
• VMess — vmess://BASE64(JSON)
• Trojan — trojan://password@host:port?параметры#name
• AmneziaWG — awg://PRIVATEKEY@host:port?publickey=...&address=...#name
• AmneziaWG в формате приложения AmneziaVPN — vpn://... (тот же транспорт, другой синтаксис ссылки)

У SSH-транспорта своей схемы ссылки нет: он настраивается только вручную, через расширенный ввод.

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

QR-коды

Камерой считываются оба вида кодов: с одиночным сервером и с подпиской. Код размером больше 8 КБ или с неизвестной схемой ссылки отклоняется ещё до разбора; входные данные объёмом больше 64 КБ отклоняются тоже.

Резервная копия

Настройки → Данные → Экспорт сохраняет всю конфигурацию в зашифрованный файл stealtify_backup.stbackup — серверы, группы и правила. Старый формат JSON по-прежнему принимается при импорте. Импорт полностью заменяет текущую конфигурацию: прежние серверы, группы и правила удаляются, а не дополняются. Поэтому перед импортом чужого файла сделайте экспорт своего. Файл содержит секреты — ключи и пароли серверов, поэтому хранить его нужно как чувствительные данные; сам клиент никуда его не отправляет.

Правила маршрутизации

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

Порядок разрешения

Для каждого соединения клиент проходит пять шагов по порядку:

Доменные маски

Правило для домена принимает одну из трёх форм: точный адрес example.com, поддомен mail.example.com или маска *.example.com. Формат проверяется при вводе. Матчинг идёт по TLS SNI — то есть по имени хоста, которое видно на этапе установления TLS-соединения, — а не по IP-адресу назначения.

Приложение без правила

Если для приложения нет ни одного правила и его домен ни под одну маску не попадает, соединение идёт напрямую.

Пустой случай

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

Ограничение матчинга

DNS-over-HTTPS и захардкоженные в приложении IP-адреса обходят доменный матчинг, потому что имя хоста в этом случае клиенту не видно. В таких случаях правило по домену не сработает — маршрутизировать нужно приложение целиком, правилом по приложению.

Резервный сервер и health-check

Failover устроен просто: клиент проверяет прокси перед подключением и переключается на резервный, если основной недоступен или отвечает слишком медленно.

Порог задержки

Порог задаётся ползунком от 500 мс до 15 с. Если задержка отклика выше порога, клиент считает прокси недоступным и использует резервную группу. Резервная группа задаётся у самой группы — так же, как основной прокси.

Ручная проверка

Кнопка «Тест» на карточке сервера показывает задержку отклика или текст ошибки. Экран «Прокси (проверка)» показывает список серверов со статусом, пингом и типом транспорта — туда стоит заглянуть первым делом, если что-то не работает.

StealtifyTV — приложение для Android TV

Для телевизоров и приставок выпускается отдельное приложение — StealtifyTV. Это не тот же APK, что для телефона, но маршрутизация в нём та же: правила для приложений работают как в мобильной версии.

StealtifyTV — бета. Поддержка Android TV в активной разработке: возможны нестабильная работа и изменения интерфейса между версиями.

Управление пультом (D-pad)

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

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

Как открыть настройки без сенсорного ввода

С главного экрана нажимайте «вверх» до верхней панели, доводите фокус стрелкой вправо до значка настроек и подтверждайте центральной кнопкой. Внутри настроек работают те же стрелки: вертикальное перемещение по пунктам, центральная кнопка — переключение.

DNS: утечки, шифрование и фильтрация

DNS — это разрешение имени сайта в адрес, и по нему видно, куда вы ходите, даже когда сам трафик закрыт. В клиенте это отдельный раздел настроек с четырьмя переключателями.

Технологии Stealtify

Stealtify — Android-клиент маршрутизации. Он подключается к вашим серверам и подпискам и раскладывает трафик по вашим правилам. Ниже — из чего состоит клиент и что именно он умеет подключать.

Свой сервер

Ещё один вариант — не пользоваться готовой подпиской, а поднять сервер самостоятельно. Схема одинакова для большинства протоколов из поддерживаемого списка:

1. Арендуйте VPS у любого VPS-провайдера — конкретный выбор не имеет значения для клиента.
2. Установите на сервере панель управления — например, 3x-ui, Marzban или Xray — и настройте нужный транспорт.
3. Сгенерируйте конфигурацию на своей стороне: панель выдаёт готовую ссылку или QR-код с параметрами сервера.
4. Импортируйте эту ссылку или QR-код в Stealtify тем же способом, что и любую другую конфигурацию.

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

Решение проблем

Установка

• APK не устанавливается. Разрешите установку из неизвестных источников, проверьте, что устройство на arm64-v8a и Android 10 или новее, и удалите версию с другой подписью, если она уже стоит.

Подключение

• Ничего не происходит при нажатии «Подключиться». Разрешите системный запрос на VPN, отключите другой активный VPN — Android допускает только одно VPN-соединение одновременно — и убедитесь, что добавлен хотя бы один сервер.
• «Все прокси недоступны». Проверьте серверы кнопкой Тест, сверьте хост, порт и учётные данные, ослабьте порог failover.
• Подключение установлено, но интернета нет. Откройте экран «Прокси (проверка)», переназначьте приложение на другую группу или временно поставьте его «без группы».

Маршрутизация

• Приложение всё равно идёт напрямую, а не через прокси. Трафик без правила по умолчанию идёт напрямую: назначьте приложению группу с рабочим прокси и проверьте, что группа включена и у неё есть прокси.
• Правило по домену не срабатывает. Матчинг идёт по TLS SNI — проверьте формат маски. DoH и захардкоженные IP-адреса обходят доменный матчинг: в этом случае маршрутизируйте приложение целиком, правилом по приложению.

Kill Switch

• DNS уходит мимо прокси. Включите защиту от утечек DNS в настройках. Трафик, для которого нет правила, идёт напрямую по замыслу — это не утечка в узком смысле.
• После разрыва VPN пропадает интернет целиком. Это штатная работа Kill Switch: переподключитесь или отключите его. На системном уровне похожий эффект даёт Always-on VPN с опцией «блокировать соединения без VPN».

Работа в фоне и автозапуск

• VPN отключается в фоне. Исключите приложение из оптимизации батареи и включите автопереподключение.
• Клиент не запускается автоматически при загрузке устройства. Включите автозапуск при загрузке в настройках приложения; на Xiaomi, Huawei, Oppo и Samsung дополнительно разрешите автозапуск в системных настройках и снимите агрессивное управление батареей для приложения.

Импорт, подписки и QR

• Подписка вернула 0 серверов. Проверьте, что URL — валидная точка подписки http(s):// с путём, что ссылка не истекла и что она достижима.
• QR-код не сканируется. Проверьте разрешение камеры и освещение. Коды больше 8 КБ и коды с неизвестной схемой ссылки отклоняются.

Отдельные протоколы

• VLESS, VMess или Trojan с TLS или REALITY не подключаются. Проверьте UUID, SNI, fingerprint, flow и транспорт, переключите «Использовать TLS», сверьте время на устройстве — рассинхронизация часов ломает TLS-рукопожатие.
• Shadowsocks подключается, но данных нет. Проверьте метод шифрования — он должен совпадать с тем, что задан на сервере.

Обновления и уведомления

• Обновление зацикливается. Проверьте доступность канала обновлений и при необходимости скачайте APK вручную. Обязательные обновления отложить нельзя — это сделано намеренно.
• В уведомлении не видно статистики трафика. Включите разрешение на уведомления для приложения.

Резервная копия

• После импорта бэкапа пропали серверы и правила. Так и задумано: импорт полностью заменяет текущую конфигурацию содержимым файла, а прежняя удаляется. Восстановить её можно только из своего экспорта, сделанного до импорта.