← К библиотеке
Клиенты Практика

Импорт подписки: ссылка, QR, обновление

Импорт подписки устроен почти одинаково во всех клиентах — если понять механику один раз, объяснишь её клиенту на любом приложении. Ниже — три способа завести подписку, как работает обновление и почему клиенту почти никогда не надо переустанавливать профиль. Свою ссылку-подписку подставь в конструктор сверху.

Что такое ссылка-подписка

Клиент получает от твоего бота одну ссылку вида https://sub.your-domain.com/xxxxxxxx. Это не отдельный сервер — это адрес, по которому лежит актуальный список всех твоих серверов для этого клиента. Приложение ходит по ней и забирает конфиги. Магия в том, что содержимое по ссылке ты меняешь на своей стороне (в панели), а у клиента при обновлении подтягивается новое — не трогая саму ссылку.

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

Способ 1: по ссылке из буфера

Самый частый. Работает во всех клиентах одинаково:

  1. Клиент копирует ссылку из бота (обычно бот даёт кнопку «Скопировать»).
  2. В приложении жмёт + (плюс) → Добавить из буфера (Add from clipboard). Приложение само подхватит ссылку из буфера.
  3. Профиль появляется со списком серверов.

Если кнопки «из буфера» нет — есть «Импорт по ссылке» / «Add from URL», туда ссылку вставляют вручную.

Способ 2: по QR-коду

Удобно, когда клиент открывает бота на компьютере, а ставит VPN на телефон — не пересылать же ссылку. Даёшь QR картинкой, клиент:

  1. В приложении жмёт + → Сканировать QR (Scan QR).
  2. Наводит камеру на код.
  3. Профиль добавляется автоматически.

QR — это та же ссылка-подписка, просто закодированная в картинку. Многие боты умеют отдавать её кнопкой «Показать QR» — стоит включить, снимает вопросы «как перенести на телефон».

Способ 3: файлом конфига (десктоп)

На десктопных клиентах (Hiddify, NekoBox) можно перетащить файл конфига в окно приложения или импортировать через меню. Способ нишевый — для большинства проще ссылка. Пригождается, когда конфиг раздают не через подписочный сервис, а файлом.

Обновление подписки — ключевая механика

Это то, что стоит объяснить клиенту сразу, потому что снимает панику при первой аварии.

Когда ты на своей стороне что-то поменял (сменил сгоревший IP, добавил ноду, поправил правила) — клиенту не надо удалять и заводить профиль заново. Достаточно:

  • В приложении открыть профиль → «Обновить подписку» (Update subscription / потянуть вниз для обновления).
  • Свежий список серверов подтянется по той же ссылке.

Многие клиенты (Happ, Hiddify) обновляют подписку сами по расписанию — тогда клиент вообще ничего не делает, свежее приезжает автоматически. Проверь, что в шаблоне подписки задан разумный интервал автообновления, — это экономит тебе тикеты «сервер лёг» после каждой ротации IP.

Когда всё-таки переустановить профиль

Редко, но бывает: если ты сменил формат подписки (например, перешёл на json-подписку) или клиент словил рассинхрон, обычное «Обновить» может не пересобрать всё. Тогда — удалить профиль и добавить по ссылке заново. Это пересобирает конфиг с нуля, включая маршрутизацию. На практике нужно нечасто, но в чек-лист поддержки положи как последний шаг.

Короткий скрипт для поддержки

Отдай клиенту эту последовательность — она закрывает 90% проблем импорта:

  1. Скопировать ссылку из бота.
  2. В приложении: + → добавить из буфера (или по ссылке / QR).
  3. Не появились серверы — нажать «Обновить подписку».
  4. Всё равно пусто — удалить профиль, добавить по ссылке заново.
  5. Не помогло — в поддержку: какое приложение, что именно на экране.

Механику каждого клиента по отдельности разбираем в статьях по Happ, Hiddify, v2rayTun и Streisand. А как сделать так, чтобы клиент в списке видел человеческие подписи, а не VLESS | TCP | REALITY, — в статье «Server Description: подсказки клиенту в Happ/INCY».

Следующий гайд Server Description: подсказки клиенту в Happ/INCY → Не понравилась статья или что-то непонятно? Напишите мне — помогу или поправлю. @notrealvpn →
Материал носит образовательный характер и посвящён инженерии сетевой инфраструктуры. Вы отвечаете за соблюдение законов своей юрисдикции.