QR-код — один из самых удобных способов добавить конфигурацию в V2RayTun. Вместо ручного копирования длинной строки приложение считывает закодированные данные камерой и создаёт профиль подключения.

Внутри QR-кода может находиться:

  • отдельный ключ подключения;
  • ссылка подписки с несколькими профилями;
  • специальная ссылка для импорта;
  • иной текст, который V2RayTun не поддерживает.

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

Перед сканированием

Подготовьте QR-код так, чтобы его можно было показать камере iPhone, iPad или Android-устройства.

Лучшие варианты:

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

Не публикуйте QR-код в открытом доступе. Он может содержать персональную ссылку подписки, UUID, пароль или другие данные, позволяющие использовать ваше подключение.

Пошаговый импорт QR-кода

Шаг 1. Откройте V2RayTun

Запустите приложение и перейдите на основной экран со списком конфигураций.

Шаг 2. Откройте меню добавления

Нажмите кнопку добавления, которая обычно обозначена значком +. Расположение и оформление могут меняться между версиями приложения.

Шаг 3. Выберите сканирование

Выберите пункт сканирования QR-кода. Название может отличаться в зависимости от версии и языка интерфейса.

Шаг 4. Разрешите доступ к камере

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

Если ранее вы отказали в доступе:

  • на iPhone или iPad откройте Настройки → Конфиденциальность и безопасность → Камера и разрешите доступ для V2RayTun;
  • на Android откройте сведения о приложении, затем раздел разрешений и включите камеру.

Названия системных пунктов могут отличаться в зависимости от версии операционной системы.

Шаг 5. Наведите камеру на код

Расположите QR-код полностью внутри области сканирования. Не приближайте камеру слишком близко: вокруг кода должна оставаться светлая рамка.

Для лучшего распознавания:

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

Шаг 6. Проверьте результат

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

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

Как подключиться после импорта

  1. Раскройте список конфигураций.
  2. Выберите импортированный профиль.
  3. Нажмите основную кнопку подключения.
  4. При первом подключении разрешите iOS добавить VPN-конфигурацию и подтвердите действие кодом устройства или биометрией.
  5. Проверьте статус внутри приложения и загрузку сайтов.

Системный запрос iOS является нормальной частью первого запуска сетевого туннеля. Подробнее: Почему V2RayTun запрашивает системное разрешение на подключение.

Что делать, если QR-код находится на том же iPhone

Камера не может одновременно сканировать код, который отображается на экране того же устройства. Официальное описание V2RayTun подтверждает сканирование QR-кода, но не гарантирует импорт изображения непосредственно из приложения «Фото» во всех версиях.

Используйте один из надёжных вариантов:

  1. Откройте QR-код на компьютере или втором телефоне и отсканируйте его.
  2. Попросите поставщика прислать ссылку или ключ текстом.
  3. Если рядом с QR-кодом есть кнопка «Копировать ссылку», скопируйте её и используйте импорт из буфера обмена.
  4. Если поставщик даёт кнопку открытия в V2RayTun, используйте deep link.

Не загружайте секретный QR-код на случайные сайты-распознаватели. Такой сайт получит все данные, содержащиеся в коде.

Почему V2RayTun не импортирует QR-код

Камера не распознаёт изображение

Проверьте качество:

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

V2RayTun считывает код, но профиль не появляется

Вероятные причины:

  • внутри находится неподдерживаемый текст;
  • ключ повреждён;
  • QR-код относится к другому приложению или формату;
  • ссылка подписки недоступна из текущей сети;
  • сервер подписки вернул ошибку или пустой ответ;
  • конфигурация использует параметры, которые текущая версия клиента не понимает.

Попросите поставщика прислать исходный текст. По началу строки часто можно понять тип данных:

https://…
vless://…
vmess://…
trojan://…
ss://…

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

Появляется сообщение о запрете камеры

Откройте системные разрешения и включите камеру для V2RayTun. На рабочем или учебном устройстве доступ может быть запрещён политикой администратора.

Код раньше работал, а теперь нет

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

Добавился не один, а много профилей

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

Создался дубликат

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

QR-код или ссылка: что лучше

QR-код удобен для первого переноса данных между устройствами. Ссылка удобнее для хранения и повторного добавления, но её нельзя оставлять в открытом виде.

Для подписки предпочтительно сохранить исходный URL в защищённом хранилище. Тогда при смене телефона или случайном удалении профиля не придётся искать старое изображение.

Сравнение всех вариантов импорта приведено в статье Все способы добавить конфигурацию в V2RayTun: ссылка, буфер обмена, deep link и ключ.

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

  • Считайте QR-код паролем к подключению.
  • Не отправляйте его в общий чат поддержки.
  • Не используйте онлайн-декодеры для секретных кодов.
  • Проверяйте источник QR-кода перед импортом.
  • Не соглашайтесь устанавливать неизвестный MDM-профиль ради сканирования или подключения.
  • После компрометации кода запросите у поставщика новую конфигурацию.

Частые вопросы

Можно ли импортировать QR-код без камеры?

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

QR-код обязательно содержит один сервер?

Нет. Он может содержать одиночный ключ или URL подписки, возвращающий несколько профилей.

Почему после сканирования iPhone просит разрешить VPN-конфигурацию?

QR-код только добавляет параметры. Для фактического направления трафика через системный туннель iOS отдельно запрашивает разрешение пользователя.

Нужно ли хранить QR-код после импорта?

Желательно сохранить исходную конфигурацию в защищённом месте. Не полагайтесь только на сохранённый профиль внутри приложения.

Итог

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

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