WiFi QR-format
WiFi QR-format — стандартная строка вида WIFI:T:WPA;S:MyNet;P:pass;; для автоматического подключения телефона к Wi-Fi сети после сканирования QR-кода.
Определение WiFi QR-format
WiFi QR-format — неофициальный, но де-факто стандартный способ закодировать параметры беспроводной сети в строку, понятную QR-сканерам смартфонов. Когда пользователь наводит камеру на такой QR-код, телефон предлагает подключиться к Wi-Fi одним касанием — без ручного ввода пароля. Отель напечатал QR-код на стойке ресепшен, кафе наклеило на стол, офис вывесил у входа — это всё WiFi QR-format в действии.
Формат не описан в официальном RFC и не закреплён за каким-либо стандартизирующим органом. Его создало Java/Android-сообщество вокруг библиотеки ZXing (Zebra Crossing) — опенсорсного декодера QR-кодов, который стал основой большинства мобильных сканеров с 2007 года. ZXing первым начал распознавать строки вида WIFI: и отправлять параметры в системное API подключения к сети. Остальные производители подхватили соглашение, и сегодня оно работает одинаково на iOS, Android и большинстве десктопных сканеров.
Структура строки WIFI:
Полный синтаксис WiFi QR-format выглядит так:
WIFI:T:<тип шифрования>;S:<SSID>;P:<пароль>;H:<hidden>;;
| Поле | Назначение | Допустимые значения | Обязательно |
|---|---|---|---|
| T | Тип шифрования | WPA, WEP, nopass | Да |
| S | SSID — имя сети | Любая строка UTF-8 | Да |
| P | Пароль | Любая строка | Нет (если nopass) |
| H | Скрытая сеть | true / false | Нет (по умолчанию false) |
Строка заканчивается двойной точкой с запятой ;; — это сигнал конца записи. Пример реального WiFi QR для сети «CafeWifi» с паролем «coffee2025»:
WIFI:T:WPA;S:CafeWifi;P:coffee2025;;
Для скрытой сети (SSID не транслируется роутером) добавляется поле H:true:
WIFI:T:WPA;S:HiddenOffice;P:secretpass;H:true;;
При H:true Android самостоятельно включает опцию «Подключиться к скрытой сети», iOS — тоже обрабатывает корректно начиная с iOS 11.
Экранирование специальных символов
Если SSID или пароль содержат символы, которые сам формат использует как разделители, их нужно экранировать обратным слешем. Правило простое: символы \, ;, ,, : и " в значениях полей S и P записываются с префиксом \.
| Символ | Как записать | Пример в строке |
|---|---|---|
| \ | \\ | S:Net\\Work; |
| ; | \; | P:pass\;word; |
| , | \, | P:a\,b\,c; |
| : | \: | S:Net\:Name; |
| " | \" | P:\"secure\"; |
Сеть называется My;Home:Net, пароль p\ss"word? Строка будет: WIFI:T:WPA;S:My\;Home\:Net;P:p\\ss\"word;;. Генераторы вроде QRkoder делают экранирование автоматически — пользователь вводит пароль как есть.
Поддержка iOS, Android и Windows
Android получил нативную поддержку WiFi QR-format начиная с версии 10 (2019): камера распознаёт строку и предлагает подключение без дополнительных приложений. На Android 9 и ниже та же функция работала через QR-код в настройках Wi-Fi или сторонние сканеры. iOS поддерживает формат с iPhone и iPad на iOS 11 (2017) — системная камера показывает уведомление «Подключиться к Wi-Fi "…"» сразу при наведении. Windows не имеет встроенного сканера для WiFi QR, но большинство приложений-сканеров (например, QR Code Desktop Reader) умеют передавать параметры в системный Wi-Fi менеджер.
Связанные концепции
- QR-код — носитель для WiFi QR-format.
- vCard — другой inline-формат, кодирующий контактные данные.
- MECARD — компактный формат визитки, схожий по идее.
- Geo URI — ещё один inline-URI для передачи координат через QR.
Частые вопросы
Нужно ли обновлять QR-код при смене пароля Wi-Fi?
Да, статический WiFi QR-code жёстко кодирует пароль в строку — при смене пароля придётся генерировать и перепечатывать QR заново. Для гостиниц и кафе, где пароли меняются регулярно, удобнее использовать динамический QR-код с переадресацией: пользователь сканирует QR, попадает на страницу с текущим паролем или кнопкой подключения. Ещё лучше — гостевая сеть без пароля (T:nopass), тогда QR вообще не нужно обновлять.
Безопасно ли хранить пароль в QR-коде?
QR-код с паролем Wi-Fi читается любым сканером без авторизации. Если код наклеен в публичном месте, пароль фактически открыт для всех, кто его видит. Для домашних и корпоративных сетей это допустимо — гости и так получат пароль. Для сетей с доступом к внутренним ресурсам лучше создать отдельную гостевую VLAN с ограниченными правами и вынести её пароль в QR. WEP-шифрование уже считается взломанным — используйте только WPA2 или WPA3, иначе QR ничего не защищает.
Работает ли WiFi QR-format с WPA3?
Да, современные устройства корректно обрабатывают T:WPA при WPA3-сети — роутер и клиент договариваются о версии протокола автоматически через механизм WPA3 Transition Mode. Отдельного значения T:WPA3 в спецификации ZXing нет, и все известные реализации (iOS, Android, ZXing) используют T:WPA как универсальное обозначение для WPA/WPA2/WPA3. Если сеть работает в режиме Only WPA3 и клиент не поддерживает WPA3 — проблема в устройстве, не в QR-формате.
Как сгенерировать WiFi QR с логотипом?
Стандартный WiFi QR-format — это просто строка, которую можно закодировать в любой QR-код, включая стилизованный. На QRkoder выберите тип «Wi-Fi», введите SSID и пароль, затем перейдите в раздел дизайна: загрузите логотип в центр, выберите цвет модулей и фон. Логотип допустим при уровне коррекции ошибок H (30%) — он «закрывает» часть кода, которую Reed-Solomon восстанавливает. Рекомендуемый размер логотипа — не более 20% площади QR.
Почему камера iPhone не предлагает подключиться к Wi-Fi?
Возможные причины: iOS ниже 11 (обновите систему), функция «Сканирование QR-кодов» отключена в настройках камеры (Настройки → Камера → Сканировать QR-коды → включить), или строка WIFI: содержит синтаксическую ошибку — лишний пробел, неэкранированный спецсимвол, отсутствующее двойное ;; в конце. Проверьте строку вручную или пересоздайте QR через генератор. Также убедитесь, что сеть не в режиме «Самолёт» и Wi-Fi включён: iOS не предложит подключение, если Wi-Fi выключен системно.