CodeToolProCodeToolPro
GitHub

WiFi QR Code Generator

技术详情

Wi-Fi 二维码生成器的工作原理

工具功能

Wi-Fi 二维码生成器将 Wi-Fi 连接信息编码为标准格式的二维码。输入 Wi-Fi 的 SSID(网络名称)、加密类型(WPA/WPA2/WEP/nopass)和密码后,工具生成 WIFI: 格式的 URI 字符串——这是一个非正式的业界标准,然后将其编码为 QR 码。智能手机(iOS 11+ 和 Android 10+)的相机和 QR 码扫描应用识别此格式后会自动弹出 Wi-Fi 连接提示。可保存 PNG 或 SVG 格式用于打印展示。


常见开发者使用场景

Wi-Fi 二维码在智能家居、商业场所和开发场景中实用。智能家居产品(如智能灯泡、IoT 传感器)配网时扫描 Wi-Fi 二维码自动填写网络信息。咖啡店、酒店、联合办公空间打印 Wi-Fi 二维码方便客人连接,避免手写 SSID 和密码的不便。开发智能设备 App 的配网流程(如 ESP32/ESP8266 配网)时,Wi-Fi 二维码是快速绑定方案。家庭中为来访朋友提供 Wi-Fi 连接方式也是生活场景。

配合 二维码生成器 了解更通用的 QR 码生成功能,或使用 密码生成器 创建安全的 Wi-Fi 密码。


Wi-Fi QR Code 格式规范

Wi-Fi 二维码使用的 URI 格式(非 IETF 标准,但已广为支持):

  • 基本格式:WIFI:S:<SSID>;T:<WPA|WEP|nopass>;P:<密码>;H:<true|false>;;
  • S(SSID):Wi-Fi 网络名称,支持中文需用双引号包裹。注意:SSID 区分大小写。
  • T(类型):WPA(适用于 WPA/WPA2/WPA3 混合模式)、WEP(不推荐使用)、nopass(开放网络)
  • P(密码):Wi-Fi 密码。对于开放网络(T:nopass),该字段留空。
  • H(隐藏网络):H:true 表示隐藏 SSID(不广播),默认为 false。隐藏网络的连接成功率较低,不推荐。

常见陷阱与注意事项

  • 特殊字符:SSID 或密码中包含 ;(分号)、,(逗号)、:(冒号)和 \(反斜杠)需要转义——这些字符在 URI 中有特殊含义。前置反斜杠转义:\,、\;、\:、\\。
  • 加密类型选择:T:WPA 是一个通用选项,同时覆盖 WPA/WPA2/WPA3 所有版本。不需要区分 WPA2 和 WPA3,iOS/Android 会自动协商。
  • 隐私注意:打印的 Wi-Fi QR 码包含明文密码,任何人扫描即可连接。公开场所建议使用 Captive Portal 而非直接共享密码。
  • 企业网络(WPA2-Enterprise):Wi-Fi QR 码标准不支持使用用户名+密码的企业认证——仅支持 PSK(预共享密钥)模式。

何时使用此工具而非代码

在为智能家居产品、商业空间或家庭 Wi-Fi 创建分享二维码时使用此工具。对于需要在 app 中动态生成 Wi-Fi 二维码的场景,使用各自的 QR 码库(如 Android 的 ZXing、iOS 的 CoreImage + CIQRCodeGenerator)。

How to Use WiFi QR Code Generator

  1. 1Configure your generation settings (length, format, options)
  2. 2Click the Generate button to create new output
  3. 3Review the generated result
  4. 4Copy the output to your clipboard or download it

Frequently Asked Questions

  • Can I use the generated output in production?

    Yes, all generated values are cryptographically random (where applicable) and ready for production use. No special attribution required.

  • Is WiFi QR Code Generator free?

    Yes, 100% free. No registration, no credit card required. All tools are freely available for developers worldwide.

  • Does this tool upload my data to any server?

    No. All processing runs locally in your browser using client-side JavaScript. Your input data, code, or files never leave your device. We do not store, log, or transmit any user data.