> For the complete documentation index, see [llms.txt](https://docs.imsel.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imsel.dev/tekhnicheskaya-dokumentaciya/subscription-sharing.md). # Offline-раздача подписок Раздавайте добавленную подписку другим устройствам **без сервера**: вся раздача упаковывается в самодостаточную ссылку или файл. Работает одинаково на Android и iOS. > ℹ️ **Примечание** Раздача полностью offline: конфиги не проходят через облачное хранилище и сторонние сервисы. Всё шифрование и все проверки выполняются на устройствах отправителя и получателя. *** ## Обзор Функция решает задачу «передать подписку другому человеку с ограничениями»: | Возможность | Описание | | ---------------------- | ------------------------------------------------------------------------------------------------------------ | | Формат раздачи | Ссылка `imsel://sub/...`, QR-код или файл `.imsel` | | Содержимое | Снапшот серверов (share-ссылки `vless://`/`vmess://`/... **или** Xray-JSON конфиги) либо URL подписки панели | | Шифрование | AES-256-GCM (зашифрованная раздача) или без шифрования (открытая) | | Привязка | По HWID устройства, «первое устройство» или без привязки | | Таймер | Срок с момента активации (1/3/7/30 дней) и/или абсолютный дедлайн | | PIN | Код активации: без PIN ссылка криптостойко не расшифровывается | | Ограничения получателя | Запрет активации на руте, блок настроек, скрытие конфигов, запрет повторной раздачи | | Защита файла | Пароль файла: AES-256-GCM + PBKDF2-HMAC-SHA256 (100 000 итераций) | *** ## Создание раздачи Окно «Подписки» → карточка подписки → **«Поделиться»**. ### Что передать * **Серверы (снапшот)** — конфиги зашиты внутрь раздачи; получатель не видит URL панели и не может вынести конфиги в другой клиент по ссылке. Поддерживаются и share-ссылки, и JSON-конфиги (каждый парсится отдельно). * **Ссылка** — URL панели внутри раздачи; получатель сможет обновлять подписку напрямую с панели. ### Защита * **Шифрование AES-256** — полезная нагрузка шифруется AES-256-GCM; заголовок (привязка/таймер) защищён от подмены привязкой аутентификационных данных (AAD). * **Привязка**: * *Без привязки* — работает на любом устройстве; * *1-е устройство* — закрепляется за первым активировавшим устройством; * *По HWID* — ключ раздачи обёрнут ключом, выведенным из HWID получателя функцией растяжения: на чужом устройстве раздача **не расшифровывается вовсе**. HWID получатель копирует кнопкой в боковом меню приложения. * **PIN активации** — при включении генерируется случайный PIN (можно перегенерировать кнопкой-спиннером; поле открыто — цифры нужно сообщить получателю). Ключ payload дополнительно оборачивается ключом, выведенным из PIN (PBKDF2 с растяжением — офлайн-перебор по ссылке вычислительно дорог). Работает только в зашифрованном режиме. ### Срок действия * **С активации** — 1 / 3 / 7 / 30 дней с момента, когда получатель активировал раздачу (ссылка не «сгорает» до активации); * **Дедлайн** — абсолютная дата («до 31.12»). Если заданы оба — действует то, что наступит раньше. ### Ограничения получателя | Параметр | Эффект у получателя | | --------------- | --------------------------------------------------------------------------------------------------------------------- | | Запрет на рут | Активация отклоняется на рутованных/jailbreak устройствах (эвристическая проверка) | | Блок настроек | Настройки подписки только для чтения; сетевой фильтр и блокировка не переключаются; авторская блокировка не снимается | | Скрыть конфиги | Скрываются кнопки QR и просмотра конфигурации на карточках серверов (остаётся только пинг), URL панели маскируется | | Запрет re-share | Включён всегда: получатель не может передать подписку дальше (кнопка «Поделиться» неактивна) | ### Результат После нажатия «Создать раздачу»: * **QR-код** — для раздач до \~2,5 КБ; * **Ссылка** — текст с копированием в буфер (для больших раздач показывается начало — копирование и файл используют полную ссылку); * **В файл** — сохранение через системный диалог проводника в файл `.imsel`; можно задать пароль файла. *** ## Файл раздачи `.imsel` Бинарный контейнер с бинарной магией-подписью формата и флагами. Внутри — ссылка раздачи: * **Без пароля** — контейнер без шифрования; * **С паролем** — содержимое шифруется AES-256-GCM, ключ выводится из пароля функцией растяжения (PBKDF2-HMAC-SHA256) со случайной солью. Подмена заголовка или содержимого ломает тег аутентификации — файл нельзя «пересобрать» незаметно. ### Открытие файла * **Android** — тап по файлу в проводнике → «Открыть в IMSEL» (зарегистрированы intent-фильтры для расширения `.imsel`: content/file URI, октет-стрим); * **iOS** — тап в «Файлах» → открытие в IMSEL (зарегистрирован тип документа `com.imsel.vpn.share`); * **Внутри приложения** — меню «+» → «Импорт из файла». Если файл защищён паролем — откроется диалог ввода пароля. *** ## Активация у получателя Входы: открытие ссылки `imsel://sub/...` (мессенджер/браузер), сканирование QR, вставка из буфера обмена, файл (см. выше). Порядок: 1. Диалог подтверждения «Активировать»; 2. Если задан PIN — диалог ввода PIN (без верного PIN расшифровка невозможна); 3. Проверки: срок, привязка (HWID/первое устройство), запрет рута; 4. Создаётся локальная подписка (снапшот — с серверами внутри; ссылка — с последующим обновлением с панели) с ограничениями автора. Результаты, которые может увидеть получатель: активирована / обновлена / срок истёк / закреплена за другим устройством / неверный HWID / неверный PIN / активация на руте запрещена / данные повреждены. ### Ограничители после активации * Подключение к серверам истёкшей раздачи блокируется (включая «Переподключиться»); * Истёкшие раздачи пропускаются автообновлением; * Карточка подписки показывает бейдж: запас срока («7 дн.», «5 ч.») или красная «истекла». ### Идемпотентность Повторная активация той же ссылки на том же устройстве обновляет серверы, не создавая дубль и **не продлевая** срок. На другом устройстве ссылка с привязкой отклоняется. *** ## Технические детали ### Ссылки | Формат | Назначение | | -------------------------------------- | ----------------------------------- | | `imsel://sub/e1/` | Зашифрованная раздача (AES-256-GCM) | | `imsel://sub/p1/` | Открытая раздача (без шифрования) | ### Криптография (общее описание) * Полезная нагрузка шифруется AES-256-GCM со случайным 256-битным ключом; метаданные ограничений защищены от подмены привязкой аутентификационных данных (AAD). * Обёртки ключа (по HWID и по PIN) выводятся функциями растяжения ключа на основе PBKDF2-HMAC-SHA256 с рандомизированной солью; текущая версия формата (KDF v2) использует усиленные параметры, старые раздачи (KDF v1) остаются совместимыми. * PIN-обёртка делает офлайн-перебор PIN по ссылке вычислительно дорогим; тем не менее рекомендуется использовать длинные PIN и не передавать ссылку по открытым каналам. * Файл `.imsel` с паролем шифруется тем же стеком (AES-256-GCM + PBKDF2); подмена заголовка или содержимого ломает тег аутентификации. ### Защита на устройстве получателя * Реестр активаций хранится в зашифрованном виде и подписывается ключом, привязанным к установке приложения, — подмена записей детектируется; * Предусмотрена защита от отката системных часов назад (перевод времени не продлевает срок раздачи). > ℹ️ **Примечание** Точные параметры ключевых функций, структура контейнеров и внутренние механизмы проверок в публичной документации не раскрываются (принцип Керкгоффса: стойкость не зависит от секретности формата, но и лишних подсказок публика не получает). ### Честные ограничения offline-модели * Привязка по HWID и PIN криптостойки к передаче ссылки/файла другим лицам; однако владелец рутованного устройства-получателя может снять расшифрованные конфиги из памяти (без сервера это неотразимо); * Открытый формат `p1` и режим «первое устройство» защищены только клиентскими проверками — патчированный клиент их обходит; * Ссылка в режимах без привязки — bearer-секрет: кто первым активировал, тот и владеет; * Отозвать offline-раздачу после отправки нельзя — только выпустить новую; * Clear Data у получателя неотличим от первого запуска. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.imsel.dev/tekhnicheskaya-dokumentaciya/subscription-sharing.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.